# 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
2002
J Singer
&FDLNotice;
2002-10-07
1.03.03

&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 commandes principal

Panneau de commandes principal
Panneau de commandes 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 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

Bouton d'éjection
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

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

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

Bouton de sélection du mode d'affichage
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

Bouton de configuration
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 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 d'informations

Bouton d'informations
Bouton d'informations

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

Bouton de fermeture
Bouton de fermeture

Ce bouton ferme &kscd;.

#### Glissière de volume

Glissière de volume
Glissière de volume

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.

#### Bouton de lecture aléatoire

Bouton de lecture aléatoire
Bouton de lecture aléatoire

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

#### 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 quatre sections principales.

- Lecteur CD

- freedb

- SMTP

- Remerciements

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

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.

La case à cocher Afficher les bulles d'aide active ou désactive les bulles d'aide (de petites fenêtres qui apparaissent quand la souris reste un court instant sur un élément actif de l'interface graphique).

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

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

Vous pouvez choisir comment la lecture aléatoire fonctionne en utilisant deux options qui devraient ne pas nécessiter d'explications : Ordre aléatoire et lire chaque morceau une seule fois et Sélectionner les morceaux de manière aléatoire (avec répétitions possibles).

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

La case à cocher Activer la freedb distante active ou désactive les recherches de CDDB à travers l'Internet. Vous pouvez régler le temps au bout duquel la recherche est abandonnée en cas d'échec. Pour utiliser un proxy &HTTP;, cochez Utiliser un proxy HTTP pour accéder à freedb et saisissez une &URL; dans le champ situé en dessous.

Lorsque la case Active l'enregistrement automatique dans la base de données locale est cochée, les informations CDDB seront enregistrées localement, ce qui vous évite d'avoir à effectuer régulièrement des recherches sur Internet. La zone de texte Dossier de base freedb vous permet de choisir le dossier où vous voulez stocker localement vos descriptions CDDB.

La liste Serveur freedb affiche une liste de serveurs freedb connus. Sélectionnez un élément dans la liste et il apparaîtra dans la zone de texte au-dessus de la liste de sélection. Appuyez sur le bouton Actualiser pour mettre à jour la liste des serveurs. Appuyez sur le bouton Par défaut pour prendre la valeur par défaut, `freedb.freedb.org 888 -`, qui vous permettra de rafraîchir la liste avec une liste récente de serveurs freedb inventoriés sur le site freedb principal freedb.freedb.org. Les serveurs peuvent également être ajoutés à la main en saisissant leur adresse dans la zone du dessus puis en appuyant sur le bouton +. Appuyez sur le bouton - pour supprimer l'élément sélectionné de la liste.

Le champ Envoyer les contributions freedb à : contient l'adresse électronique pour soumettre des descriptions CDDB. L'adresse par défaut est freedb-submit@freedb.org. Depuis la version 0.8, les descriptions CDDB provenant de &kscd; sont acceptées pour inclusion dans la base de données. Ajoutez les serveurs manuellement en saisissant leur adresse dans la zone du dessus puis en appuyant sur le bouton +. Appuyez sur le bouton - pour supprimer l'élément sélectionné de la liste. Le bouton Par défaut restaure tous les réglages par défaut. Le bouton Aide ouvre la page d'aide de &kscd; (ce document).

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 SMTP

L'onglet SMTP

L'onglet SMTP permet de configurer une connexion avec un serveur de courrier électronique afin de soumettre de nouvelles descriptions CDDB. Ceci est utile si votre système n'est pas configuré comme serveur. Cochez Activer l'envoi via SMTP. Sélectionnez votre profil de courrier électronique dans la boîte de saisie Profil de courrier électronique actuel. Saisissez l'adresse du serveur SMTP dans la zone de texte nommée Hôte et le numéro du port (en général `25`) dans la zone de texte nommée Port .

Vous pouvez si vous le souhaitez utiliser l'adresse électronique depuis le centre de configuration. Si vous voulez ouvrir le module du &centreConfiguration; 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.

Si vous ne souhaitez pas utiliser l'adresse électronique configurée globalement, choisissez l'option étiquetée Utiliser l'adresse électronique suivante et saisissez une autre adresse électronique ou un adresse de réponse dans les champs au-dessous.

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 Remerciements

L'onglet Remerciements affiche des informations sur version de &kscd; que vous utilisez ainsi que des informations de copyright.

## 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 Placer sur le tableau de bord 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;