# Manuel de &kscd;

Jonathan Singer

    jsinger@leeta.net

David White

    a9403784@unet.univie.ac.at

Bernd Johannes Wuebben

    wuebben@kde.org

Développeur
Dirk Forsterling

    milliByte@gmx.net

Développeur
Dirk Foersterling

    milliByte@gmx.net

Développeur
Lauri Watts

    lauri@kde.org

Relecture
&traducteurLudovicGrossard; &relecteurPatrickChavas;
2000 2004 J Singer
&FDLNotice;
2002-10-07
1.4

&kscd; est un lecteur de CD rapide pour les plates-formes UNIX et permettant l'accès à CDDB.

KDE kdemultimedia kscd musique CD audio

## Introduction

&kscd; est un lecteur de &CD; rapide pour les plates-formes UNIX 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

### plates-formes reconnues

&kscd; fonctionne sur les plates-formes suivantes :

- Linux

- FreeBSD

- NetBSD

- BSD386

- Sun

- Solaris (incluant le support de cdda)

- &HP-UX;

- &SGI; Irix (incluant le support de cdda)

- Sony NEWS

- OSF/1

- Ultrix

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

## Commandes principales

### Opérations de base

L'interface de &kscd;
L'interface de &kscd;

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 panneau de contrôle
Panneau de commande principal

C'est le panneau de contrôle principal de &kscd; 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 éjecte le &CD;. Les deux boutons de la troisième ligne permettent d'avancer (à droite) ou de reculer (à gauche) directement au début de la piste suivante ou précédente. Le bouton de gauche dans la ligne du bas permet d'activer la lecture aléatoire, et le bouton de droite active ou désactive la lecture en boucle, de façon que le &CD; soit lu de nouveau depuis le début lorsque la dernière piste audio est atteinte.

#### Affichage de l'état

Affichage de l'état
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 descriptions appropriées existent dans la CDDB locale ou réseau (&CD; Data Base).

Cliquer sur l'affichage du temps permet de basculer entre les différents modes d'affichage du temps. 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 si le &CD; n'est pas lu. Cliquer sur l'affichage 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

Le bouton Extras
Le bouton Extras

Ce bouton fait apparaître un menu avec un certain nombre d'options. Vous pouvez choisir d'ouvrir le panneau de configuration de &kscd; ou de configurer les raccourcis clavier. Ces options vous permettent de configurer &kscd; pour qu'il fonctionne exactement comme vous le voulez. Voir la section Configuration de &kscd; pour plus de détails sur la configuration de &kscd;.

Ce menu fournit plusieurs outils afin de vous aider dans la recherche d'informations sur l'artiste sur Internet. 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.

Ce menu vous permet aussi d'ouvrir cette documentation, de faire un rapport de bogue, d'en savoir plus sur &kscd; et &kde; et de quitter &kscd;.

#### Bouton CDDB

Bouton CDDB
Bouton CDDB

Ce bouton ouvre le panneau d'édition des descriptions 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 Éditeur de Base de données de &CD; pour plus de détails sur l'utilisation de cet outil.

#### Bouton de volume

Bouton de volume
Glissière de volume

Ce bouton fait apparaître un curseur qui 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

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

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

## Configuration de &kscd;

### Fenêtre de configuration principale

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

- Lecteur CD

- Recherche Freedb

- Soumission Freedb

### L'onglet Lecteur CD

L'onglet Lecteur CD
L'onglet Configuration de KSCD

Les champs Couleur du texte et Couleur du fond montrent la couleur sélectionnée pour le texte et l'arrière-plan de l'afficheur d'état. Appuyez sur les barres de couleurs pour modifier ces couleurs.

Afficher l'icône dans le tableau de bord fait apparaître l'icône de &kscd; dans le panneau &kicker;.

Réglez la champ Avancer par pas de sur le nombre de secondes utilisé pour avancer ou reculer lorsqu'on appuie sur les boutons Avancer ou Reculer du panneau de contrôle.

Lecture automatique à l'insertion du CD permet de débuter la lecture du &CD; à la fermeture de la trappe, sans avoir besoin de cliquer sur le bouton Lecture/Pause.

Éjecter le CD lorsque la lecture est terminée éjecte le &CD; lorsque sa lecture se termine.

Arrêter la lecture à la sortie stoppe la lecture du &CD; lorsque vous quittez &kscd;.

Le champ Périphérique CDROM : contient le nom du périphérique &CD-ROM; à utiliser pour lire les &CD;s 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 superutilisateur et peut être effectuée à partir d'une ligne de commande ou dans le mode superutilisateur de &konqueror;.

Le bouton Aide ouvre la page d'aide de &kscd; ; OK enregistre les réglages par défaut, puis quitte la fenêtre de configuration ; Appliquer enregistre les réglages courants sans sortir ; Annuler permet de sortir sans enregistrer les modifications.

### L'onglet freedb

L'onglet freedb de la boîte de dialogue de configuration
L'onglet freedb de la boîte de dialogue de configuration

L'onglet freedb définit les fonctions CDDB de &kscd;.

L'option Mode détermine comment les recherches CDDB sont réalisées. En choisissant Cache uniquement, seules les informations présentes sur votre ordinateur seront utilisées. Cache et distant permet de rechercher des informations que vous n'avez pas encore, tandis que les informations sont systématiquement recherchées sur inter avec Distant uniquement. Le temps au bout duquel la recherche prend fin peut être réglé.

La liste déroulante Serveur CDDB : vous permet de spécifier votre serveur freedb. Saisissez l'adresse du serveur et le numéro du port. Choisissez un élément dans la liste et il apparaîtra dans la zone de texte au-dessus de la boîte de sélection. Le type de connexion (CDDB ou HTTP) peut également être réglé (il est peu probable que vous ayez à modifier les réglages par défaut). Le champ de texte Dossier de cache vous permet de choisir le dossier où vous voulez placer localement les éléments CDDB.

### L'onglet freedb

L'onglet freedb

L'onglet freedb permet de régler la connexion à un serveur de courrier pour soumettre de nouvelles entrées CDDB. Ceci est utile si votre système n'est pas configuré comme serveur. Cochez Permettre les soumissions par SMTP pour utiliser cette caractéristique.

Vous pouvez si vous le souhaitez utiliser l'adresse électronique depuis le centre de configuration. Si vous voulez ouvrir le module du ¢reConfiguration; pour configurer cette adresse électronique, cliquz sur le texte Ouvrir le panneau de contrôle du courrier électronique. Si vous modifiez l'adresse ici, l'adresse par défaut de toutes les applications &kde; sera modifiée, pas simplement pour &kscd;, donc faites attention.

Autrement, donnez votre profil de courrier électronique dans la boîte de saisie Utiliser les adresses électroniques suivantes. Saisissez votre adresse électronique, une adresse de réponse et, si vous le souhaitez, l'adresse du serveur SMTP dans la zone de texte nommée Hôte :. Vous pouvez également fournir un nom d'utilisateur pour l'autentification, et le numéro du port (en général `25`) dans la zone de texte nommée Port :.

Le bouton Aide ouvre la page d'aide de &kscd; ; OK enregistre les réglages par défaut, puis quitte la fenêtre de configuration ; Appliquer enregistre les réglages courants sans sortir ; Annuler permet de sortir sans enregistrer les modifications.

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

L'éditeur de base de données CDDB
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 descriptions CDDB (Compact Disc Data Base).

S'il y a une description dans votre arborescence CDDB locale (voir la sous-section CDDB dans le chapitre sur la configuration de &kscd;) pour le &CD; dans votre lecteur de &CD-ROM;, ou si le disque peut être trouvé dans freedb, vous verrez apparaître le nom de l'artiste et le titre du &CD; dans les champs Artiste et Titre ainsi qu'une liste de pistes avec les titres des chansons dans la liste de sélection des Pistes. Autrement, vous verrez une liste de pistes et de durées sans titres.

Vous pouvez créer une annotation pour le disque entier avec le bouton Commentaire, situé sous le champ Titre, ou pour la piste sélectionnée dans la liste des Pistes avec le bouton Commentaire adjacent. Si vous sélectionnez une piste dans la liste de sélection des Pistes, le titre, s'il est présent, apparaîtra dans le champ Titre en dessous. Vous pouvez saisir un titre pour la piste dans la zone de texte ou modifier la piste 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.

Une fois que le titre de chaque piste a été donné et que le champ Artiste et Titre ont été remplis, vous pouvez appuyer sur le bouton Envoyer pour envoyer votre contribution par courrier électronique à freedb.

Vous devrez choisir une catégorie pour la contribution. La section Disc ID affiche le code ID 32 bit utilisé par freedb pour identifier un compact disc. Au-dessus du code ID se trouve la catégorie de la description CDDB. Ces catégories correspondent à l'arborescence de sous-dossiers du dossier défini dans le Dossier de base de freedb de l'onglet freedb de la fenêtre de configuration de &kscd;.

L'affichage Durée totale : montre la durée de lecture totale du &CD;.

Appuyez sur le bouton Charger les infos pour télécharger les données CDDB. Appuyez sur le bouton OK pour enregistrer les changements sur votre machine. Le bouton Annuler ferme l'éditeur de base de données de &CD;s sans enregistrer.

## Utilisation de &kscd; dans le tableau de bord de &kde;

Utilisation de &kscd; dans le tableau de bord de &kde;
Utilisation de &kscd; dans le tableau de bord de &kde;

Lorsque Afficher la miniature dans la boîte à miniatures est coché, une petite applet &kscd; est affichée dans le tableau de bord de KDE. Contrairement à la fenêtre principale de &kscd;, cette applet est disponible sur tous les bureaux. Cliquez avec le bouton droit de la souris sur l'applet pour afficher un menu surgissant permettant de contrôler la lecture du &CD;. Cliquez avec le bouton gauche de la souris pour retrouver la fenêtre principale de &kscd;. Si cette fenêtre principale est minimisée, un clic gauche sur l'applet la restaurera.

Pour être précis, l'applet est affichée dans la boîte à icônesdu tableau de bord. Si aucune applet n'apparaît lorsque &kscd; est minimisé, vous avez sans doute enlevé la boîte à icônes. Pour la remettre, cliquez avec le bouton droit de la souris sur une zone vide du tableau de bord et sélectionnez Ajouter Applet Boîte à icônes

## Support de CDDB

freedb est une base de données réseau distribuée accessible sur Internet, qui contient des informations sur la plupart des &CD; audio en circulation. Si vous avez un accès Internet, vous n'aurez probablement jamais à saisir manuellement les informations sur les pistes de vos &CD; si tout est configuré correctement. Voir la sous-section "Onglet freedb" dans le chapitre «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 descriptions CDDB.

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

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

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

- Utilisez uniquement un caractère / dans le champ Artiste / Titre dans l'éditeur de base de données de &CD;.

  Pour les &CD; 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 description qui existe déjà dans la base de données, les informations supplémentaires que vous aurez fournies pourront être ajoutées à la description existante.

Par défaut, &kscd; installe les catégories CDDB standard dans `$KDEDIR/share/apps/kscd/cddb`. Vous pouvez créer autant de sous-dossiers de catégories 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 freedb-submit@freedb.org. Pour plus d'informations, consultez la page web de freedb.

La description CDDB locale pour un &CD; donné est stockée dans le fichier `category name/disc ID` sous le dossier 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

J'obtiens cette boîte de dialogue quand je lance &kscd;. Qu'est-ce qui ne va pas ?

Boîte de dialogue d'erreur
Boîte de dialogue d'erreur

Ceci signifie que &kscd; ne réussit pas à accéder à votre lecteur &CD-ROM;. Le nom du périphérique dans le champ Périphérique &CD-ROM; 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 SUID `mount` (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 &CD-ROM; 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 saisissez 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 &CD-ROM; 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 &CD-ROM;.

Voir aussi le chapitre Configuration de KSCD.

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

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.

## Remerciements et licence

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

&kscd; contient du code de :

- workman 1.4 beta 3 Copyright (c) Steven Grimm koreth@hyperion.com

Remerciements spéciaux à Ti Kan et Steve Scherf, les inventeurs du concept de la base de données CDDB. Visitez http://ww.cddb.com pour de plus amples informations sur CDDB.

Remerciements tout particulièrement à David White qui a écrit la documentation de &kscd;. Bon travail David !

Mise à jour de la documentation pour KDE 2.0, et copyright par Jonathan Singer jsinger@leeta.net.

Traduction française par &LudovicGrossard;.

Relecture de la documentation française par &PatrickChavas;.

&underFDL; &underGPL;

## Installation

### Comment obtenir &kscd;

&install.intro.documentation;

### 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 depuis le site &FTP; de &kde; ftp://ftp.kde.org/pub/kde/.

### Compilation et installation

&install.compile.documentation;

Si possible, informez le mainteneur actuel, Dirk Foersterling, à l'adresse milliByte@gmlx.net les modifications que vous avez dû effectuer pour réussir à compiler KSCD sur votre plate-forme.

&documentation.index;