]>

# Il manuale del KSCD

Bernd Johannes
Wuebben

    wuebben@kde.org

David
White

    a9403784@unet.univie.ac.at

Version 0.8
Sep 14, 1998

Questo manuale descrive il Kscd, Versione 0.8

KDE
KSCD
CD audio
CDDB

## Introduzione

Kscd è un veloce player CD per piattaforme UNIX, predisposto per l'uso del database CDDB. Kscd sta per "The KDE Project's small/simple CD player".

Novità: è fornito lo script Perl workman2cddb.pl per facilitare il passaggio per gli utilizzatori di workman.

Spero che questo programma ti sia utile!,

`Bernd Johannes Wuebben`

wuebben@kde.org

## Installazione

### Come procurarsi Kscd

Kscd è parte del pacchetto kdemultimedia disponibile presso il progetto KDE http://www.kde.org.

### Requisiti

Per compilare correttamente il Kscd, ti servono le ultime versioni delle librerie KDE, come pure della libreria Qt C++. Tutte le librerie richieste, come pure lo stesso Kscd, possono essere reperite a ftp://ftp.kde.org/pub/kde/.

Kscd supporta le seguenti piattaforme:

- Linux

- FreeBSD

- NetBSD

- BSD386

- Sun

- Solaris (including cdda support)

- HPUX

- SGI Irix (including cdda support)

- Sony NEWS

- OSF/1

- Ultrix

e dovrebbe compilarsi correttamente su molte altre con poche modifiche.

### Compilazione e installazione

Per compilare ed installare Kscd sul tuo sistema, dai i seguenti comandi nella directory base della distribuzione di Kscd:

    % ./configure
    % make
    % make install

Per favore informami di qualsiasi modifica hai dovuto fare per compilare Kscd sulla tua piattaforma.

## Fondamentali dell'interfaccia

### Finestra principale

Dovresti vedere qualcosa di simile all'avvio: kscd. I controlli presenti in questa finestra sono descritti più in basso.

#### Pannello di controllo principale

La funzione di questi bottoni dovrebbe essere familiare a chiunque abbia mai usato un lettore CD. Il bottone più in alto del diagramma qui sopra commuta tra la modalità pausa e quella di riproduzione del CD. Il bottone a sinistra nella seconda riga ferma la riproduzione. Il bottone a destra di questo permette di scegliere se attivare la ripetizione automatica (loop) o meno, cosicchè la lettura riprenderà dalla prima traccia quando è stata raggiunta la fine dell'ultima. I bottoni nella terza riga muovono la testina del lettore indietro (sinistra) o avanti (destra) di 30 secondi. I bottoni nella quarta riga permettono di passare alla riproduzione della traccia precedente (sinistra) o successiva (destra).

#### Il bottone di espulsione

Nota che il bottone di espulsione sul drive CD-ROM può non rispondere se vi è un CD audio nel drive e Kscd è funzionante. Alcuni CD-ROM molto vecchi possono non supportare il comando di espulsione da software; potresti anche dover chiudere il cassettino a mano dopo aver inserito un nuovo CD.

#### Il display di stato

Partendo dall'alto, da destra a sinistra, si trovano l'indicatore principale del tempo (vedi sotto per una descrizione dei possibili modi di visualizzazione del tempo), lo stato del drive CD-ROM, il tempo totale riprodotto del CD audio, l'impostazione corrente del volume, il numero della traccia corrente e quello delle tracce totali (curr./max.). Le due linee più in basso indicano l'artista ed il titolo del CD, e quindi il titolo della traccia, posto che siano presenti le voci appropriate nel CDDB (CD Data Base) locale o in quello del network.

#### Il bottone della modalità di visualizzazione del tempo

Questo bottone commuta tra i principali possibili modi di visualizzazione del tempo. L'impostazione predefinita prevede che kscd indichi il tempo trascorso della traccia corrente se il cd è in riproduzione, e --:-- oppure 00:00 se non lo è. La pressione di questo bottone commuta, in sequenza, tra l'indicazione del tempo rimanente della traccia, del tempo totale trascorso dell'intero CD, e del tempo rimanente alla fine del CD.

#### Il bottone di configurazione

Questo bottone apre il pannello di configurazione del kscd; questo ti permette di configurare kscd per lavorare sul tuo computer. Vedi la sezione "Configurare kscd" per maggiori dettagli.

#### Il bottone dell'editor CDDB

Questo pulsante apre l'editor del listato CDDB (Compact Disc Data base). Il CDDB può identificare il tuo CD e spesso scaricare dal net o dal filesystem la lista delle sue tracce. Vedi la sezione "L'editor del Database CD" per dettagli su questo strumento.

#### Il bottone di ricerca su Internet

Questo tasto ti aiuterà a ricercare informazioni sull'artista su Intenet. Puoi trovare le date dei concerti, infiormazioni sull'acquisto di suoi prodotti, e altro ancora premendo questo bottone e scegliendo l'opzione appropriata nel menu a scomparsa che appare.

#### Il bottone Chiudi

Questo bottone chiude kscd.

#### Il cursore di output audio

Questo cursore controlla il volume dell'output audio del CD: a destra è più alto, mentre a sinistra più basso. Se stai suonando il CD attraverso lascheda sonora, sul volume influirà anche il mixer della scheda.

#### Il box di selezione diretta della traccia

Questo 'combo box' ti permette di selezionare direttamente la traccia da riprodurre

#### Il bottone di riproduzione casuale

Questo bottone permette di riprodurre le tracce del CD in ordine casuale.

### Configurare kscd

La finestra primaria di configurazione di kscd è una schermata munita di tabs con tre sezioni principali.

- CDDB

- kscd options

- About

### Configurare: il tab CDDB

Il tab CDDB setta la funzione CDDB (Compact Disc Data Base) di kscd. Il checkbox "enable remote CDDB" abilita o disabilita le ricerche su Internet.

#### "CDDB Base Directory"

Questo campo di immissione testo ti permette la scelta della directory in cui registrare localmente le voci del CDDB.

#### "Send CDDB submissions to"

Questo campo contiene l'indirizzo e-mail a cui inoltrare le voci del CDDB. L'indirizzo predefinito è "xmcd-cddb@amb.org". Dalla versione 8.0, le voci del CDDB scritte da kscd sono accettate e incluse nel database generale.

#### "CDDB Server"

Questo box a lista mostra un elenco dei server CDDB conosciuti. Seleziona una voce ed essa comparirà anche nel campo sopra il box di selezione. Premi il bottone "Update" per aggiornare la lista; "Defaults" setta l'indirizzo di default, "cddb.cddb.com 888", che ti permetterà di aggiornare la lista dei servers CDDB con l'ultima disponibile.

#### "Help"

Questo tasto apre la home page dell'help di kscd

### Configurare: Il tab Kscd Options

#### "LED Color" e "Background Color"

Questi campi mostrano il colore selezionato per le scritte e lo sfondo del display di stato. Premi il bottone "Change" vicino al box colorato per cambiare questi colori.

#### "CDROM Device"

Questo campo contiene l'identificativo del dispositivo CDROM da usare per la riproduzione. Il valore predefinito è "/dev/cdrom". I permessi per questo dispositivo devono essere settati per permettere di aprire lo stesso in modalità di sola lettura. Cambiare i permessi di questo file di periferica richiede in quasi tutti i casi privilegi di superuser e può essere fatto da linea di comando o nel "Super User Mode" di kfm. (NdT: questo paragrafo era molto tecnico; ho cercato di tradurlo il più sensatamente possibile. Se riscontri problemi, scrivimi :)

#### "Unix mail command"

Questo campo mostra i comandi usati per spedire voci CDDB al database. Il valore predefinito è `mail -s "&percnt;s"`. Dovrai assicurarti che questo effettivamente spedisca posta elettronica a sistemi non-locali se vorrai inoltrare le voci, specialmente se accedi a Intern via connessione telefonica dial-up. Controlla la documentazione della tua distribuzione Linux per maggiori dettagli. Alcune distribuzioni che usano sendmail per spedire e-mail richiedono solo che immetti il tuo host di e-mail nel campo ""Smart" relay host" in /etc/sendmail.cf. In più, il sito CDDB richiederà di potere rispedirti un e-mail; potrebbe quindi essere necessario modificare /etc/sendmail.cf per assicurarti che l'indirizzo di ritorno della sottomissione sia valido.

#### "WWW-Browser"

Questa sezione ti permette di scegliere che browser web usare per accedere i siti web nei menu "information button". Puoi scegliere o kfm o un browser con i bottoni di scelta esclusiva. Di default, il campo "Use Custom Browser" contiene "netscape "&percnt;s"", per l'uso con Netscape Navigator o Communicator.

#### "Show Tool Tips"

Questa casella di selezione abilita o disabilita i tooltips (finestrelle che vengono mostrate quando il cursore del mouse è "parcheggiato" brevemente sopra un comando e che descrivono il comando stesso).

#### "Help"

Questo tasto apre la home page dell'help di kscd

### Configurare: Il tab About

Il tab "About" mostra alcune informazioni sulla versione di kscd che staiusando ed alcune informazioni sul copyright.

### L'editor del database CD

L'editor del Database CD ti permette di modificare, scaricare, salvare e inoltrare voci del CDDB (Compact Disc Data Base). Se c'è una voce nella struttura locale del CDDB (vedi la sezione CDDB in "Configurare kscd") per il CD presente nel drive CD-ROM locale, o se il disco può essere trovato nel CDDB, vedrai il nome dell'artista e il titolo del CD nel campo "Disc Artist / Title" e una lista delle tracce con i titoli delle canzoni nel box di selezione "Track / Time / Title". Altrimenti, vedrai una lista delle tracce e dei tempi di riproduzione senza i titoli.

#### "Ext info"

Puoi aggiungere annotazioni sull'intero disco con il bottone "Ext Info" accanto al campo "Disc Artist / Title", o per una traccia selezionata nel box di selezione "Track / Time / Title" usando l'adiacente tasto "Ext Info"

#### "Edit track title"

Se selezioni una traccia nel box "Track / Time / Title", il titolo, se presente, apparirà nel campo "Edit Track Title" sottostante; puoi quindi digitare un titolo per la traccia indicata nel box, o modificare la voce per adattarla alle tue esigenze. Premi il tasto "Return" sulla tastiera, e il testo comparirà nella linea adatta del box di selezione.

#### "Submit"

Una volta che sono stati dati titoli a tutte le tracce e che è stato riempito il campo "Disc Artist / Title", puoi premere il tasto "Submit" per spedire questi parametri al CDDB, via e-mail. Ti sarà richiesto di fornire una categoria per la registrazione delleinformazioni del tuo CD.

#### "Disc ID"

Questa sezione mostra il codice d'identificazione (ID Code) di 32 bit usato da CDDB per identificare un CD. Sopra di esso c'è la categoria sotto cui sono registrate le informazioni. Queste categorie corrispondono alla struttura delle sottodirectory della directory scelta in "CDDB Base Directory" nel tab CDDB della finestra di configurazione di kscd.

#### "Total Time"

Questo display mostra la durata totale del CD.

#### "Play List Editor"

Questo permette di cambiare l'ordine in cui le tracce vengono riprodotte. Inserisci lista dei numeri di traccia separati da virgola per definire un nuovo ordine di riproduzione.

#### "Save"

Questo bottone salva i campi mostrati sul disco. Ti sarà ancora richiesto di indicare una categoria sotto cui salvare le voci; seleziona una directory e premi "Ok" per completare il salvataggio.

#### "Load"

Questo bottone farà apparire la richiesta di un luogo dove cercare una voce CDDB che non sia il server CDDB remoto o la lista salvata localmente.

Il bottone "Close" chiude il CD Database Editor.

## Informazioni su CDDB

Il Compact Disc Data Base è un database dispnibile in rete su Internet che contiene informazioni su praticamente tutti i CD in circolazione. Se possiedi un accesso a Interner correttamente configurato, probabilmente non dovrai mai inserire manualmente informazioni sui tuoi CD. Vedi la sottosezione "CDDB Tab" in "Configurare kscd" per istruzioni dettagliate su come configurare il server CDDB, e "L'editor del database CD" per come modificarne le voci.

L'uso di CDDB è gratuito. Sono graditi ed incoraggiati gli aggiornamenti inoltrati dall'utenza.

Quando prepari voci per il CDDB, tieni presenti i seguenti punti:

- Usa caratteri latini "standard". Sono supportati alcuni caratteri speciali, ma, ad esempio, le voci in Cirillico o Greco non saranno accettate.

- Usa solo un carattere "/" nel campo "Disc Artist / Title". Per CD di musica classica, è pratica standard porre il nome del compositore nella sezione "Artist" (prima dello slash "/") e il nome dell'esecutore nella sezione "Title" (dopo lo slash "/").

- Se spedisci una voce che esiste già, qualunque informazione addizionale tu fornisca potrebbe essere aggiunta alla voce esistente sul server.

Per default, kscd installa le categorie standard in `$KDEDIR/share/apps/kscd/cddb`. Puoi creare quante sottodirectory vuoi; comunque, quando le spedisci al server remoto, saranno mostrate solo quelle standard. L'indirizzo predefinito per l'invio è "xmcd-cddb@amb.org". Per maggiori informazioni su CDDB visita la sua homepage.

Le voci di CDDB locali per un CD particolare sono registrate nel file `<category name>/<disc ID>` indicato nel campo "CDDB Base Directory". Questi files possono essere modificati con un qualsiasi editor di testo, se non hai nulla di meglio da fare nel tempo libero ;).

## Domande e risposte

### D. Quando avvio kscd appare la finestra di dialogo "CDROM read or access error". Cosa c'è che non va?

R. Questo significa che kscd non può accedere al drive CD-ROM. Il nome del dispositivo nel campo 'CDROM Device' in "kscd Configuration" deve effettivamente riferirsi al block device associato al tuo drive CD-ROM. Questo sarà spesso un hardlink al dispositivo IDE (`/dev/hdx`) o SCSI (`/dev/sdx`) appropriato. Il file normalmente appartiene all'user root nel gruppo root, e non permette agli altri users di accedervi per letture, scritture o esecuzioni direttamente. Questo non ha *niente* a che fare con il comando SUID (I programmi di Set User ID usano la funzione `setuid()` nella libreria standard Unix per assumere l'identità di un altro user) `mount`, che non ha problemi con i permessi; kscd dovrebbe essere in grado di ottenere un descrittore di file a sola letturariferendosi al dispositivo CD per controllare il drive CDROM e leggere dati da esso.

Se sei in possesso della password del root, puoi risolvere il problema rapidamente e con facilità. Diventa root e digita `chmod a+r /dev/cdrom` per permettere ad ogni utente di leggere da `/dev/cdrom`. Se il tuo dispositivo CDROM è chiamato in altro modo, cambia i permessi del file appropriato nello stesso modo. Se non hai la password del root, chiedi gentilmente all'amministratore del sistema di darti il permesso di lettura del dispositivo.(NdT: questi paragrafi erano molto tecnici; ho cercato di tradurli il più sensatamente possibile. Se riscontri problemi, scrivimi :)

Vedi anche la sezione "Configurare il kscd"

### D. Non riesco a far funzionare il CDDB. Dove posso ottenere informazioni dettagliate su cosa potrebbe essere andato storto?

R. Se hai problemi con le funzioni CDDB prova ad avviare kscd dalla linea di comando con l'opzione `-d` e osservare l'output di debug prodotto.

## Epilogo

### Ringraziamenti

Grazie specialmente a Ti Kan e Steve Scherf, gli inventori del concetto del database CDDB. Visita www.cddb.com per maggiori informazioni su CDDB.

grazie anche a Paul Harrison per aver scritto Synaesthesia su cui è basato KSCD Magic.

Un ringraziamento molto speciale anche a David White che ha scritto la documentazione dell'help di Kscd. Ottimo lavoro, David!

### Sviluppatori

`Bernd Johannes Wuebben - Autore e maintainer`

### Autori

`Bernd Johannes Wuebben - Prima stesura`

`David White - Redattore`

`Eric Bischoff - Editore`

`Germano Rizzo - Traduzione italiana`

### Copyright

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

    kscd contiene codice da:
    workman 1.4 beta 3 Copyright (c) Steven Grimm koreth@hyperion.com

    Questo programma è free software; puoi ridistribuirlo e/o modificarlo
    sottostando ai termini della GNU General Public License come pubblicata dalla
    Free Software Foundation, dalla versione 2 in poi.

    Questo programma è distribuito nella speranza che sia utile, ma SENZA ALCUNA
    GARANZIA; senza neppure le garanzie implicite di COMMERCIABILITÀ o
    ADATTABILITÀ AD UN PARTICOLARE SCOPO. Vedi la GNU General Public License per
    maggiori dettagli.

    Assieme al programma dovresti aver ricevuto copia della GNU General Public
    License; se altrimenti, scrivi alla Free Software Foundation, Inc., 675 Mass Ave, Cambridge, MA 02139, USA.