table of contents
| ogg123(1) | Outils Vorbis | ogg123(1) |
NOM¶
ogg123 – Écoute des fichiers Ogg et FLAC
SYNOPSIS¶
ogg123 [ -vqrzZVh ] [ -k secondes ] [ -x nième ] [ -y n_fois ] [ -b taille_tampon ] [ -d pilote [ -o option:valeur ] [ -f nom_fichier ] ] fichier ... | répertoire ... | URL ...
DESCRIPTION¶
ogg123 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, ogg123 é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.
OPTIONS¶
- --audio-buffer n
- Utiliser un tampon de sortie audio d’approximativement n kilooctets
- -@ liste_lectures, --list liste_lectures
- Jouer tous les fichiers indiqués dans le fichier liste_lectures. 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.
- -b n, --buffer n
- Utiliser un tampon d’entrée d’approximativement n kilooctets. Option valable uniquement pour HTTP.
- -p n, --prebuffer n
- Précharger le tampon d’entrée à n pour cent. L’écoute ne commencera qu’une fois ce préchargement réalisé. Option valable uniquement pour HTTP.
- -d périphérique, --device périphérique
- 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é.
- -f nom_fichier, --file nom_fichier
- Spécifier le fichier de sortie pour un périphérique de fichier précédemment spécifié avec l’option --device. Le nom de fichier « - » écrit sur la sortie standard. Si le fichier existe déjà, il sera écrasé.
- -h, --help
- Afficher une description des commandes
- -k n, --skip n
- Sauter les n premières secondes. n peut être sous la forme minutes:secondes ou heures:minutes:secondes.
- -K n, --end n
- Arrêter la lecture n secondes après le début du flux. n peut être du même format que l’option --skip.
- -o option[:valeur], --device-option option[:valeur]
- Définir l’option à valeur pour le périphérique précédent. Consulter PÉRIPHÉRIQUES pour une liste des options valables pour chaque périphérique.
- -q, --quiet
- Mode silencieux. Aucun message n’est affiché.
- -V, --version
- Afficher les informations de version.
- -v, --verbose
- Augmenter le niveau de détail
- -x n, --nth n
- Lire chaque nième bloc décodé. Cela a pour effet de jouer l’audio n fois plus vite que la vitesse normale.
- -y n, --ntimes n
- Répéter chaque nième bloc joué. Cela pour effet de jouer l’audio n fois plus lentement que la vitesse normale. Cette option peut être spécifiée avec l’option -x pour des vitesses fractionnaires intéressantes.
- -r, --repeat
- Répéter la liste de lecture indéfiniment.
- -z, --shuffle
- Jouer les fichiers dans un ordre pseudo-aléatoire.
- -Z, --random
- Jouer éternellement les fichiers dans un ordre pseudo-aléatoire.
PÉRIPHÉRIQUES¶
ogg123 prend en charge divers périphériques de sortie audio à travers libao. Seuls les périphériques pris en charge par la plateforme cible seront disponibles. L’option -f 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 :
- debug
- Activer la sortie de débogage (si disponible) pour le pilote choisi.
- matrix:valeur
- Forcer un ordre spécifique de canaux de sortie pour un périphérique donné. valeur 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.
- verbose
- Activer une sortie prolixe pour le pilote indiqué. L’option -v active aussi l’option de prolixité du pilote.
- quiet
- Forcer le pilote indiqué à être complètement silencieux. Même les erreurs ne produiront aucun message. L’option -q active l’option silence du pilote.
- aixs
- Pilote de sortie directe d’AIX. Options :
- dev:valeur
- Définir le périphérique de sortie d’AIX à valeur.
- alsa
- Pilote de sortie directe de Advanced Linux Sound Architecture. Options :
- buffer_time:valeur
- Cette valeur écrase la durée du tampon matériel par défaut (en millisecondes).
- dev:valeur
- É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
- period_time:valeur
- Cette valeur écrase la durée de la période matérielle (en microsecondes).
- period_time:valeur
- Cette valeur écrase la durée de la période matérielle (en microsecondes).
- use_mmap:valeur
- valeur 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 mmap(2). Précédemment, quelques pilotes alsa bogués se comportaient mieux en n’utilisant pas l’accès mmap au prix d’une utilisation légèrement supérieure du CPU.
- arts
- Pilote de sortie directe d’aRts Sound Daemon. Options :
- multi:valeur
- valeur 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 ».
- au
- 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.
- esd
- Sortie directe de Enlightened Sound Daemon. Options :
- host:valeur
- valeur 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).
- client_name:valeur
- Définir le nom du client pour le nouveau flux audio, par défaut « libao ».
- irix
- Pilote de sortie audio directe pour IRIX.
- macosx
- 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 :
- buffer_time:valeur
- Définir la taille du tampon matériel à l’équivalent de valeur millisecondes.
- nas
- Pilote de sortie directe pour Network Audio Server. Options :
- buf_size:valeur
- Définir la taille du tampon audio en octets sur le serveur.
- host:valeur
- Définir l’emplacement du serveur NAS ; consulter nas(1) pour le format.
- null
- Pilote Null. Toutes les données audio sont supprimées (remarque : les données audio ne sont pas écrites sur /dev/null !). Ce pilote peut être utilisé pour tester la vitesse de décodage raw sans surcharge de la sortie.
- oss
- Pilote d’Open Sound System pour Linux et FreeBSD, versions 2, 3 et 4. Options :
- dsp:valeur
- Périphérique DSP (processeur de traitement de signal numérique) pour la carte son, par défaut, dev/dsp.
- pulse
- Pilote de sortie audio directe de Pulseaudio. Options :
- server:valeur
- Spécifier l’emplacement du serveur Pulseaudio distant ou de remplacement.
- sink:valeur
- Spécifier un collecteur autre que celui par défaut pour Pulseaudio pour le flux audio.
- raw
- Sortie de fichier raw. Cette option écrit des échantillons audio bruts dans un fichier. Options :
- byteorder:valeur
- Choisir l’ordre des octets gros-boutiste (« big »), petit-boutiste (« little ») ou natif (« native ». Par défaut, c’est l’ordre natif.
- roar
- Pilote de sortie directe de RoarAudio Daemon. Options :
- server:valeur, host:valeur
- Spécifier l’emplacement du serveur RoarAudio à utiliser.
- id:valeur, dev:valeur
- Spécifier un mélangeur de remplacement dans le serveur RoarAudio pour le flux audio.
- role:valeur
- Définir le réglage du rôle pour le flux audio.
- client_name:valeur
- Définir le nom du client pour le nouveau flux audio, par défaut « libao ».
- sndio
- Pilote de sortie audio pour SNDIO d’OpenBSD. Options :
- dev:valeur
- Spécifier un périphérique audio à utiliser pour la lecture.
- sun
- Pilote de sortie audio de Sun pour NetBSD, OpenBSD et Solaris. Options :
- dev:valeur
- Périphérique audio de la carte son. Par défaut, /dev/audio.
- wav
- 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.
- wmm
- Pilote de sortie directe MultiMedia de Windows pour Win98 et distributions postérieures. Options :
- dev:valeur
- Sélectionner le périphérique audio pour la lecture à l’aide du nom de périphérique.
- id:valeur
- Sélectionner le périphérique audio pour la lecture à l’aide de l’identifiant de périphérique (numéro de carte).
EXEMPLES¶
La ligne de commande de ogg123 est assez flexible, au point de prêter parfois à confusion. Voici quelques exemples de lignes de commande et une explication de leur fonction.
Lecture sur la carte son par défaut :
Lire tous les fichiers du répertoire ~/musique et de ses sous-répertoires :
Lire un fichier en utilisant le pilote OSS :
Passer l’option « dsp » au pilote OSS :
Utiliser le pilote ESD :
Utiliser le pilote WAV avec comme fichier de sortie « test.wav » :
Écouter un fichier tout en l’écrivant dans un fichier WAV :
Remarquez que les options s’appliquent à l’appareil indiqué à gauche ::
Test de stress de disque dur :
Créer un effet d’écho avec ESD et un ordinateur lent :
INTERRUPTION¶
ogg123 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.
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.
FICHIERS¶
- /etc/libao.conf
- Fichier pouvant être utilisé pour définir le périphérique par défaut pour tous les programmes libao.
- ~/.libao
- Fichier de configuration par utilisateur pour outrepasser les réglages de périphérique de sortie de tout le système.
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 raw ou au en cas de besoin d’utilisation de ogg123 dans un pipeline.
AUTEURS¶
- Auteurs du programme :
-
Kenneth Arnold <kcarnold-xiph@arnoldnet.net>
Stan Seibert <volsung@xiph.org> - Auteur de la page de manuel :
-
Stan Seibert <volsung@xiph.org>
VOIR AUSSI¶
TRADUCTION¶
La traduction française de cette page de manuel a été créée par Jean-Paul Guillonneau <guillonneau.jeanpaul@free.fr>
Cette traduction est une documentation libre ; veuillez vous reporter à la GNU General Public License version 3 concernant les conditions de copie et de distribution. Il n'y a aucune RESPONSABILITÉ LÉGALE.
Si vous découvrez un bogue dans la traduction de cette page de manuel, veuillez envoyer un message à debian-l10n-french@lists.debian.org.
| 24 mars 2010 | Fondation Xiph.Org |