.\" Process this file with
.\" groff -man -Tascii ogg123.1
.\"
.\"*******************************************************************
.\"
.\" This file was generated with po4a. Translate the source file.
.\"
.\"*******************************************************************
.TH ogg123 1 "24 mars 2010" "Fondation Xiph.Org" "Outils Vorbis"

.SH NOM
ogg123 –\ Écoute des fichiers Ogg et FLAC

.SH SYNOPSIS
\fBogg123\fP [ \fB\-vqrzZVh\fP ] [ \fB\-k\fP \fIsecondes\fP ] [ \fB\-x\fP \fInième\fP ] [ \fB\-y\fP
\fIn_fois\fP ] [ \fB\-b\fP \fItaille_tampon\fP ] [ \fB\-d\fP \fIpilote\fP [ \fB\-o\fP
\fIoption:valeur\fP ] [ \fB\-f\fP \fInom_fichier\fP ] ] \fIfichier\fP \fI...\fP |
\fIrépertoire\fP \fI...\fP | \fIURL\fP \fI...\fP

.SH DESCRIPTION
\fBogg123\fP lit les fichiers audio Ogg/Vorbis, Ogg/Speex, Ogg/Opus, Ogg/FLAC
et ceux FLAC natifs, et les décode sur les périphériques spécifiés sur la
ligne de commande. Par défaut, \fBogg123\fP écrit sur le périphérique son
standard, mais peut écrire sur n’importe quel nombre de périphériques. Les
fichiers peuvent être lus sur le système de fichiers ou à partir d’URL,
diffusés à travers HTTP. Si un répertoire est indiqué, tous ses fichiers et
ceux de ses sous\-répertoires seront joués.

.SH OPTIONS
.IP "\fB\-\-audio\-buffer\fP \fIn\fP"
Utiliser un tampon de sortie audio d’approximativement \fIn\fP\ kilooctets
.IP "\fB\-@\fP \fIliste_lectures\fP, \fB\-\-list\fP \fIliste_lectures\fP"
Jouer tous les fichiers indiqués dans le fichier \fIliste_lectures\fP. La liste
de lecture doit avoir un nom de fichier, un nom de répertoire ou un URL par
ligne. Les lignes blanches sont autorisées. Les répertoires sont traités de
la même manière que ceux sur la ligne de commande.
.IP "\fB\-b\fP \fIn\fP, \fB\-\-buffer\fP \fIn\fP"
Utiliser un tampon d’entrée d’approximativement \fIn\fP\ kilooctets. Option
valable uniquement pour HTTP.
.IP "\fB\-p\fP \fIn\fP, \fB\-\-prebuffer\fP \fIn\fP"
Précharger le tampon d’entrée à \fIn\fP\ pour cent. L’écoute ne commencera
qu’une fois ce préchargement réalisé. Option valable uniquement pour HTTP.
.IP "\fB\-d\fP \fIpériphérique\fP, \fB\-\-device\fP \fIpériphérique\fP"
Spécifier le périphérique de sortie. Consulter la section PÉRIPHÉRIQUES pour
une liste de périphériques. N’importe quel nombre de périphériques peut être
spécifié.
.IP "\fB\-f\fP \fInom_fichier\fP, \fI\-\-file\fP \fInom_fichier\fP"
Spécifier le fichier de sortie pour un périphérique de fichier précédemment
spécifié avec l’option \fB\-\-device\fP. Le nom de fichier «\ \-\ » écrit sur la
sortie standard. Si le fichier existe déjà, il sera écrasé.
.IP "\fB\-h\fP, \fB\-\-help\fP"
Afficher une description des commandes
.IP "\fB\-k\fP \fIn\fP, \fB\-\-skip\fP \fIn\fP"
Sauter les \fIn\fP premières secondes. \fIn\fP peut être sous la forme
minutes:secondes ou heures:minutes:secondes.
.IP "\fB\-K\fP \fIn\fP, \fB\-\-end\fP \fIn\fP"
Arrêter la lecture \fIn\fP secondes après le début du flux. \fIn\fP peut être du
même format que l’option \fI\-\-skip\fP.
.IP "\fB\-o\fP \fIoption\fP[\fI:valeur\fP], \fB\-\-device\-option\fP \fIoption\fP[\fI:valeur\fP]"
Définir l’\fIoption\fP à \fIvaleur\fP pour le périphérique précédent. Consulter
PÉRIPHÉRIQUES pour une liste des options valables pour chaque périphérique.
.IP "\fB\-q\fP, \fB\-\-quiet\fP"
Mode silencieux. Aucun message n’est affiché.
.IP "\fB\-V\fP, \fB\-\-version\fP"
Afficher les informations de version.
.IP "\fB\-v\fP, \fB\-\-verbose\fP"
Augmenter le niveau de détail
.IP "\fB\-x\fP \fIn\fP, \fB\-\-nth\fP \fIn\fP"
Lire chaque \fIn\fPième bloc décodé. Cela a pour effet de jouer l’audio \fIn\fP\ fois plus vite que la vitesse normale.
.IP "\fB\-y\fP \fIn\fP, \fB\-\-ntimes\fP \fIn\fP"
Répéter chaque \fIn\fPième bloc joué. Cela pour effet de jouer l’audio \fIn\fP\ fois plus lentement que la vitesse normale. Cette option peut être spécifiée
avec l’option\ \fI\-x\fP pour des vitesses fractionnaires intéressantes.
.IP "\fB\-r\fP, \fB\-\-repeat\fP"
Répéter la liste de lecture indéfiniment.
.IP "\fB\-z\fP, \fB\-\-shuffle\fP"
Jouer les fichiers dans un ordre pseudo\-aléatoire.
.IP "\fB\-Z\fP, \fB\-\-random\fP"
Jouer éternellement les fichiers dans un ordre pseudo\-aléatoire.

.SH PÉRIPHÉRIQUES

\fBogg123\fP prend en charge divers périphériques de sortie audio à travers
\fBlibao\fP. Seuls les périphériques pris en charge par la plateforme cible
seront disponibles. L’option\ \fB\-f\fP ne peut être utilisée que par les
périphériques écrivant dans un fichier.

Options prises en charge par tous les périphériques\ :
.RS
.IP \fIdebug\fP
Activer la sortie de débogage (si disponible) pour le pilote choisi.
.IP \fImatrix:valeur\fP
Forcer un ordre spécifique de canaux de sortie pour un périphérique
donné. \fIvaleur\fP est une liste de noms de canal de style AO séparés par des
virgules, par exemple, L,R,C,LFE,BL,BR,SL,SR.
.IP \fIverbose\fP
Activer une sortie prolixe pour le pilote indiqué. L’option \fB\-v\fP active
aussi l’option de prolixité du pilote.
.IP \fIquiet\fP
Forcer le pilote indiqué à être complètement silencieux. Même les erreurs ne
produiront aucun message. L’option \fB\-q\fP active l’option silence du pilote.
.RE

.IP \fBaixs\fP
Pilote de sortie directe d’AIX. Options\ :
.RS
.IP \fIdev:valeur\fP
Définir le périphérique de sortie d’AIX à \fIvaleur\fP.
.RE

.IP \fBalsa\fP
Pilote de sortie directe de Advanced Linux Sound Architecture. Options\ :
.RS
.IP \fIbuffer_time:valeur\fP
Cette valeur écrase la durée du tampon matériel par défaut (en
millisecondes).
.IP \fIdev:valeur\fP
Étiquette du périphérique ALSA à utiliser. Par exemple, inclure «\ hw:0\ »
pour la première carte son et «\ hw:1\ » pour la seconde. Le pilote alsa
choisit automatiquement par défaut une des valeurs «\ surround71\ », «\ surround51\ », «\ surround40\ » ou «\ default\ » selon le nombre de canaux
de sortie. Pour plus d’informations, consulter
http://alsa.opensrc.org/ALSA+device+labels
.IP \fIperiod_time:valeur\fP
Cette valeur écrase la durée de la période matérielle (en microsecondes).
.IP \fIperiod_time:valeur\fP
Cette valeur écrase la durée de la période matérielle (en microsecondes).
.IP \fIuse_mmap:valeur\fP
\fIvaleur\fP est définie à «\ yes\ » ou «\ no\ » pour outrepasser les valeurs
par défaut internes pour utiliser ou non l’accès au périphérique
\fBmmap\fP(2). Précédemment, quelques pilotes alsa bogués se comportaient mieux
en n’utilisant pas l’accès \fBmmap\fP au prix d’une utilisation légèrement
supérieure du CPU.
.RE

.IP \fBarts\fP
Pilote de sortie directe d’aRts Sound Daemon. Options\ :
.RS
.IP \fImulti:valeur\fP
\fIvaleur\fP est défini à «\ yes\ » ou «\ no\ » pour permettre l’ouverture du
périphérique de lecture d’aRts pour plusieurs lectures simultanées. Bien que
le pilote fonctionne correctement en mode multi, il est de notoriété qu’il
plante occasionnellement le serveur d’aRts lui\-même. La valeur par défaut
est «\ no\ ».
.RE

.IP \fBau\fP
Sortie de fichier audio de Sun. Les échantillons audio sont écrits au format
AU (Audio Unit). Le format AU gère l’écriture sur des fichiers non
parcourables tels que la sortie standard. Dans de tels cas, l’entête AU
spécifie le format d’échantillonnage, mais pas la durée de l’entête.

.IP \fBesd\fP
Sortie directe de Enlightened Sound Daemon. Options\ :
.RS
.IP \fIhost:valeur\fP
\fIvaleur\fP spécifie le nom d’hôte où ESD est en cours d’exécution. Cela peut
inclure un numéro de port après un deux\-points, comme «\ whizbang.com:555\ »
(par défaut localhost).
.IP \fIclient_name:valeur\fP
Définir le nom du client pour le nouveau flux audio, par défaut «\ libao\ ».
.RE

.IP \fBirix\fP
Pilote de sortie audio directe pour IRIX.

.IP \fBmacosx\fP
Pilote de sortie audio directe «\ AUHA\ » de MacOS\ »X. Ce pilote est pris
en charge par MacOS\ X\ 10.5 et suivants (les version\ 10.4 utilisaient une
précédente interface non compatible). Options\ :
.RS
.IP \fIbuffer_time:valeur\fP
Définir la taille du tampon matériel à l’équivalent de \fIvaleur\fP
millisecondes.
.RE

.IP \fBnas\fP
Pilote de sortie directe pour Network Audio Server. Options\ :
.RS
.IP \fIbuf_size:valeur\fP
Définir la taille du tampon audio en octets sur le serveur.
.IP \fIhost:valeur\fP
Définir l’emplacement du serveur NAS\ ; consulter \fBnas\fP(1) pour le format.
.RE

.IP \fBnull\fP
Pilote Null. Toutes les données audio sont supprimées (remarque\ : les
données audio ne sont pas écrites sur \fI/dev/null\fP\ !). Ce pilote peut être
utilisé pour tester la vitesse de décodage \fIraw\fP sans surcharge de la
sortie.

.IP \fBoss\fP
Pilote d’Open Sound System pour Linux et FreeBSD, versions 2, 3 et\ 4. Options\ :
.RS
.IP \fIdsp:valeur\fP
Périphérique DSP (processeur de traitement de signal numérique) pour la
carte son, par défaut, \fIdev/dsp\fP.
.RE

.IP \fBpulse\fP
Pilote de sortie audio directe de Pulseaudio. Options\ :
.RS
.IP \fIserver:valeur\fP
Spécifier l’emplacement du serveur Pulseaudio distant ou de remplacement.
.IP \fIsink:valeur\fP
Spécifier un collecteur autre que celui par défaut pour Pulseaudio pour le
flux audio.
.RE

.IP \fBraw\fP
Sortie de fichier \fIraw\fP. Cette option écrit des échantillons audio bruts
dans un fichier. Options\ :
.RS
.IP \fIbyteorder:valeur\fP
Choisir l’ordre des octets gros\-boutiste («\ big\ »), petit\-boutiste («\ little\ ») ou natif («\ native\ ». Par défaut, c’est l’ordre natif.
.RE

.IP \fBroar\fP
Pilote de sortie directe de RoarAudio Daemon. Options\ :
.RS
.IP "\fIserver:valeur\fP, \fIhost:valeur\fP"
Spécifier l’emplacement du serveur RoarAudio à utiliser.
.IP "\fIid:valeur\fP, \fIdev:valeur\fP"
Spécifier un mélangeur de remplacement dans le serveur RoarAudio pour le
flux audio.
.IP \fIrole:valeur\fP
Définir le réglage du rôle pour le flux audio.
.IP \fIclient_name:valeur\fP
Définir le nom du client pour le nouveau flux audio, par défaut «\ libao\ ».
.RE

.IP \fBsndio\fP
Pilote de sortie audio pour SNDIO d’OpenBSD. Options\ :
.RS
.IP \fIdev:valeur\fP
Spécifier un périphérique audio à utiliser pour la lecture.
.RE

.IP \fBsun\fP
Pilote de sortie audio de Sun pour NetBSD, OpenBSD et Solaris. Options\ :
.RS
.IP \fIdev:valeur\fP
Périphérique audio de la carte son. Par défaut, \fI/dev/audio\fP.
.RE


.IP \fBwav\fP
Fichier WAV de sortie. Cette option écrit les données audio sur le disque
sous forme non compressée. Si plusieurs fichiers sont lus, il seront tous
concaténés dans le même fichier WAV. Les fichiers WAV ne peuvent être écrits
dans des fichiers non parcourables, tels que la sortie standard. Dans ce
cas, utilisez le format AU.

.IP \fBwmm\fP
Pilote de sortie directe MultiMedia de Windows pour Win98 et distributions
postérieures. Options\ :
.RS
.IP \fIdev:valeur\fP
Sélectionner le périphérique audio pour la lecture à l’aide du nom de
périphérique.
.IP \fIid:valeur\fP
Sélectionner le périphérique audio pour la lecture à l’aide de l’identifiant
de périphérique (numéro de carte).
.RE

.SH EXEMPLES

La ligne de commande de \fBogg123\fP est assez flexible, au point de prêter
parfois à confusion. Voici quelques exemples de lignes de commande et une
explication de leur fonction.
.PP

Lecture sur la carte son par défaut\ :
.RS
\fBogg123 test.ogg\fP
.RE
.PP

Lire tous les fichiers du répertoire \fI~/musique\fP et de ses
sous\-répertoires\ :
.RS
\fBogg123 ~/musique\fP
.RE
.PP

Lire un fichier en utilisant le pilote OSS\ :
.RS
\fBogg123 \-d oss test.ogg\fP
.RE
.PP

Passer l’option «\ dsp\ » au pilote OSS\ :
.RS
\fBogg123 \-d oss \-o dsp:/dev/mon_dsp\fP
.RE
.PP

Utiliser le pilote ESD\ :
.RS
\fBogg123 \-d esd test.ogg\fP
.RE
.PP

Utiliser le pilote WAV avec comme fichier de sortie «\ test.wav\ »\ :
.RS
\fBogg123 \-d wav \-f test.wav test.ogg\fP
.RE
.PP

Écouter un fichier tout en l’écrivant dans un fichier WAV\ :
.RS
\fBogg123 \-d oss \-d wav \-f test.wav test.ogg\fP
.RE
.PP

Remarquez que les options s’appliquent à l’appareil indiqué à gauche\ ::
.RS
\fBogg123 \-d oss \-o dsp:/dev/mon_dsp \-d raw \-f test2.raw \-o byteorder:big test.ogg\fP
.RE
.PP

Test de stress de disque dur\ :
.RS
\fBogg123 \-d oss \-d wav \-f 1.wav \-d wav \-f 2.wav \-d wav \-f 3.wav \-d wav \-f 4.wav \-d wav \-f 5.wav test.ogg\fP
.RE
.PP

Créer un effet d’écho avec ESD et un ordinateur lent\ :
.RS
\fBogg123 \-d esd \-d esd test.ogg\fP
.RE
.PP

.SH INTERRUPTION
\fBogg123\fP peut être stoppé à n’importe quel moment en pressant Ctrl\-C. Lors
de l’écoute de plusieurs fichiers, cela stoppe l’écoute du fichier en cours
et débute celle du suivant. Pour arrêter l’écoute immédiatement au lieu de
sauter au fichier suivant, pressez Ctrl\-C pendant la première seconde de
l’écoute d’un nouveau fichier.
.P
Remarquez que le résultat de l’appui sur Ctrl\-C peut ne pas être audible
immédiatement à cause de la mise en tampon dans le périphérique audio. Le
délai dépend du système, mais n’excède généralement pas une ou deux
secondes.

.SH FICHIERS

.TP 
\fI/etc/libao.conf\fP
Fichier pouvant être utilisé pour définir le périphérique par défaut pour
tous les programmes \fBlibao\fP.

.TP 
\fI~/.libao\fP
Fichier de configuration par utilisateur pour outrepasser les réglages de
périphérique de sortie de tout le système.
.PP

.SH BOGUES

Enchainer les fichiers WAV dans d’autres programmes peut provoquer un
comportement étrange. Cela est dû à l’enregistrement de la taille des
données des fichiers WAV dans l’entête. Cependant, le pilote de sortie est
ignorant de cette taille lors de l’écriture de l’entête, et il n’existe pas
de valeur indiquant «\ taille inconnue\ ». Utilisez le pilote de sortie
\fIraw\fP ou \fIau\fP en cas de besoin d’utilisation de \fBogg123\fP dans un
pipeline.

.SH AUTEURS

.TP 
Auteurs du programme :
.br
Kenneth Arnold <kcarnold\-xiph@arnoldnet.net>
.br
Stan Seibert <volsung@xiph.org>
.br

.TP 
Auteur de la page de manuel :
.br
Stan Seibert <volsung@xiph.org>

.SH "VOIR AUSSI"

.PP
\fBlibao.conf\fP(5), \fBoggenc\fP(1), \fBvorbiscomment\fP(1), \fBogginfo\fP(1)

.PP
.SH TRADUCTION
La traduction française de cette page de manuel a été créée par
Jean-Paul Guillonneau <guillonneau.jeanpaul@free.fr>
.
.PP
Cette traduction est une documentation libre ; veuillez vous reporter à la
.UR https://www.gnu.org/licenses/gpl-3.0.html
GNU General Public License version 3
.UE
concernant les conditions de copie et 
de distribution. Il n'y a aucune RESPONSABILITÉ LÉGALE.
.PP
Si vous découvrez un bogue dans la traduction de cette page de manuel, 
veuillez envoyer un message à
.MT debian-l10n-french@lists.debian.org
.ME .
