]>

# Manual do Kscd

Bernd Johannes
Wuebben

    wuebben@kde.org

David
White

    a9403784@unet.univie.ac.at<

14/09/1998
0.08.00

Este manual descreve o Kscd versão 0.8.

KDE
KSCD
CD player

## Introdução

O Kscd é um reprodutor de CD para a plataforma Unix. É rápido e capaz de consultar o banco de dados CDDB.

Novo: Script em Perl - workman2cddb.pl - para facilitar a transição dos usuários do Workman.

Espero que você goste deste CD-player,

`Bernd Johannes Wuebben`

wuebben@kde.org

## Instalação

### Como obter o Kscd

O Kscd é parte do pacote KDEMultimedia, disponível no site do projeto KDE http://www.kde.org.

### Pré-requisitos

Para compilar o Kscd, você precisa ter as últimas versões das bibliotecas do KDE, bem como a biblioteca Qt. Todas as bibliotecas necessárias bem como o Kscd em si podem se encontrados em ftp://ftp.kde.org/pub/kde/.

O Kscd suporta explicitamente as seguintes plataformas:

- Linux

- FreeBSD

- NetBSD

- BSD386

- Sun

- Solaris (inclusive suporte a CDDA)

- HPUX

- SGI Irix (inclusive suporte a CDDA)

- Sony NEWS

- OSF/1

- Ultrix

e deve compilar em muitos outros com poucas modificações.

### Compilação e instalação

Para compilar e instalar o Kscd em seu sistema, digite os seguintes comandos no diretório-base da distribuição do Kscd:

    % ./configure
    % make
    % make install

Queira informar sobre qualquer modificação que você teve de fazer para que o Kscd pudesse compilar e funcionar em sua plataforma.

## Fundamentos

### Janela principal

Você deve ver algo assim quando iniciar o Kscd. Os controles dessa janela serão explanados abaixo.

#### Painel de controle principal

A função destes botões devem ser familiares a qualquer um que já usou um CD player. O botão mais acima do diagrama comuta entre reprodução e pausa do CD. O botão esquerdo da segunda linha pára a reprodução do CD. O botão direito da segunda linha comuta o looping, de modo que o CD recomece ou não a tocar desde o início quando o fim da última faixa for atingido. Os botões da terceira linha movem a reprodução para trás (esquerdo) ou para frente (direito) em 30 segundos. Os botões da quarta linha pulam uma faixa para frente (direito) ou para trás (esquerdo).

N do T: o botão de retrocesso de uma faixa (botão esquerdo da quarta linha) funciona diferente do botão análogo na maioria dos aparelhos de CD reais. Normalmente esse botão, ao primeiro toque, voltaria ao início da faixa em execução; mas no Kscd, bem como no Workman e outros CD-players Unix que conheço, esse botão volta ao início da faixa anterior. Isso não é um defeito; acredito que seja uma característica do driver de CD-ROM do Unix, ou ao menos do Linux.

#### Botão Ejetar

Note que o botão de ejeção 'real' da unidade de CD-ROM não vai funcionar se um CD de áudio estiver no drive e o Kscd estiver ativado. Isso porque o Unix bloqueia o CD na unidade enquanto ela estiver em uso. Portanto, você deve usar o botão Ejetar do Kscd, ou então fechar o Kscd primeiro.

Alguns CD-ROMs antigos não suportam ejeção por software. Você também terá de fechar manualmente a unidade de CD-ROM ao inserir um novo disco.

#### Display de status

Iniciando no topo, da direita para a esquerda, está o display principal (veja mais abaixo uma descrição dos vários modos possíveis do display), o status do drive de CD-ROM, o tempo total de reprodução do CD corrente, o volume corrente, e os números de trilha corrente e máximo (curr./ max.). As linhas de texto mais ao fundo do display mostram o artista e o título do CD, e então o título da trilha, assumindo que existam registros para o CD no serviço CDDB local ou remoto. (CDDB = CD DataBase)

#### Botão de modo do display de tempo

Este botão comuta entre os modos possíveis do mostrador principal de tempo. Por padrão, o Kscd mostra o tempo de execução da trilha, se o CD estiver tocando, ou --:-- ou 00:00 se o CD não estiver sendo reproduzido. Pressionar este botão comuta em seqüência entre o tempo restante de trilha, tempo total de reprodução do CD, e tempo total por reproduzir.

#### Botão de configuração

Este botão abre o painel de configuração do Kscd. Ele permite configurar o Kscd de modo que funcione em sua máquina. Veja a seção "Configurando o Kscd" para maiores detalhes sobre a configuração do Kscd.

#### Botão do editor CDDB

Este botão abre o painel de edição de registros do CDDB (Compact Disc Data Base). O CDDB pode identificar seu CD e quase sempre fornecer uma lista de nomes de trilhas para aquele CD. Veja a seção "Editor de Banco de Dados de CDs" para detalhes sobre como usar essa ferramenta.

#### Botão de procura na Internet

Este botão lhe ajudará a procurar por informação sobre o artista na Internet. Você pode procurar por datas de execução, informação de compra e outras coisas pressionando esse botão e escolhendo a opção apropriada no menu de contexto que aparecer.

#### Botão Fechar

Este botão fecha o Kscd.

#### Controle de saída de áudio

Este controle deslizante horizontal, logo abaixo do display, permite ajustar o volume de áudio do CD. Se, na sua máquina, o sinal de áudio do CD trafega pela placa de som, o Mixer também afetará o volume de reprodução.

#### Caixa de seleção direta de trilha

Esta caixa de combinação permite selecionar diretamente uma trilha a reproduzir.

#### Botão de reprodução aleatória

Este botão executa as trilhas do CD em ordem aleatória.

### Configurando o kscd

A janela primária de configuração do Kscd tem três seções:

- CDDB

- Opções do Kscd

- Sobre...

### Configurando: A aba CDDB

A aba CDDB configura as funções do Compact Disc Data Base. A opção "Habilitar CDDB Remoto" liga ou desliga as consultas ao CDDB via Internet.

#### Diretório-base do CDDB

Esse campo de texto permite escolher o diretório onde os registros CDDB locais devem ser armazenados.

#### Mandar submissões CDDB para

Este campo contém os e-mails de submissão de registros CDDB. O endereço padrão é "xmcd-cddb@amb.org". A partir da versão 8.0, registros do kscd são aceitos para inclusão no banco de dados.

#### Servidor CDDB

Esta caixa de listagem mostra uma lista de servidores CDDB conhecidos. Selecione um item desta lista e ele aparecerá no campo de texto acima da caixa de seleção. Pressione o botão `Atualizar` para atualizar a lista de servidores na caixa de listagem. Pressione o botão `Padrões` para preencher a lista com o valor padrão `cddb.cddb.com 888`, que permite a você atualizar a lista com uma relação atualizada de servidores CDDB junto ao servidor-mestre `cddb.cddb.com`.

#### Ajuda

Este botão abre a página de ajuda do kscd.

### Configurando: a aba de opções do Kscd

#### Cores do LED e Cores de Fundo

Esses campos mostram a cor dos elementos e do fundo do display de status. Pressione o botão "Mudar" próximo à caixa de cor para mudar essas cores.

#### Dispositivo CDROM

Este campo contém o nome do dispositivo CDROM a ser usado para reproduzir CDs de áudio. O valor padrão é `/dev/cdrom`. As permissões deste dispositivo precisam permitir ao menos acesso somente-leitura a usuários comuns. Mudar as permissões desse arquivo de dispositivo vai requerer privilégios de superusuário (root) e pode ser feito a partir da linha de comando ou no "Modo superusuário" do Kfm.

#### Comando de mail do Unix

Este campo mostra o comando usado para mandar os novos registro CDDB ao banco de dados. O valor padrão é `mail -s "&percnt;s"`. Você precisará ter certeza de qua esse comando será capaz de mandar mensagens para sistemas remotos se você quiser submeter registros ao CDDB, especialmente se você acessa a Internet via conexão discada. Cheque a documentação de sua distribuição Linux para maiores detalhes. Algumas distribuições Linux que utilizam o sendmail para remeter e-mails requerem somente que você informe sua agência de correio no campo Smart relay host do arquivo /etc/sendmail.cf. Além disso, o site do CDDB vai precisar mandar mensagens a você; para permitir isso, talvez seja necessário fazer mais alterações no arquivo /etc/sendmail.cf para assegurar que o endereço de retorno das mensagens remetidas seja válido.

#### Navegador WWW

Esta seção permite escolher que navegador Web usar para acessar os sites nos menus de informação. Você pode escolher o kfm ou um navegador diferente com os botões de rádio. O padrão do campo "Usar Outro Navegador" é "netscape "&percnt;s"", para uso com o Netscape Navigator/Communicator.

#### Mostrar dicas

Essa opção liga/desliga as Dicas dos botões.

#### Ajuda

Este botão abre a página de ajuda on-line do Kscd.

### Configurando: a aba Sobre

A aba "Sobre..." mostra informações sobre a versão do Kscd que você está usando, bem como algumas mensagens de copyright.

### O Editor do banco de dados de CDs

O Editor de Banco de Dados de Cds permite modificar, obter, salvar, anotar e remeter registros CDDB (Compact Disc Data Base). Se existe um registro em seu disco rígido local (veja a subseção CDDB em "Configurando o Kscd") para o CD que está no drive, ou o disco foi encontrado no CDDB, você verá o nome do artista e o título do CD no campo "Artista / Título" e uma lista de faixas com os nomes das músicas na caixa de seleção "Trilha / Tempo / Título". Do contrário, você verá uma lista de trilhas e tempos sem os títulos.

#### Informação estendida

Você pode fazer uma anotação referente ao CD com o botão "Info Ext", próximo ao campo "Artista / Título" ou para uma trilha em especial, via o botão "Info Ext" adjacente à caixa de seleção das trilhas.

#### Editar título da trilha

Se você selecionar uma trilha na caixa de seleção, o título (se presente) aparecerá no campo "Editar Título da Trilha". Você pode digitar um título para a trilha no campo, ou editar o campo de acordo com suas necessidades. Pressione a tecla "Return" em seu teclado, e o texto aparecerá na linha apropriada da caixa de seleção.

#### Submeter

Uma vez que todas as trilhas tenham títulos e o campo "Artista / Título" esteja preenchido, você pode pressionar o botão "Submeter" para mandar seu registro via e-mail ao CDDB. Você será solicitado a informar uma categoria para o registro.

#### ID do disco

Esta seção mostra a identificação de 32 bits usada pelo CDDB para identificar um CD. Sobre o código de identificação está a categoria do registro CDDB. Estas categorias correspondem à árvore de subdiretórios do diretório escolhido em "diretório-base CDDB", na aba CDDB da janela de configuração.

#### Tempo total

Este display mostra o tempo total de reprodução do CD.

#### Editor de lista de reprodução

Permite mudar a ordem de reprodução do disco. Digite uma lista delimitada por vírgulas dos números de trilhas para definir uma nova ordem de reprodução.

#### Salvar

Este botão grava o registro. Será solicitada a categoria sob a qual o registro será salvo. Selecione um diretório e pressione Ok para finalizar a operação.

#### Carregar

Este botão lhe pedirá uma localização aonde procurar por registros CDDB que não seja um servidor CDDB remoto ou os registros CDDB locais no sistema de arquivos.

O botão "Fechar" fecha o Editor de Banco de Dados de CDs.

## Suporte a CDDB

O CDDB é um banco de dados de rede, distribuído, acessível pela Internet, que contém informações sobre a maioria dos CDs de áudio em circulação. Se você tem acesso a Internet, é provavel que você nunha tenha de preencher por si alguma informação de nome de CD ou nome de trilha, isso se o Kscd estiver configurado corretamente. Veja a subseção "A aba CDDB", na seção "Configuração do Kscd", para instruções detalhadas sobre como configurar esse serviço, e o "Editor de Banco de Dados de CDs" para ver instruções sobre como editar registros CDDB.

O uso do CDDB é gratuito. Encoraja-se os usuários a fazer submissões de novos registros.

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

- Utilize caracteres latinos padrões (ISO 8859-1) nos campos. Alguns caracteres especiais são suportados, mas não, por exemplo, caracteres cirílicos e gregos.

- Use somente um caractere de barra no campo "Artista / Título". Para CDs clássicos, é praxe colocar o nome do compositor no lugar do Artista (antes da barra) e o executante no lugar do Título (depois da barra).

- Se você mandar um registro que já existe no banco de dados, quaisquer informações adicionais que você forneceu podem ser acrescentadas ao registro preexistente.

Por padrão, o Kscd instala as categorias CDDB padrão em `$KDEDIR/share/apps/kscd/cddb`. Você pode criar quantos subdiretórios de categoria quiser. Porém, ao remeter registros ao CDDB, apenas as categorias oficiais são mostradas. O endereço padrão para remessa é "xmcd-cddb@amb.org". Para mais informações sobre o CDDB, visite o site do CDDB.

O registro CDDB local para um CD em particular está armazenado no arquivo `<nome categoria>/<ID do disco>`, sob o "Diretório-base do CDDB". Esses arquivos podem ser editados com qualquer editor de texto comum, se você não tem nada melhor para fazer em seu tempo livre.

## Perguntas e respostas

### Eu obtenho um aviso "Erro de leitura/gravação CDROM" quando inicio o Kscd. O que está errado ?

Significa que o Kscd não pôde acessar o drive de CD-ROM. O nome do dispositivo no campo Dispositivo CDROM da janela Configuração Kscd deve referir-se ao dispositivo de bloco associado ao drive de CD-ROM. Quase sempre será um hard-link ao dispositivo IDE (`/dev/hdx`) ou SCSI (`/dev/sdx`). O arquivo de dispositivo normalmente pertence ao usuário root e ao grupo root, e não permite que usuários normais abram o arquivo para leitura, gravação ou execução direta. Isso não tem *nada* a ver com o SUID (programas SUID usam a função setuid() do Unix para assumir a identidade de outro usuário) do comando `mount`, que não tem problemas com permissões; o Kscd tem de poder abrir um arquivo de somente-leitura que refere-se ao CD-ROM para controlá-lo e ler dados binários do CD.

Se você tem a senha de superusuário (root), poderá consertar esse problema rapida e facilmente. Entre em modo de superusuário e digite `chmod a+r /dev/cdrom` para permitir a qualquer usuário do sistema ler o dispositivo `/dev/cdrom`. Se seu dispositivo de CD-ROM tem outro nome, mude as permissões dele da mesma forma. Se você não tem a senha de superusuário, peça ao administrador do sistema com delicadeza que lhe dê acesso de leitura ao dispositivo de CD-ROM.

Veja também a seção "Configurando o Kscd".

### Eu não consigo fazer o CDDB funcionar. Posso obter informações detalhadas sobre o que está errado ?

Se você está tendo problemas com a funcionalidade CDDB, tente iniciar o kscd a partir da linha de comando com o parâmetro `-d`, e observe a saída de depuração.

## Epílogo

### Agradecimentos

Agradecimentos especiais a Ti Kan and Steve Scherf, os inventores do conceito do banco de dados CDDB. Visite www.cddb.com para maiores informações sobre o CDDB.

Também agradeço a Paul Harrison por ter escrito Synæsthesia, em que o Kscd Magic é baseado.

Um agradecimento muito especial também a David White que escreveu a documentação de ajuda do Kscd. Grande trabalho David !

### Desenvolvedores

`Bernd Johannes Wuebben - Autor e mantenedor`

### Autores

`Bernd Johannes Wuebben - Primeiro esboço`

`David White - Redator`

`Eric Bischoff - Editor`

`Elvis Pfützenreuter - Tradução para Português do Brasil`

### Copyright

    Kscd Copyright (c) 1997,1998  Bernd Johannes Wuebben wuebben@kde.org

    O kscd contém codigo do programa
    workman 1.4 beta 3 Copyright (c) Steven Grimm koreth@hyperion.com

    Este programa é software gratuito; você pode redistribuí-lo e/ou
    modificá-lo sob os  termos  da  GNU General Public License  como
    publicado  pela Free Software Foundation;  qualquer uma das duas
    versões de Licença, ou (em sua opinião) alguma versão anterior.

    Este  programa é distribuído com  a esperança de que seja  útil,
    mas SEM NENHUMA GARANTIA;  sem conformidade com implicações    e
    garantias de ACEITAÇÃO NO MERCADO  ou  AJUSTES  PARA  PROPÓSITOS
    PARTICULARES.   Veja  a  GNU  General  Public License para  mais
    detalhes.

    Você  deveria  ter  recebido  uma  cópia  da GNU  General Public
    License junto com este programa; se não recebeu, escreva para  a
    Free   Software  Foundation,  Inc.,   675  Mass Ave,  Cambridge,
    MA 02139, USA.