# O Manual do &kscd;

Jonathan Singer

    jsinger@leeta.net

David White

    a9403784@unet.univie.ac.at

Bernd Johannes Wuebben

    wuebben@kde.org

Desenvolvimento
Dirk Forsterling

    milliByte@gmx.net

Desenvolvimento
Dirk Foersterling

    milliByte@gmx.net

Desenvolvimento
Lauri Watts

    lauri@kde.org

Revisão
Marcus Gama

    marcus_gama@uol.com.br

Tradução
2000 2004 J Singer
&FDLNotice;
2002-10-07
1.4

O &kscd; é um leitor de CDs pequeno, rápido e com suporte CDDB para as plataformas de &UNIX;.

KDE kdemultimedia kscd música CD áudio

## Introdução

O &kscd; é um leitor de &CD;s rápido, com suporte CDDB, para a plataforma &UNIX;. &kscd; significa The KDE Project's small/simple &CD; player (O Projeto do KDE para um Tocador de &CD; pequeno/simples).

Novo: o programa `workman2cddb.pl` em Perl fornecido para facilitar a transição para os usuários do 'workman'.

Eu espero que você goste deste tocador de &CD;s.

Bernd Johannes Wuebben

wuebben@kde.org

### Plataformas Suportadas

O &kscd; suporta explicitamente as seguintes plataformas:

- Linux

- FreeBSD

- NetBSD

- BSD386

- Sun

- &Solaris; (incluindo o suporte do cdda)

- &HP-UX;

- Irix da &SGI; (incluindo o suporte do cdda)

- Sony NEWS

- OSF/1

- Ultrix

e deverá conseguir ser compilado em muitas outras com poucas modificações.

## Fundamentos do tela

### Operação Básica

A Interface do &kscd;.
A Interface do &kscd;.

Esta é a janela principal do &kscd;. Você deverá ver algo do gênero quando inicia o &kscd;. Os controles desta janela são explanados abaixo, sem nenhuma ordem em particular.

#### O Painel de Controle

O Painel de Controle
O Painel de Controle

Este é o painel de controle principal do &kscd;. A função destes botões deverá ser familiar para todos os que já usaram um tocador de &CD;s alguma vez.

O botão superior no diagrama alterna entre a reprodução e a pausa do &CD;. O botão esquerdo da segunda linha interompe a reprodução do &CD;. O botão direito da segunda linha ejeta o &CD;. Os dois botões da terceira fila avançam (direita) ou recuam (esquerda) o &CD; para o início da faixa seguinte ou anterior. O botão esquerdo da linha inferior alterna o modo de reprodução aleatória entre ligado e desligado; o botão direito da mesma linha alterna a leitura em ciclo, de modo que o &CD; irá começar a tocar de novo do início quando chegar ao fim da última faixa de áudio.

#### O Mostrador de Estado

O Mostrador de Estado
o Mostrador de Estado

Este é o mostrador de estado. Começando de cima, da direita para a esquerda, está o mostrador de tempo principal (veja abaixo uma discussão sobre os diversos modos possíveis de apresentação do tempo), o estado da unidade de &CD-ROM;, o tempo total de reprodução do &CD; de áudio, a configuração atual do volume e o número atual e total da faixa (atual/total). As duas linhas inferiores mostram o artista e o título do &CD;, e depois o título da faixa, assumindo que existem registros apropriados no CDDB local ou da rede (Base de Dados de &CD;s.)

Clique no mostrador de tempo para alternar entre os possíveis modos de exibição do tempo principal. Por padrão, o &kscd; mostra o tempo decorrido na faixa atual, se o &CD; estiver em reprodução, ou então ––:–– ou 00:00 se o &CD; não estiver sendo tocado. Clicar no mostrador alterna, em sequência, para o tempo restante da faixa, o tempo total decorrido e o tempo total restante.

#### O botão de Configuração

O botão Extras
O botão Extras

Este botão abre um menu com um conjunto de opções. Você pode optar por abrir o painel de configuração do &kscd;. Isto permite-lhe configurar o &kscd; para funcionar na sua máquina de acordo com o seu gosto. Veja a seção configurando o &kscd; para mais detalhes sobre como configurar o &kscd;

O menu contém várias ferramentas para ajudá-lo a procurar por informações sobre o artista na Internet. Você poderá saber mais sobre as datas de espetáculos, informações de compras e outras informações clicando neste botão e escolhendo a opção apropriada no menu de contexto que aparece.

Este menu também permite abrir este documento de ajuda, relatar erros, aprender mais sobre o &kscd; e o &kde; e sair do &kscd;.

#### O botão do CDDB

O botão do CDDB
O botão do CDDB

Este botão abre o painel de edição dos registros do CDDB (Compact Disc Data Base - Base de Dados de Discos Compactos).

O CDDB pode dentificar o seu &CD; e obter uma lista das faixas para esse &CD; a partir da rede ou poderá carregar a partir do sistema de arquivos. Veja a seção do Editor da Base de Dados de &CD;s para mais detalhes sobre como usar esta ferramenta.

#### O botão Volume

O botão Volume
A barra de Volume

Este botão abre uma barra que controla o volume da saída de áudio do &CD;. Para a direita fica mais alto, enquanto que para a esquerda fica mais baixo. Se você estiver reproduzindo o seu &CD; através da sua placa de som, o mixador da placa de som irá afetar também o volume da reprodução.

#### O seletor de faixas

O seletor de faixas
O seletor de faixas

Esta caixa combinada mostra a faixa atual e permite-lhe selecionar diretamente a faixa a ser reproduzida.

## Configurando o &kscd;

### A janela de configuração principal

A janela de configuração principal do &kscd; é um diálogo com abas com três seções principais.

- Reprodutor de CDs

- Procura Freedb

- Envio Freedb

### A aba Reprodutor de CDs

A aba Reprodutor de CDs
A aba de Configuração do KSCD

Os campos Cor do LCD e Cor de Fundo mostram a cor selecionada para o texto e para o fundo do mostrador de estado. Clique nas barras de cores para alterar essas cores.

Mostrar ícone na bandeja do sistema faz com que um controle para o &kscd; apareça no painel do &kicker;.

Configura o Intervalo de salto para o número de segundos a serem avançados ou recuados quando os botões avançar ou recuar no Painel de Controle forem clicados.

O Executar automaticamente quando o CD for inserido faz com que o &CD; comece a tocar quando a bandeja do &CD; for fechada, sem ter que pressionar o botão Tocar.

Ejetar o CD ao terminar a reprodução faz com que o &CD; seja ejetado do leitor quando terminar a reprodução.

Parar a reprodução do CD ao sair faz com que a leitura do &CD; pare quando o &kscd; é fechado.

O campo Dispositivo de CD-ROM contém o nome do dispositivo de &CD-ROM; a ser usado para tocar os &CD;s de áudio. O valor padrão é `/dev/cdrom`. As permissões para este dispositivo deverão estar definidas para permitir o acesso a este dispositivo para leitura. A alteração das permissões neste dispositivo irão normalmente exigir privilégios de super-usuário e poderão ser feitas na linha de comando ou no Modo de Super-Usuário do &konqueror;.

O botão Ajuda abre a página do conteúdo da ajuda do &kscd;. O botão OK salva as opções atuais e sai; o Aplicar salva as opções atuais sem sair; o Cancelar sai sem salvar.

### A aba Procura freedb

A aba Procura freedb da janela de configuração
A aba Procura freedb da janela de configuração

A aba Procura freedb configura as funções do CDDB no &kscd;.

A opção Modo determina como as pesquisas do CDDB são feitas. Se escolher a opção Somente cache significa que só a informação que já existir no seu computador será usada. O Cache e remoto irá procurar a informação que você não tem ainda, enquanto que o Somente remoto vai procurar todos os discos na Internet. O tempo-limite para a pesquisa poderá também ser configurado.

A lista Servidor de CDDB: permite-lhe especificar o seu servidor freedb. Insira o endereço e o número da porta do servidor. Selecione um item desta lista, para que apareça no campo de texto abaixo. O forma de conexão (CDDB ou HTTP) poderão também ser definidos (É pouco provável que você queira alterar algum destes campos em relação aos valores padrão). O Pastas de Cache: permite-lhe escolher a pasta em que deseja salvar os registros do CDDB localmente.

### A aba Envio de freedb

A aba de Envio freedb

A aba de Envio do freedb configura a conexão a um servidor de e-mail para enviar os novos registros de CDDB. Isto é útil se você não tiver o seu próprio sistema configurado como um servidor. Assinale a opção Habilitar envios por SMTP para usar esta funcionalidade.

Você poderá optar por Usar os endereços de e-mail do Centro de Controle se desejar. Se você quiser abrir o módulo do &kcontrol; para configurar este endereço de e-mail, clique no campo Abrir o painel de controle do endereço de e-mail. A alteração do endereço aqui irá alterar o endereço padrão para todos os aplicativos do &kde; que usam esta opção, não só para o &kscd;, por isso faça isto com cuidado.

Caso contrário, selecione o seu perfil de e-mail preferido na opção Usar os seguintes endereços de e-mail. Insira o seu endereço de e-mail, um endereço de resposta, se desejar e o endereço do servidor de SMTP no campo Servidor: e o número da porta (normalmente a `25`) no campo Porta:.

O botão Ajuda abre a página do conteúdo da ajuda do &kscd;. O botão OK salva as opções atuais e sai; o Aplicar salva as opções atuais sem sair; o Cancelar sai sem salvar.

## O Editor da Base de Dados de CDs

O Editor da Base de Dados dos CDs
O Editor da Base de Dados dos CDs

O Editor de Bases de Dados de &CD;s permite-lhe modificar, baixar, salvar, anotar e enviar registros de CDDB (Compact Disc Data Base - Base de Dados de CDs).

Se existir um registro na sua árvore de CDDB local (veja a seção de CDDB no capítulo de Configuração) do &CD; na sua unidade de &CD-ROM;, ou se o disco foi encontrado no freedb, você irá ver o nome do artista e o título do &CD; nos campos Artista: e Título e uma lista com os títulos na área de seleção das Faixas. Caso contrário, você irá ver uma lista com as faixas e tempos de execução, mas sem títulos.

Você poderá fazer uma anotação do disco inteiro com o botão Comentário abaixo do campo Título ou para uma faixa selecionada na lista Faixas com o botão Comentário adjacente. Se você selecionar uma faixa na lista Faixas, o título, se estiver presente, irá aparecer no campo Título abaixo. Você poderá escrever um título para a faixa nesse campo ou editar o registro de acordo com as suas necessidades. Clique na tecla Return do seu teclado e o texto irá aparecer na linha adequada da caixa de seleção.

Logo que todas as faixas tenham títulos e os campos Artista: e Título tenham sido preenchidos, você poderá clicar no botão Enviar para submeter os resultados por e-mail para o freedb.

Será pedido para selecionar uma categoria para o envio. O ID do Disco mostra o código de 32 bits usado pelo freedb para identificar um disco compacto. Acima do código identificador está a categoria do registro do freedb. Estas categorias correspondem à árvore de sub-pastas da pasta escolhida na Pasta Base do freedb: na página do freedb da janela de Configuração do &kscd;.

O campo Duração Total: mostra o tempo total de reprodução do &CD;.

Clique no botão Obter Informação para obter os dados do CDDB. Clique no botão OK para salvar localmente as suas alterações. O botão Cancelar fecha o Editor de Bases de Dados do &CD; sem salvar.

## Usando o &kscd; no Painel do &kde;

Usando o &kscd; no Painel do &kde;
Usando o &kscd; no Painel do &kde;

Quando a opção Mostrar ícone na bandeja do sistema estiver assinalada, um pequeno mini-aplicativo do &kscd; é também mostrado no painel do KDE. Ao contrário da janela principal do &kscd;, este mini-aplicativo fica disponível em qualquer tela. Um clique com o &RMB; no mini-aplicativo fará surgir um menu para controlar a reprodução do &CD;. Clicar com o botão esquerdo no mini-aplicativo irá ocultar a janela principal do &kscd;. Se a janela principal estiver oculta, um segundo clique com o botão esquerdo no mini-aplicativo irá restaurá-la.

Para ser mais exato, o mini-aplicativo é mostrado na bandeja do sistema do painel. Se não aparecer nenhum mini-aplicativo quando o &kscd; é minimizado, você poderá ter removido a bandeja. Para adicioná-la, clique com o botão direito num espaço vazio do painel e selecione Adicionar Mini-aplicativo Bandeja do Sistema

## Suporte ao CDDB

O freedb é uma base de dados distribuída na rede que está acessível na Internet e que contém informações sobre a maioria dos &CD;s de áudio em circulação. Se você tiver acesso à Internet, você poderá nunca ter que introduzir manualmente as informações das faixas para os seus &CD;s se tiver isto configurado convenientemente. Veja a subseção da aba do freedb no capítulo de configuração do &kscd; para obter informações mais detalhadas sobre como configurar este serviço, e a seção do Editor de Bases de Dados de CDs para mais instruções sobre como editar os registros do CDDB.

O uso do CDDB é livre. São encorajados os envios por parte dos usuários.

Ao preparar os registros para o CDDB, tenha em mente os seguintes pontos:

- Use caracteres latinos padrão nos registros. Alguns caracteres especiais são suportados, mas submissões em Cirílico ou Grego, por exemplo, não poderão ser aceitas.

- Use só um caractere / no campo Artista do Disco / Título no Editor de Bases de Dados do &CD;.

  Para os &CD;s clássicos, é uma prática normal colocar o nome do compositor na seção do Artista (antes da barra) e o nome do cantor na seção Título (depois da barra).

- Se enviar um registro que já exista na base de dados, todas as informações adicionais que enviar poderão ser adicionadas ao registro existente.

Por padrão, o &kscd; instala as categorias-padrão do CDDB em `$KDEDIR/share/apps/kscd/cddb`. Você poderá criar tantas sub-pastas de categorias quantas desejar. Contudo, ao enviar, só as categorias oficiais do CDDB serão apresentadas. O endereço de envio padrão é o freedb-submit@freedb.org. Para mais informações sobre o freedb visite a página pessoal do freedb.

O registro de CDDB local para um determinado &CD; é armazenado no arquivo `nome da categoria/ID do disco` na Pasta de Base do CDDB. Estes arquivos poderão ser editados com qualquer editor de texto se não tiver nada de melhor para fazer com o seu tempo livre.

## Perguntas e respostas

Eu vejo este diálogo quando inicio o &kscd;. O que está errado?

Diálogo de erro
Diálogo de erro

Isto significa que o &kscd; não conseguiu acessar à sua unidade de &CD-ROM;. O nome do dispositivo no campo Dispositivo de &CD-ROM; na Configuração do Kscd deverá referir-se ao dispositivo de bloco associado com a sua unidade de &CD-ROM;. Isto poderá ser uma ligação (simbólica ou real) para o dispositivo IDE (`/dev/hdx`) ou SCSI (`/dev/sdx`) apropriado.

O arquivo do dispositivo normalmente pertence ao usuário 'root' no grupo 'root', e não permite aos usuários normais acessarem diretamente a ele para leitura, escrita ou execução. Isto não tem nada a ver com o comando SUID (Set User ID - que usam a função `setuid()` da biblioteca-padrão do Un*x para assumir a identidade de outro usuário) que é o `mount`, que não tem problema nenhum com as permissões; o &kscd; precisa de ser capaz de criar um descritor de arquivo para referir-se ao dispositivo de &CD; para controlar a unidade de &CD-ROM; e ler os dados brutos a partir do disco.

Se você tiver a senha do 'root', poderá corrigir isto rápida e facilmente. Mude para 'root' e digite ``chmod` `a+r` `/dev/cdrom`` para permitir a qualquer usuário no seu sistema ler do dispositivo `/dev/cdrom`. Se a sua unidade de &CD-ROM; for outra qualquer, mude as permissões nesse dispositivo com o mesmo procedimento. Se não tiver a senha de 'root', peça ao seu administrador de sistemas para lhe dar permissões de leitura ao seu dispositivo de &CD-ROM;.

Veja também o capítulo sobre a configuração do KSCD

Não consigo colocar o CDDB funcionando. É possível obter alguma informação detalhada sobre o que está ocorrendo de errado?

Se você estiver tendo problemas com a funcionalidade do CDDB tente iniciar o &kscd; a partir da linha de comando com a opção `-d` e veja o resultado da depuração.

## Créditos e licenças

Direitos Autorais &kscd; 1997,1998 Bernd Johannes Wuebben wuebben@kde.orgwuebben >

O &kscd; contém código de:

- workman 1.4 beta 3 Direitos Autorais (c) Steven Grimm koreth@hyperion.com

Muito obrigado ao Ti Kan e ao Steve Scherf, os inventores do conceito da base de dados do CDDB. Vá a http://www.cddb.com para obter mais informações sobre o CDDB.

Um especial agradecimento também a David White que fez a documentação original de ajuda do &kscd;. Belo trabalho, David!

Documentação atualizada para o KDE 2.0, com direitos autorais de Jonathan Singer jsinger@leeta.net.

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

&underFDL; &underGPL;

## Instalação

### Como obter o &kscd;

&install.intro.documentation;

### Requisitos

Para poder compilar com sucesso o &kscd;, você precisa das últimas versões das bibliotecas do KDE, assim como da biblioteca de C++ &Qt;. Todas as bibliotecas necessárias, assim como o próprio &kscd; poderão ser encontradas no servidor de &FTP; do &kde; em ftp://ftp.kde.org/pub/kde/.

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

&install.compile.documentation;

Por favor informe o responsável atual, Dirk Foersterling, em milliByte@gmlx.net sobre qualquer modificação que você tenha efetuado para fazer o &kscd; a compilar na sua plataforma.

&documentation.index;