# 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
José Pires

    jncp@netcabo.pt

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

O &kscd; é um leitor de CDs pequeno, rápido e com o CDDB activo 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.

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 esquerdo da fila inferior comuta o modo aleatório; o botão direito da mesma fila comuta 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.

#### 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.)

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 Extras
O botão Extras

Este botão abre um menu com um conjunto de opções. 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 secção configurar 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 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.

Este menu também lhe permite abrir este documento de ajuda, comunicar 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 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 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 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 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 com três secções principais.

- Leitor de CDs

- Procura Freedb

- Envio Freedb

### 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.

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

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.

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 ejectado do leitor quando terminar de tocar.

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

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 Procura freedb

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

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

A opção Modo determina como é que as pesquisas do CDDB são feitas. Se escolher a opção Apenas a '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 Apenas remoto vai procurar todos os discos na Internet. O tempo-limite para a pesquisa poderá também ser definido.

A lista Servidor de CDDB: permite-lhe indicar o seu servidor de 'freedb'. Indique o endereço e o número do porto do servidor. Seleccione um item desta lista, para que apareça no campo de texto em baixo. O formato da ligaçã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 predefinidos). O Pastas de 'Cache': permite-lhe escolher a pasta em que deseja gravar os registos do CDDB localmente.

### A página Envio de freedb

A página de Envio freedb

A página Enviar do 'freedb' configura a ligação a um servidor de e-mail para enviar os novos registos de CDDB. Isto é útil se você não tiver o seu próprio sistema como um servidor. Assinale a opção Activar envios por SMTP para usar esta funcionalidade.

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.

Caso contrário, seleccione o seu perfil de e-mail preferido na opção Usar os seguintes endereços de e-mail. Indique o seu endereço de e-mail, um endereço de resposta, se desejad e o endereço do servidor de SMTP no campo Servidor: e o número de porto (normalmente o `25`) no campo Porto:.

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.

## 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://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 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 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 actual, 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;