# Manual do &noatun;

## Introdução

O &noatun; é um reprodutor multimídia completo baseado em plugins para o &kde;.

### Recursos

O &noatun; é uma elaborada interface visual para o &arts; — o Sintetizador Analógico em Tempo Real . Para acrescentar objetos de reprodução adicionais, vá para http://noatun.kde.org/plugins.phtml, ou a http://mpeglib.sf.net. Por padrão o &arts; suporta os formatos MP3 e MPEG-1. O formato Vorbis é também suportado se as bibliotecas do Vorbis tiverem sido disponibilizadas durante a compilação do &kde;.

## Usando o &noatun;

O &noatun;, por padrão é iniciado com um plugin de interface com o usuário denominado 'Excelente'. Este plugin foi escolhido pelo fato de ser similar a maioria dos outros aplicativos do &kde;.

O &noatun; é único por não existirem duas instalações iguais e por não ter um interface padronizada, apesar de existir uma padrão inicial. Você está livre para misturar e ajustar a sua seleção de plugins e personalizar o &noatun; até torná-lo seu reprodutor multimídia ideal!

### Formato do Título

A janela de preferências do &noatun; possui uma caixa de texto Formato do Título ímpar. Você poderá introduzir um string de formato para personalizar como o título aparece.

- Qualquer texto aparece normalmente, a não ser que esteja entre `$( )`.

- O texto entre `$( )` será lido pelo &noatun; de acordo com o item fornecido, que irá substituir o texto com seu valor.

- Se entre `$( )` existem aspas, esse texto será apresentado normalmente, mas somente se a propriedade desse nome existir.

- As aspas podem estar no início do `$( )`, no final, ou no início e fim simultaneamente.

Por exemplo, `$(bitrate)` é substituído pela taxa de bits do arquivo, como carregada pelo plugin Metatag. No entanto, se inserir aspas naquele campo, o texto entre aspas, será mostrado: por exemplo, `$(bitrate"kbps")` fornecerá a informação sobre a taxa de bits do arquivo, seguido pelos caracteres `"kbps"` . Isto não será mostrado no entanto se a propriedade bitrate não existir.

## Usando Plugins no &noatun;

Você poderá selecionar diferentes plugins indo ao menu Configurações, e selecionando Configurar o &noatun;.... Vá para a página Plugins selecionando o item adequado da lista. Então poderá ativar os plugins selecionando a caixa correspondente ao seu nome. O &noatun; requer pelo menos um plugin de interface com o usuário, e um plugin de lista de reprodução.

### Leite com Chocolate

Leite com Chocolate é uma interface com o usuário simples e pequena Os botões comportam-se como um tocador de CD, onde o botão de ejetar abre a lista de reprodução. O botão com uma folha com uma cruz remove o item atual da lista de reprodução, mas não apaga o arquivo do disco, e o botão de seta configura o modo de repetição. Um menu está disponível através do &RMB; clicando em qualquer parte da janela.

### Young Hickory

Young Hickory é um plugin para a Bandeja do Sistema do &kde;, a área junto ao relógio, por padrão.

Clicando no ícone com &RMB; é mostrado um pequeno menu, e ao clicar com o &LMB; será alternada a visibilidade da sua janela de interface com o usuário do &noatun;. Note que as listas de reprodução por exemplo, não são consideradas como interfaces do usuário.

### Exportar Lista de Reprodução em HTML

Este plugin colocará a lista de reprodução numa elegante tabela HTML. Sua página de preferências fornecerá a possibilidade de configurar cores, imagem de fundo, e habilitar o modo 'Pairar', para mudança de cores quando o cursor estiver sobre uma ligação.

Depois de configurar as opções, o menu Ações, Exportar Lista de Reprodução... abrirá um diálogo de arquivo para que selecione onde salvar o arquivo de saída.

### Estilos K-Jöfol

O carregador de estilos K-Jöfol do &noatun;, é uma re-implementação de um programa do &Windows; com o mesmo nome.

A implementação do &noatun; possui infelizmente algumas limitações. Por exemplo os estilos tem que ser previamente descomprimidos para o disco para que sejam carregados.

Para instalar um estilo (formato ZIP, no &Windows;) você poderá usar o carregador de estilos que se encontra na caixa de diálogo das preferências do &noatun;.

Devido a algums estilos não estarem corretamente empacotados e o instalador de estilos não adivinhar tudo, você poderá ainda seguir os seguintes comandos se uma determinada instalação de um estilo falhar:

    % cd $TDEHOME/share/apps/noatun
    % mkdir kjskins (se necessário)
    % cd kjskins
    % mkdir nova estilo ; cd novo estilo
    % unzip /caminho/para/novo_estilo.zip

Você pode também criar os seus próprios estilos com a ajuda do tutorial http://www.angelfire.com/mo/nequiem/tutorial.html.

### A Lista de Reprodução Dividida

A Lista de Reprodução Dividida possui um desenho simples e clássico. Um duplo clique em qualquer entrada da lista irá acioná-la (como se tivesse selecionado-o e pressionado Enter). Você poderá arrastar arquivos bem como &URL;s.

Como o &kde; 3.0, o Lista de Reprodução Dividida (SPL) armazena seus dados no formato &XML;, mas automaticamente importará a lista m3u se o arquivo &XML; não existir. Isto significa que você poderá modificar o arquivo m3u, e excluir o arquivo &XML; para automaticamente gerar listas de reprodução.

O nome Lista de Reprodução Dividida é um pouco enganador, na medida em que a lista não está realmente dividida. Este nome resulta do seu desenho original (remontando aos primeiros dias do &noatun;) onde estava realmente dividida.

### Estilos do Winamp

Se você estiver atualmente usando o estilo Winamp, por certo já deverá ter reparado que ele é familiar. Clicar no temporizador alternará entre o modo de contagem crescente ou decrescente. Selecionar a região de Escopo sob ele habilitará e desabilitará o escopo. Você poderá também fazer um duplo clique na barra de título para alternar o modo de sombra da Janela. Clicar com o botão direito (ou clicando no ícone superior esquerdo) mostrará a barra de ferramentas padrão do &noatun;.

Você poderá instalar novos estilos em `$TDEHOME/share/apps/noatun/skins/winamp`, criando uma pasta para eles, e então extraindo-os para esta pasta. Os arquivos de estilo Winamp com a extensão `.wsz` podem ser tratados como arquivos zip normais. Você poderá no entanto ter que renomeá-los antes que possa descomprimí-los.

### Metatag

Metatag é um plugin que carrega informações sobre um arquivo através do KFile, o mesmo mecanismo que é usado no &konqueror; para as dicas exibidas quando o mouse paira por cima de um arquivo qualquer. Além de carregar informações, ele também suporta edição através do menu Ações no subitem Edição de Tag. Ele suporta edição de tags ID3, bem como de tags OggVorbis. Ele lê também a taxa de bits dos arquivos.

### Keyz

Carsten Pfeiffer decidiu quebrar a longa tradição do &noatun; de criação de nomear um plugin da maneira mais imprecisa possível, como ficou provado tanto pelos plugins Leite com Chocolate, Young Hickory, e muitos outros. Qual a vantagem de trocar um S por um Z? Sons que pessoas que falam o Inglês-Americano não distinguem!

Contudo, apenas pelo fato do nome não ser original não significa que é um plugin inferior. Pelo contrário, ele permite a atribuição de teclas de atalho para algumas ações do &noatun;. A verdadeira beleza nestas teclas de atalho, é que funcionam em qualquer situação, e não apenas dentro do &noatun;. Assim isto pode finalmente fazer valer a pena os Teclados Multimídia.

### Controle por Infravermelho

Se você tiver um controle por Infravermelho no seu computador (como os da televisão com sintonizadores Brooktree), e o seu controle for suportado pelo LIRC, então isto deverá funcionar. Tal como Keyz, o nome é muito objetivo, mas o plugin permite-lhe atribuir ações a cliques de botões.

Para atribuir ações ao pressionamento de uma tecla, carregue o plugin, vá á página de Controle do Infravermelho na janela de configuração do &noatun;. Selecione a tecla na lista, e escolha a ação a ser executada na caixa combinada abaixo. Se numa ação como por exemplo o controle de volume, quiser executar a ação repetidamente, ative a caixa e selecione o intervalo entre ações.

Se você tiver uma placa de TV, um truque conveniente é atribuir o botão Mute à ação Pausa, permitindo assim tirar o som do aplicativo de TV, enquanto pausa o &noatun;, e vice-versa, particularmente utíl no caso dos comerciais.

## Perguntas, Respostas e Dicas

## Perguntas mais frequentes

A música pula muito quando se movimenta janelas.

Você pode ter aumentar o buffer do &arts; do seguinte modo:

- Inicie o &kcontrol;

- Vá para o grupo Som

- Vá para a seção Servidor de Som

- Aumente o tempo de resposta —, 384ms é normalmente suficiente para a maioria dos computadores.

Você poderá também considerar executar o servidor de som com prioridade de tempo real se o tempo de resposta não ajudar. Fique atento pois isto pode provocar um bloqueio no sistema.

Eu não consigo remover a lista de reprodução ou a interface de usuário da lista de plugins.

Uma vez que o &noatun; necessita de pelo menos uma interface com o usuário carregada e uma lista de reprodução, você terá que adicionar um plugin de interface antes de remover o antigo. Adicionar uma nova lista de reprodução removerá automaticamente a antiga.

Onde posso obter mais plugins?

Os programadores de programas de terceiros podem submeter os seus plugins no sítio web do &noatun;, local onde podem ser baixados por você, usuário.

Como posso escrever um plugin para o &noatun;?

A documentação, uma referência da API, e exemplo de código fonte estão disponíveis no sítio web do &noatun;. Do mesmo modo, e no espírito do software de código aberto o código fonte do &noatun; e todos os plugins padrão estão disponíveis.

## Créditos e Licenças

Direitos autorais do programa 2000-2002 Charles Samuels charles@kde.org

Direitos autorais da documentação 2002 Charles Samuels charles@kde.org

O &noatun; foi trazido até você pelas seguintes pessoas:

- Charles Samuels charles@kde.org

- Neil Stevens multivac@fcmail.com

- Stefan Westerfeld stefan@space.twc.de

- Martin Vogt mvogt@rhrk.uni-kl.de

- Malte Starostik malte.starostik@t-online.de

- Nikolas Zimmermann wildfox@kde.org

- Stefan Schimanski 1Stein@gmx.de

Tradução de Marcus Gamamarcus_gama@uol.com.br

&underFDL; &underBSDLicense;

## Instalação

### Como obter o &noatun;

&install.intro.documentation;

### Requisitos

O &noatun; requer no mínimo um Pentium 200 com &Linux;, um PowerPC com &Linux; 2.4.1 ou superior, ou outras plataformas. Suporte para mais plataformas será disponibilizado em breve.

Para que uma plataforma seja facilmente suportada, terá que ter suporte 'pthread', e o sistema de saída de som OSS, no entanto o sistema ALSA é suportado no &Linux;.

### Compilação e Instalação

&install.compile.documentation;

Se você deparar-se com algum problema, por favor reporte ao autor em charles@kde.org.

Se você possui esta documentação, provavelmente já terá compilado o &noatun;

## Glossário

Leite com Chocolate

Leite com Chocolate é um plugin de interface de usuário simples e minimalista

&arts;

&arts; é um sintetizador analógico em tempo real. Uma estrutura de mídia poderosa utilizada pelo &noatun;

K-Jöfol

Este plugin carrega estilos originalmente usadas num reprodutor de mídia do &Windows; de mesmo nome.

Keyz

Keyz permite-lhe atribuir teclas a ações no &noatun;

Young Hickory

Young Hickory é um plugin da barra de sistema.

Noatun

Kaiman é um plugin que carrega estilos do reprodutor de mídia GQMPEG. Kaiman é um antecessor do &noatun;, foi distribuído com o &kde; para o &kde; 2.0. Quando o &noatun; foi introduzido no &kde; 2.1, o carregador de estilos Kaiman tornou-se um plugin do &noatun;.

&documentation.index;