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

    vampyr@atconnex.net

Relecture
Ludovic
Grossard

    ludovic.grossard@libertysurf.fr

Traduction française
Patrick
Chavas

    pachavas@sun.cpe.fr

Relecture française
2000-2001
J Singer
&FDLNotice;
2001-07-19
1.03.02

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

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

Panneau de commande principal
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 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 entrées 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 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 Éditeur de Base de données de &CD; pour plus de détails sur l'utilisation de cet outil.

#### Bouton d'information

Bouton d'information
Bouton d'information

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.

- freedb

- Configuration de SMTP

- Options de Kscd

- À propos

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

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

La liste Serveur freedb affiche une liste de serveurs freedb 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. Appuyez sur le bouton Par défaut pour saisir 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 listés sur le site freedb principal freedb.freedb.org. Cliquez sur le bouton - pour supprimer l'entrée sélectionnée de la liste.

Le champ Envoyer les contributions freedb à : contient l'adresse électronique pour soumettre des entrées CDDB. L'adresse par défaut est freedb-submit@freedb.org. Depuis la version 0.8, les entrées CDDB provenant de &kscd; sont acceptées pour inclusion dans la base de données. Cliquez sur le bouton - pour supprimer l'entrée sélectionnée 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).

OK enregistre les réglages par défaut, puis quitte la fenêtre de configuration ; Annuler permet de sortir sans enregistrer les modifications.

### L'onglet Configuration SMTP

L'onglet Configuration SMTP

L'onglet Configuration SMTP permet de configurer une connexion avec un serveur de courrier électronique afin de soumettre de nouvelles entrées CDDB. Ceci est utile si votre système n'est pas configuré comme serveur. Cochez Activer l'envoi via SMTP pour utiliser cette caractéristique. Entrez l'adresse du serveur SMTP dans la zone de texte en haut à gauche et le numéro du port (typiquement `25`) dans la zone de texte en haut à droite. Entrez votre adresse électronique dans la zone de texte située en dessous.

### L'onglet Options du lecteur CD

L'onglet Options du lecteur CD
L'onglet Options du lecteur CD

Les champs Couleur des diodes : et Couleur du fond : 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.

Le champ Périphérique CDROM contient le nom du périphérique &CD-ROM; à utiliser pour lire les CD 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 &konqueror;.

Le champ Commande de mail affiche la commande utilisée pour envoyer de nouvelles entrées CDDB à la base de données. La valeur par défaut est ``mail` `-s %s``. Vous devrez vous assurer que cette commande envoie des courriers à des systèmes non locaux si vous voulez soumettre des entrées CDDB, spécialement si vous accédez à l'Internet par une connexion avec numérotation (modem). Consultez la documentation de votre distribution Linux pour plus de détails. Quelques distributions Linux qui utilisent sendmail pour délivrer les courriers électroniques nécessitent seulement que vous saisissiez votre hôte de courrier dans le champ "Smart" relay host du fichier `/etc/sendmail.cf`. De plus, le site CDDB voudra être capable de vous répondre par courier électronique ; il pourrait donc être nécessaire d'éditer `/etc/sendmail.cf` pour vous assurer que l'adresse de retour de la soumission est valide. Adaptez selon vos besoins. Si rien ne fonctionne, utilisez SMTP à la place.

La section Navigateur WWW 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 &konqueror; soit un navigateur personnalisé . Par défaut, le champ Utiliser un navigateur personnalisé contient ``kfmclient` `openURL %s``.

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

Placer sur le tableau de bord fait apparaître un contrôle de &kscd; dans le panneau &kicker;.

Lecture dès la fermeture de la trappe permet de débuter la lecture du &CD; à la fermeture de la trappe, sans avoir besoin de cliquer sur le bouton Lecture.

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

Éjecter à la fin éjecte le &CD; lorsque sa lecture se termine.

Lecture aléatoire sans répétition signifie que lorsque Lecture aléatoire est utilisé, chaque piste n'est lue qu'une fois.

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 ; Annuler permet de sortir sans enregistrer les modifications.

### L'onglet À propos

L'onglet À 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 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 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 freedb, vous verrez apparaître le nom de l'artiste et le titre du &CD; dans le champ Artiste / Titre et une liste de pistes avec les titres des chansons dans la liste de sélection Piste / Durée / Titre. 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 Info suppl., situé après le champ Artiste / Titre, ou pour la piste sélectionnée dans la liste Piste / Temps / Titre avec le bouton Info suppl. adjacent. 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 Édition 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.

Une fois que le titre de chaque piste a été donné et que le champ Artiste / Titre a été rempli, 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 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 freedb de l'onglet CDDB de la fenêtre de configuration de &kscd;.

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

L'Éditeur de liste de lecture 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.

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

Le bouton Charger vous demandera un emplacement pour rechercher une entrée CDDB autre qu'un serveur freedb distant ou que celles présentes dans le système de fichiers. Le bouton Fermer ferme l'éditeur de base de données 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 le system tray du tableau de bord. Si aucune applet n'apparaît lorsque &kscd; est minimisé, vous avez sans doute enlevé le tray. Pour le remettre, cliquez avec le bouton droit de la souris sur une zone vide du tableau de bord et sélectionnez Ajouter Applet System Tray

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

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

- 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 entrée qui existe déjà dans la base de données, les informations supplémentaires que vous aurez fourni pourront être 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 freedb-submit@freedb.org.Pour plus d'informations sur freedb, consultez sa page web.

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

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 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 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 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 &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 de la documentation pour KDE 2.0 par Ludovic Grossard ludovic.grossard@libertysurf.fr

Relecture de la documentation pour KDE 2.0 par Patrick Chavas pachavas@sun.cpe.fr

&underFDL; &underGPL;

## Installation

### Comment obtenir &kscd;

&kscd; fait partie du Projet KDE. Il se situe dans le paquetage kdemultimedia à ftp://ftp.kde.org/pub/kde/, le site ftp principal du projet KDE.

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

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
    Puis en root :
    % make
    install

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

&documentation.index;