# Manuel de Kscd

Bernd Johannes
Wuebben

    wuebben@kde.org

David
White

    a9403784@unet.univie.ac.at

Version 0.8, 14 septembre 1998

Ce manuel décrit Kscd Version 0.8.

Le Manuel de KSCD

KDE
KSCD
lecteur de CD
CD audio

## Introduction

Kscd est un lecteur de CD, pour les plate-formes UNIX, rapide et permettant l'accès à CDDB. Kscd signifie "The KDE Project's small/simple CD player".

Nouveau : script Perl workman2cddb.pl fourni pour faciliter l'adaptation des utilisateurs de workman.

J'espère que ce lecteur de CD vous plaira,

`Bernd Johannes Wuebben`

wuebben@kde.org

## Installation

### Comment obtenir Kscd

Kscd fait partie du paquetage kdemultimedia disponible sur le site du projet KDEhttp://www.kde.org.

### Configuration nécessaire

Pour réussir à compiler Kscd, vous devez posséder une des dernières versions des bibliothèques de KDE, ainsi que la bibliothèque C++ Qt. Toutes les bibliothèques nécessaires ainsi que Kscd peuvent être téléchargés à ftp://ftp.kde.org/pub/kde/.

KSCD fonctionne sur les plates-formes suivantes :

- Linux

- FreeBSD

- NetBSD

- BSD386

- Sun

- Solaris (incluant le support de cdda)

- HPUX

- SGI Irix (incluant le support de cdda)

- Sony NEWS

- OSF/1

- Ultrix

et devrait pouvoir être compilé sur beaucoup d'autres moyennant quelques modifications.

### Compilation et installation

Pour compiler et installer Kscd sur votre système, utilisez la commande suivante, saisie dans le répertoire de base de la distribution de Kscd :

    % ./configure
    % make
    % make install

Si possible, indiquez-moi les modifications que vous avez du effectuer pour réussir à compiler KSCD sur votre plate-forme.

## Commandes principales

### Fenêtre principale

Vous devriez voir quelque chose de semblable lorsque vous lancez kscd. Les éléments de cette fenêtre sont décrits ci-dessous.

#### Panneau de commande principal

Le rôle de ces boutons devrait être familier à quiconque a déjà utilisé un lecteur de CD. Le bouton supérieur dans l'image ci-dessus permet de lire ou mettre en pause le CD. Le bouton de gauche dans la deuxième ligne arrête la lecture du CD. Le bouton de droite dans la deuxième ligne active/désactive la lecture en boucle, le CD redémarrant au début lorsque la fin de la dernière piste est atteinte. Les boutons de la troisième ligne permettent de reculer (à gauche) ou avancer (à droite) de 30 secondes. Les boutons dans la quatrième ligne avancent (à droite) ou reculent (à gauche) directement au début de la piste suivante ou précédente.

#### Bouton d'éjection

Il est possible que le bouton d'éjection sur votre lecteur de CD-ROM ne réponde pas si un CD audio est déjà dans le lecteur et si kscd est lancé. Quelques très anciens lecteurs de CD-ROM pourraient ne pas permettre l'éjection par un logiciel. Il se peut aussi que vous deviez fermer manuellement la trappe du lecteur de CD-ROM après l'insertion d'un nouveau disque.

#### Affichage de l'état

En partant du haut, de la gauche vers la droite, on trouve l'afficheur de temps principal (Voir après pour une description des différents modes d'affichage de temps), l'état du lecteur CD-ROM, la durée totale du CD audio, la valeur actuelle du volume, et la piste courante ainsi que le nombre total de pistes (cour./max.). Les deux lignes de texte les plus en bas affichent l'artiste et le titre du CD, ensuite le titre de la piste, sous réserve que les entrées appropriées existent dans la CDDB locale ou réseau (CD Data Base.)

#### Bouton de sélection du mode d'affichage

Ce bouton bascule entre les modes d'affichage de temps disponibles. Par défaut, kscd affiche la durée de lecture écoulée de la piste courante si le CD est en lecture ; sinon, il affiche --:-- ou 00:00. En appuyant sur ce bouton, on fait défiler en séquence les modes : durée de lecture restante de la piste, durée de lecture écoulée totale, et durée de lecture restante sur le disque.

#### Bouton de configuration

Ce bouton ouvre le panneau de configuration de kscd. Il vous permet de configurer kscd pour qu'il fonctionne sur votre machine. Voir la section "Configuration de kscd" pour plus de détails sur la configuration de kscd.

#### Bouton Editeur CDDB

Ce bouton ouvre le panneau d'édition des entrées CDDB (Compact Disc Data Base). La CDDB peut identifier votre CD et souvent télécharger la liste des pistes pour ce CD ou la charger à partir du système de fichiers. Voir la section "Editeur de Base de données CDDB" pour plus de détails sur l'utilisation de cet outil.

#### Bouton de Recherche sur Internet

Ce bouton vous aidera dans la recherche sur Internet d'informations sur l'artiste. Vous pourrez découvrir des dates de concert, des informations d'achat et d'autres informations en appuyant sur ce bouton et en choisissant l'option appropriée dans le menu qui apparaît.

#### Bouton de fermeture

Ce bouton ferme kscd.

#### Curseur de volume Audio

Ce curseur contrôle le volume de la sortie audio du CD. Vers la droite, c'est plus fort, vers la gauche, moins fort. Si vous écoutez votre CD à travers votre carte son, la table de mixage de la carte son influera aussi sur le volume d'écoute.

#### Liste de sélection directe de piste

Cette liste déroulante vous permet de sélectionner directement la piste que vous souhaitez écouter.

#### Bouton Lecture aléatoire

Ce bouton lance la lecture des pistes du CD dans un ordre aléatoire.

### Configuration de kscd

La fenêtre de configuration de kscd est une boîte de dialogue à onglets contenant trois sections principales.

- CDDB

- Options de Kscd

- A propos

### Configuration : L'onglet CDDB

L'onglet CDDB définit les fonctions CDDB (Compact Disc Data Base) de kscd. La case à cocher "Activer CDDB distante" active ou désactive les recherches de CDDB à travers Internet.

#### "Répertoire de base de CDDB"

Cette zone de texte vous permet de choisir le répertoire où vous voulez stocker localement vos entrées CDDB.

#### "Envoyer les contributions CDDB à"

Ce champ contient l'adresse e-mail pour soumettre des entrées CDDB. L'adresse par défaut est "xmcd-cddb@amb.org". Depuis la version 0.8, les entrées CDDB provenant de kscd sont acceptées pour inclusion dans la base de données.

#### "Serveur CDDB"

Cette liste affiche une liste de serveurs CDDB connus. Sélectionnez une entrée dans la liste et elle apparaîtra dans la zone de texte au-dessus de la liste de sélection. Pressez le bouton "Actualiser" pour mettre à jour la liste des serveurs dans la liste. Appuyez sur le bouton "Défaut" pour saisir la valeur par défaut, "cddb.cddb.com 888", qui vous permettra de rafraîchir la liste avec une liste récente de Serveurs CDDB listés sur le site CDDB principal cddb.cddb.com.

#### "Aide"

Ce bouton ouvre la page d'aide de kscd.

### Configuration : L'onglet Options de Kscd

#### "Couleur des LED" et "Couleur du fond"

Ces champs montrent la couleur sélectionnée pour le texte et l'arrière-plan de l'afficheur d'état. Pressez le bouton "Changer" après la zone de couleur pour modifier ces couleurs.

#### "Périphérique CDROM"

Ce champ contient le nom du périphérique CDROM à utiliser pour lire les CDs audio. La valeur par défaut est "/dev/cdrom". Les privilèges sur ce périphérique doivent être définis pour permettre l'ouverture en lecture seule du périphérique. La modification des privilèges sur ce fichier de périphérique nécessite, dans la plupart des cas, les droits de super-utilisateur et peut être effectuée à partir d'une ligne de commande ou dans le "Mode Super Utilisateur" de kfm.

#### "Commande de mail Unix"

Ce champ affiche le commande utilisée pour envoyer de nouvelles entrées CDDB à la base de données. La valeur par défaut est `mail -s "&percnt;s"`. Vous devrez vous assurer que cette commande envoie des mails à des systèmes non-locaux si vous voulez soumettre des entrées CDDB, spécialement si vous accédez à Internet par une connexion avec numérotation. Consultez la documentation de votre distribution Linux pour plus de détails. Quelques ditributions Linux qui utilisent sendmail pour délivrer les e-mails nécessitent seulement que vous saisissiez votre hôte de mail dans le champ ""Smart" relay host" du fichier /etc/sendmail.cf. De plus, le site CDDB voudra être capable de vous répondre par mail ; il pourrait donc être nécessaire d'éditer /etc/sendmail.cf pour vous assurer que l'adresse de retour de la soumission par mail est valide.

#### "Navigateur WWW"

Cette section vous permet de choisir quel navigateur web utiliser pour accéder aux sites web, dans les menus du "bouton d'information". Vous pouvez choisir, avec les boutons radio, soit kfm soit un navigateur personnalisé . Par défaut, le champ "Utiliser un navigateur personnalisé" contient "netscape "&percnt;s"", pour utiliser Netscape Navigator ou Communicator.

#### "Afficher les bulles d'aide"

Cette case à cocher active ou désactive les bulles d'aides (petites fenêtres qui apparaissent quand la souris reste un court instant sur un contrôle).

#### "Aide"

Ce bouton ouvre la page d'aide de kscd.

### Configuration : L'onglet A propos

L'onglet "A propos" affiche la version de kscd que vous utilisez et des informations de copyright.

### L'éditeur de base de données CDDB

L'éditeur de base de données de CD vous permet de modifier, télécharger, enregistrer, annoter et soumettre des entrées CDDB (Compact Disc Data Base). S'il y a une entrée dans votre arborescence CDDB locale (voir la sous-section CDDB dans "Configuration de Kscd") pour le CD dans votre lecteur CD-ROM, ou si le disque peut être trouvé dans la CDDB, vous verrez apparaître le nom de l'artiste et le titre du CD dans le champ "Disque Artiste / Titre" et une liste de pistes avec les titres des chansons dans la liste de sélection "Piste / Temps / Titre". Autrement, vous verrez une liste de pistes et de temps de lecture sans titres.

#### "Info comp"

Vous pouvez créer une annotation pour le disque entier avec le bouton "Info comp", situé après le champ "Disque Artiste / Titre", ou pour la piste sélectionnée dans la liste "Piste / Temps / Titre" avec le bouton "Info comp" adjacent.

#### "Edition du titre de la piste"

Si vous sélectionnez une piste dans la liste de sélection "Piste / Temps / Titre", le titre, s'il est présent, apparaîtra dans le champ "Edition du titre de la piste" en-dessous. Vous pouvez saisir un titre pour la piste dans la zone de texte ou modifier l'entrée pour l'adapter à vos souhaits. Appuyer sur la touche "Entrée" du clavier et le texte apparaîtra dans la bonne ligne de la liste de sélection.

#### "Envoyer"

Une fois que le titre de chaque piste a été donné et que le champ "Disque Artiste / Titre" a été rempli, vous pouvez appuyer sur le bouton "Envoyer" pour envoyer votre contribution par e-mail à la CDDB. Vous devrez choisir une catégorie pour la contribution.

#### "Disque ID"

Cette section affiche le code ID 32 bit utilisé par la CDDB pour identifier un compact disc. Au-dessus du code ID se trouve la catégorie de l'entrée CDDB. Ces catégories correspondent à l'arborescence de sous-répertoires du répertoire défini dans le "Répertoire de base de CDDB" de l'onglet CDDB de la fenêtre de configuration de kscd.

#### "Temps total"

Cet affichage montre la durée de lecture totale du CD.

#### "Editeur de play-list"

Ceci vous permet de modifier l'ordre de lecture du disque. Entrez une liste de numéros de piste séparés par une virgule pour définir un nouvel ordre de lecture.

#### "Enregistrer"

Ce bouton écrit sur le disque l'enregistrement affiché. Vous devrez choisir la catégorie sous laquelle vous voulez sauver l'enregistrement. Sélectionnez un répertoire et appuyez sur "Ok" pour terminer l'enregistrement.

#### "Charger"

Ce bouton vous demandera un emplacement pour rechercher une entrée CDDB autre qu'un serveur CDDB distant ou les entrées CDDB dans le système de fichiers.

Le bouton "Fermer" ferme l'éditeur de base de données CDDB.

## Support de CDDB

La Compact Disc Data Base est une base de données réseau distribuée accessible sur Internet, qui contient des informations sur la plupart des CDs audio en circulation. Si vous avez un accès Internet, vous souhaiterez probablement ne jamais devoir entrer manuellement les informations sur les pistes de vos CDs si tout est configuré correctement. Voir la sous-section "Onglet CDDB" dans "Configuration de kscd" pour des instructions sur comment configurer ce service et "L'éditeur de base de données CDDB" pour des instructions sur comment modifier des entrées CDDB.

L'utilisation de CDDB est libre. Les contributions des utilisateurs sont encouragées.

Quand vous préparez des entrées pour la CDDB, gardez les points suivants à l'esprit :

- Utiliser des caractères "latin standard" dans les entrées. Certains caractères spéciaux sont acceptés mais les contributions utilisant l'alphabet Cyrillique ou Grec ne le sont pas.

- Utiliser uniquement un caractère "/" dans le champ "Disque Artiste / Titre" dans "L'éditeur de base de données de CD". Pour les CDs classiques, il est courant de mettre le nom du compositeur dans la section Artiste (avant le slash) et le nom de l'interprète dans la section Titre (après le slash).

- Si vous envoyez une entrée qui existe déjà dans la base de données, les informations supplémentaires que vous aurez fournies pourront etre ajoutées à l'entrée existante.

Par défaut, kscd installe les catégories CDDB standard dans `$KDEDIR/share/apps/kscd/cddb`. Vous pouvez créer autant de sous-répertoires catégorie que vous le souhaitez. Cependant, lors de l'envoi d'une contribution seules les catégories officielles CDDB seront affichées. L'adresse d'envoi par défaut est "xmcd-cddb@amb.org". Pour plus d'informations sur CDDB, consultez la page web CDDB.

L'entrée CDDB locale pour un CD donné est stockée dans le fichier `<category name>/<disc ID>` sous le "Répertoire de base de CDDB". Ces fichiers peuvent être modifiés avec n'importe quel éditeur de texte si vous n'avez rien de mieux à faire pendant votre temps libre.

## Questions et réponses

### Q. J'obtiens la boîte de dialogue "Erreur d'accès ou de lecture du CDROM" quand je lance kscd. Qu'est-ce qui ne va pas ?

A. Ceci signifie que kscd ne réussit pas à accéder à votre lecteur CDROM. Le nom du périphérique dans le champ 'Périphérique CDROM' de la "Configuration de kscd" doit faire référence au périphérique bloc associé à votre lecteur CD-ROM. Ce sera souvent un lien vers le périphérique IDE (`/dev/hdx`) ou SCSI (`/dev/sdx`) approprié. Le fichier de périphérique appartient normalement à l'utilisateur root du groupe root, et n'autorise pas les utilisateurs normaux à l'ouvrir en lecture, écriture ou exécution directement. Cela n'a *rien* à voir avec la commande `mount` SUID (Les programmes Set User ID utilisent le `setuid()` de la bibliothèque standard Unix pour s'approprier l'identité d'un autre utilisateur) , qui ne pose pas de problème avec les permissions ; kscd doit être capable d'obtenir un descripteur de fichier en lecture seule faisant référence au périphérique CD, pour contrôler le lecteur CDROM et lire les données bas niveau du disque.

Si vous possédez le mot de passe root, vous pouvez résoudre ceci rapidement et facilement. Devenez root et tapez la commande `chmod a+r /dev/cdrom` pour permettre à tous les utilisateurs de votre système de lire à partir de `/dev/cdrom`. Si votre lecteur de CDROM est nommé différemment, modifiez les privilèges de ce périphérique avec la même procédure. Si vous n'avez pas le mot de passe root, demandez gentiment à votre administrateur système de vous donner la permission de lecture pour le périphérique CDROM.

Voir aussi la section "Configuration de kscd".

### Q. Impossible d'utiliser CDDB. Comment obtenir des informations détaillées sur ce qui ne fonctionne pas ?

A. Si vous rencontrez des problèmes avec les fonctionnalités de la CDDB, essayez de lancer kscd à partir de la ligne de commande avec le paramètre `-d` et surveillez la sortie de déboguage.

## Epilogue

### Remerciements

Merci à Ti Kan et Steve Scherf, les inventeurs du concept de base de données CDDB. Visitez www.cddb.com pour plus d'informations sur CDDB.

Merci aussi à Paul Harrison pour avoir écrit Synaesthesia sur lequel KSCD Magic est basé.

Un remerciement spécial pour David White qui a écrit la documentation d'aide de KSCD. Bon travail David !

### Développeurs

`Bernd Johannes Wuebben - Auteur et mainteneur`

### Auteurs

`Bernd Johannes Wuebben - Premier brouillon`

`David White - Rédacteur`

`Francois-Xavier Duranceau - Traducteur`

### Copyright

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

    kscd contient du code provenant de :
    workman 1.4 beta 3 Copyright (c) Steven Grimm koreth@hyperion.com

    Ce programme est libre, vous pouvez le redistribuer et/ou le modifier selon les termes de la
    Licence Publique Générale GNU publiée par la Free Software Foundation (version 2 ou bien toute
    autre version ultérieure).

    Ce programme est distribué car potentiellement utile, mais SANS AUCUNE GARANTIE, ni explicite
    ni implicite, y compris les garanties de commercialisation ou d'adaptation dans un but
    spécifique. Reportez-vous à la Licence Publique Générale GNU pour plus de détails.

    Vous devez avoir reçu une copie de la Licence Publique Générale GNU en même temps que ce
    programme ; si ce n'est pas le cas, écrivez à la Free Software Foundation, Inc., 675 Mass Ave, Cambridge, MA 02139, États-Unis.