# O Manual do &kscd;

## IntroduçÂão

O &kscd; é um leitor de CDs pequeno, rápido e com o CDDB activo para as plataformas de &UNIX;. O &kscd; significa The KDE Project's small/simple &CD; player.

Novo: A programa `workman2cddb.pl` em Perl fornecido para facilitar a transiçÂão para os utilizadores do 'workman'.

Esperemos que goste deste leitor 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 de cdda)

- &HP-UX;

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

- Sony NEWS

- OSF/1

- Ultrix

e deverá conseguir compilar em muitos outros com poucas modificaçÂões.

## Fundamental do ecrã

### 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 controlos desta janela estão explicado em baixo, sem nenhuma ordem em particular.

#### O Painel de Controlo

O Painel de Controlo O Painel de Controlo

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

O botÃ£o superior no diagrama comuta entre a leitura e a pausa do &CD;. O botÃ£o esquerdo da segunda fila pÃ¡ra o &CD;. O botÃ£o direito da segunda fila activa ou desactiva a repetiÃ§Ã£o do ciclo de leitura, de modo a que o &CD; irÃ¡ comeÃ§ar a tocar de novo do inÃcio quando for atingido o fim da Ãºltima faixa de Ã¡udio. Os botÃµes da terceira fila avanÃ§am ou recuam o &CD; (botÃ£o esquerdo ou direito, respectivamente) 30 segundos. Os dois botÃµes na Ã¡rea de estado saltam para o inÃcio da faixa anterior (botÃ£o esquerdo) ou seguinte (botÃ£o direito).

#### O botão de Ejectar

O botão de Ejectar O botão de Ejectar

Este botão expulsa o &CD;. Repare que o botão de ejecçÂão da sua unidade de &CD-ROM; poderá não responder se estiver um &CD; de áudio na unidade e o &kscd; foi iniciado. Algumas unidades muito antigas podem não suportar a ejecçÂão por 'software'. Você poderá também ter de fechar a unidade de &CD-ROM; manualmente, depois de introduzir um disco novo.

#### A Área de Estado

A Área de Estado A Área de Estado

Esta é a área de estado. A começar do topo, e da direita para a esquerda, está a área de apresentaçÂão do tempo (veja em baixo uma discussão sobre os modos de apresentaçÂão do tempo possíveis), o estado da unidade de &CD-ROM;, o tempo total de reproduçÂão do &CD; de áudio, a configuraçÂão actual do volume e o número actual e total da faixa (actual/total). As duas linhas inferiores mostra o artista e o título do &CD;, e depois o título da faixa, assumindo que existem registos apropriados no CDDB local ou da rede (&CD; Data Base - Base de Dados de &CD;s.)

#### Modos de apresentaçÂão do tempo

A opçÂão de VisualizaçÂão do Tempo A opçÂão de VisualizaçÂão do Tempo

Este botão comuta entre so vários modos de apresentaçÂão do tempo principal. Por omissão, o &kscd; mostra o tempo decorrido na faixa actual, se o &CD; estiver a tocar, ou então ––:–– ou 00:00 se o &CD; não estiver a tocar. Se carregar neste botão, comuta 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 de ConfiguraçÂão O botão de ConfiguraçÂão

Este botão abre o painel de configuraçÂão do &kscd;. Isto permite-lhe configurar o &kscd; para funcionar na sua máquina. Veja a secçÂão configurar o &kscd; para mais detalhes sobre como configurar o &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 registos do CDDB (Compact Disc Data Base).

O CDDB poderá identificar o seu &CD; e obtém uma lista das faixas para esse &CD; da rede ou poderá consultar a partir do sistema de ficheiros. Veja a secçÂão do Editor da Base de Dados de &CD;s para mais detalhes sobre como usar esta ferramenta.

#### O botão de InformaçÂão

O botão de InformaçÂão O botão de InformaçÂão

Este botão irá ajudá-lo a procurar por informaçÂões acerca do artista na Internet. Você poderá saber mais sobre as datas de espectáculos, informaçÂões de compras e outras informaçÂões se carregar neste botão e escolher a opçÂão apropriada no menu de contexto que aparece.

#### O botão Sair

O botão Sair O botão para sair

Este botão fecha o &kscd;.

#### A barra do Volume

A barra do Volume A barra do Volume

Esta barra 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 a tocar o seu &CD; através da sua placa de som, a mesa de mistura da placa de som irá afectar o volume da reproduçÂão também.

#### O botão Aleatório

O botão Aleatório O botão Aleatório

Este botão faz com que as faixas do &CD; sejam tocadas por ordem aleatória.

#### O selector de faixas

O selector de faixas O selector de faixas

Esta lista mostra-lhe a faixa actual e permite-lhe seleccionar directamente a faixa a tocar.

## Configurar o &kscd;

### A janela de configuraçÂão principal

A janela de configuraçÂão principal do &kscd; é uma janela com páginas separadas em secçÂões.

- Leitor de CDs

- freedb

- SMTP

- Créditos

### A página do Leitor de CDs

A página Leitor de CDs A página da ConfiguraçÂão do KSCD

Os campos Cor do LCD e Cor de Fundo mostram a cor seleccionada para o texto e para o fundo da área de estado. Carregue nas barras de cores para alterar essas cores.

Ajuste o Intervalo do salto para o número de segundos para mover para a frente ou para trás dos quando os botões avançar ou recuar no Painel de Controlo forem carregados.

A opçÂão Mostrar as dicas activa as dicas (umas janelas pequenas que aparecem quand o rato pára brevemente em cima de um controlo) ou desactiva-as.

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

O Tocar automaticamente ao introduzir o CD faz com que o &CD; comece a tocar quando a bandeja do &CD; for fechada, sem ter de carregar no botão Tocar.

Ejectar o CD ao terminar a reproduçÂão faz com que o &CD; seja expulso quando terminar de tocar.

O Parar de tocar o CD ao sair faz com que a leitura do &CD; pare quando o &kscd; for fechado.

VocÃª poderÃ¡ escolher como Ã© que a reproduÃ§Ã£o aleatÃ³ria funciona, em duas opÃ§Ãµes simples: Trocar a ordem e tocar cada mÃºsica sÃ³ uma vez e Seleccionar aleatoriamente as mÃºsicas (pode repetir).

O campo do Dispositivo de CD-ROM contÃ©m o nome do dispositivo de &CD-ROM; a usar para tocar os &CD;s de Ã¡udio. O valor por omissÃ£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 obrigar normalmente a ter privilÃ©gios de super-utilizador e poderÃ£o ser feitas na linha de comandos ou no Modo de Super-Utilizador do &konqueror;.

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

### A página freedb

A página freedb da janela de configuraçÂão A página freedb da janela de configuraçÂão

A página freedb configura as funçÂões do CDDB no &kscd;.

A opÃ§Ã£o Activar o 'freedb' remoto activa ou desactiva as pesquisas de CDDB na Internet. O tempo permitido entre as tentativas de pesquisa poderÃ¡ ser definido. Para usar um 'proxy' de &HTTP;, assinale a opÃ§Ã£o Usar um 'proxy' HTTP para aceder ao freedb e indique o &URL; no campo em baixo.

Se assinalar a opÃ§Ã£o Activar a auto-gravaÃ§Ã£o na base de dados local faz com que a informaÃ§Ã£o do CDDB seja guardada localmente, poupando-o a ter de efectuar repetidamente pesquisas na Internet. O campo de texto Pasta base do freedb: permite-lhe escolher a pasta onde vocÃª deseja guardar os itens do CDDB localmente.

A lista servidor de 'freedb': mostra uma lista com os servidores de 'freedb' conhecidos. Seleccione um item desta lista para que este apareÃ§a no campo de texto acima da lista. Carregue no botÃ£o Actualizar para actualizar a lista de servidores. Carregue no botÃ£o PredefiniÃ§Ãµes para indicar o valor por omissÃ£o, `freedb.freedb.org cddbp 888 -`, que lhe permitirÃ¡ actualizar a lista com uma lista nova dos servidores de 'freedb' enumerados do 'site' mestre do 'freedb' em `freedb.freedb.org`. Os servidores tambÃ©m poderÃ£o ser adicionados manualmente se indicar o endereÃ§o na opÃ§Ã£o em cima, carregando depois no botÃ£o +. Carregue no botÃ£o - para retirar o item seleccionado da lista.

O campo Enviar os pedidos do 'freedb' para: contÃ©m o endereÃ§o de e-mail para onde deverÃ£o ser enviados os registos de CDDB. O endereÃ§o por omissÃ£o Ã© o freedb-submit@freedb.org. Desde a versÃ£o 0.8, os registos de CDDB do &kscd; sÃ£o aceites para ser incluÃdos na base de dados. Indique os servidores manualmente, indicando o endereÃ§o na opÃ§Ã£o de cima e carregando no botÃ£o +. Carregue no botÃ£o - para remover o item seleccionado da lista. O botÃ£o PredefiniÃ§Ãµes repÃµe todas as opÃ§Ãµes nos seus valores por omissÃ£o. O botÃ£o Ajuda abre a pÃ¡gina de ajuda do &kscd; (este documento).

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

### A página SMTP

A página de SMTP

A pÃ¡gina de SMTP configura a ligaÃ§Ã£o a um servidor de e-mail para submeter os envios de pedidos de CDDB. Isto Ã© Ãºtil se vocÃª nÃ£o tem o seu prÃ³prio sistema configurado como um servidor. Assinale a opÃ§Ã£o Activar envios por SMTP para usar esta funcionalidade. Seleccione o seu perfil de e-mail preferido no Perfil de E-Mail Actual. Indique o endereÃ§o do servidor de SMTP no campo Servidor: e o nÃºmero de porto (normalmente o `25`) no campo Porto:.

VocÃª poderÃ¡ optar por Usar os endereÃ§os de e-mail do Centro de Controlo se desejar. Se vocÃª quiser abrir o mÃ³dulo do &kcontrol; para configurar este endereÃ§o de e-mail, carregue no campo Abrir o pianel de controlo do endereÃ§o de e-mail. A alteraÃ§Ã£o do endereÃ§o aqui irÃ¡ alterar o endereÃ§o por omissÃ£o para todas as aplicaÃ§Ãµes do &kde; que usam esta opÃ§Ã£o, nÃ£o sÃ³ para o &kscd;, por isso faÃ§a isto com cuidado.

Se nÃ£o quiser usa o endereÃ§o de e-mail configurado de forma global, escolha a opÃ§Ã£o chamada Usar os seguintes endereÃ§os de e-mail e indique um endereÃ§o diferente de e-mail ou de resposta nos campos de texto em baixo.

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

### A pÃ¡gina CrÃ©ditos

A pÃ¡gina CrÃ©ditos mostra-lhe algumas informaÃ§Ãµes sobre a versÃ£o do &kscd; que estÃ¡ a usar e algumas informaÃ§Ãµes de 'copyright'.

## 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, obter, gravar, anotar e enviar registos de CDDB (Compact Disc Data Base - Base de Dados de CDs).

Se existir um registo na sua Ã¡rvore de CDDB local (veja a secÃ§Ã£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 selecÃ§Ã£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 por baixo do campo TÃtulo ou para uma faixa seleccionada na lista Faixas com o botÃ£o ComentÃ¡rio adjacente. Se vocÃª seleccionar uma faixa na lista Faixas, o tÃtulo, se estiver presente, irÃ¡ aparecer no campo TÃtulo em baixo. VocÃª poderÃ¡ escrever um tÃtulo para a faixa nesse campo ou editar o registo de acordo com as suas necessidades. Carregue na tecla Return do seu teclado e o texto irÃ¡ aparecer na linha adequada da lista.

Logo que todas as faixas tenham tÃtulos e os campos Artista: e TÃtulo tenham sido preenchidos, vocÃª poderÃ¡ carregar no botÃ£o Enviar para submeter os resultados por e-mail para o 'freedb'.

Ser-lhe-Ã¡ pedido para seleccionar uma categoria para o envio. O ID do Disco mostra o cÃ³digo de 32 bits usado pelo 'freedb' para identificar um disco compacto. Por cima do cÃ³digo identificador estÃ¡ a categoria do registo 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;.

Carregue no botÃ£o Obter a InformaÃ§Ã£o para obter os dados do CDDB. Carregue no botÃ£o OK para gravar localmente as suas alteraÃ§Ãµes. O botÃ£o Cancelar fecha o Editor de Bases de Dados do &CD; sem gravar.

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

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

Quando a opÃ§Ã£o Mostrar o Ãcone na bandeja do sistema estiver assinalada, uma pequena 'applet' do &kscd; Ã© tambÃ©m mostrada no painel do KDE. Ao contrÃ¡rio da janela principal do &kscd;, esta 'applet' fica disponÃvel em qualquer ecrÃ£. Se carregar com o &RMB; na 'applet' irÃ¡ aparecer um menu para controlar a reproduÃ§Ã£o do &CD;. Se carregar com o botÃ£o esquerdo na 'applet' irÃ¡ esconder a janela principal do &kscd;. Se a janela principal estiver escondida, um segundo 'click' com o botÃ£o esquerdo na 'applet' irÃ¡ repÃ´-la.

Para ser mais exacto, a 'applet' Ã© mostrada na bandeja do sistema no painel. Se nÃ£o aparecer nenhuma 'applet' quando o &kscd; Ã© minimizado, vocÃª poderÃ¡ ter removido a bandeja. Para a adicionar, carregue com o botÃ£o direito num espaÃ§o vazio do painel e seleccione Adicionar 'Applet' Bandeja do Sistema

## Suporte de 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 um acesso Ã Internet, vocÃª poderÃ¡ nunca ter de introduzir manualmente a informaÃ§Ã£o das faixas para os seus &CD;s se tiver isto configurado convenientemente. Veja a subsecÃ§Ã£o da pÃ¡gina do 'freedb' no capÃtulo de configuraÃ§Ã£o do &kscd; para obter informaÃ§Ãµes mais detalhadas sobre como configurar este serviÃ§o, e a secÃ§Ã£o do Editor de Bases de Dados de CDs para mais instruÃ§Ãµes sobre como editar os registos do CDDB.

A utilizaÃ§Ã£o do CDDB Ã© livre. SÃ£o encorajados os envios por parte dos utilizadores.

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

- Use caracteres 'latin' padrÃ£o nos registos. Alguns caracteres especiais sÃ£o suportados, mas submissÃµes em CirÃlico ou Grego, por exemplo, nÃ£o poderÃ£o ser aceites.

- Use sÃ³ um carÃ¡cter / 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 secÃ§Ã£o do Artista (antes da barra) e o nome do cantor na secÃ§Ã£o TÃtulo (depois da barra).

- Se enviar um registo que jÃ¡ exista na base de dados, todas as informaÃ§Ãµes adicionais que enviar poderÃ£o ser adicionadas ao registo existente.

Por omissÃ£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 por omissÃ£o Ã© o freedb-submit@freedb.org. Para mais informaÃ§Ãµes sobre o freedb visite a pÃ¡gina pessoal do freedb.

O registo de CDDB local para um dado &CD; Ã© armazenado no ficheiro ``nome da categoria`/`ID do disco`` na Pasta de Base do CDDB. Estes ficheiros 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 esta janela quando inicio o &kscd;. O que se passa de errado?

Janela de erros Janela de erros

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

O ficheiro do dispositivo normalmente pertence ao utilizador 'root' no grupo 'root', e nÃ£o permite aos utilizadores normais acederem a ele para leitura, escrita ou execuÃ§Ã£o directamente. 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 utilizador) que Ã© o `mount`, que nÃ£o tem problemas nenhuns com as permissÃµes; o &kscd; precisa de ser capaz de criar um descritor de ficheiro para se referir ao dispositivo de &CD; para controlar a unidade de &CD-ROM; e ler os dados em bruto a partir do disco.

Se vocÃª tiver a senha do 'root', poderÃ¡ corrigir isto rÃ¡pida e facilmente. Mude para 'root' e escreva ``chmod` `a+r` ``/dev/cdrom``` para permitir a qualquer utilizador 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 pÃ´r o CDDB a funcionar. Ã possÃvel obter alguma informaÃ§Ã£o detalhada sobre o que se estÃ¡ a passar de errado?

Se vocÃª estiver a ter problemas com a funcionalidade do CDDB tente iniciar o &kscd; a partir da linha de comandos com a opÃ§Ã£o `-d` e veja o resultado da depuraÃ§Ã£o.

## Créditos e licenças

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

O &kscd; contÃ©m cÃ³digo de:

- workman 1.4 beta 3 Copyright (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://ww.cddb.com para obter mais informaÃ§Ãµes sobre o CDDB.

Um especial agradecimento tambÃ©m ao David White que fez a documentaÃ§Ã£o original de ajuda do &kscd;. Belo trabalho, David!

DocumentaÃ§Ã£o actualizada para o KDE 2.0, e 'copyright' do Jonathan Singer jsinger@leeta.net.

TraduçÂão de José Nuno Pires jncp@netcabo.pt

&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 'site' 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 actual, o Dirk Foersterling, em milliByte@gmlx.net sobre qualquer modificaÃ§Ã£o que vocÃª tenha efectuado para pÃ´r o &kscd; a compilar na sua plataforma.

&documentation.index;