aplay - manuel de référence, options, exemples de commandes


NOM

aplay arecord, aplay - enregistreur et lecteur de son en ligne de commande pour le pilote de carte son ALSA

SYNOPSIS

arecord [flags] [filename]
aplay [flags] [filename [filename]] ...

DESCRIPTION

arecord est un enregistreur de fichier son en ligne de commande pour le pilote de carte son ALSA. Il prend en charge plusieurs formats de fichiers et plusieurs cartes son avec plusieurs appareils. Si vous enregistrez avec des échantillons en mode entrelacé, le fichier est automatiquement divisé avant la taille de fichier de 2 Go.

aplay est sensiblement le même, sauf qu'il joue au lieu d'enregistrer. Pour les formats de fichier son pris en charge, le taux d'échantillonnage, la profondeur de bits, etc. peuvent être déterminés automatiquement à partir de l'en-tête du fichier son.

Si le nom de fichier n'est pas spécifié, la sortie ou l'entrée standard est utilisée. L'utilitaire aplay accepte plusieurs noms de fichiers.

OPTIONS

-h, --help

Aide : afficher la syntaxe.

--version

Imprimer la version actuelle.

-l, --list-devices

Répertorier toutes les cartes son et périphériques audio numériques

-L, --list-pcms

Lister tous les PCM définis

-D, --device=NAME

Sélectionnez PCM par son nom

-q --quiet

Mode silencieux. Supprimer les messages (pas de son :))

-t, --file-type TYPE

Type de fichier (voc, wav, raw ou au). Si ce paramètre est omis, le format WAVE est utilisé.

-c, --channels=#

Le nombre de canaux. La valeur par défaut est un canal. Les valeurs valides sont comprises entre 1 et 32.

-f --format=FORMAT

Exemple de format
Les formats d'échantillons reconnus sont : S8 U8 S16_LE S16_BE U16_LE U16_BE S24_LE S24_BE U24_LE U24_BE S32_LE S32_BE U32_LE U32_BE FLOAT_LE FLOAT_BE FLOAT64_LE FLOAT64_BE IEC958_SUBFRAME_LE IEC958_SUBFRAME_BE MU _LAW A_LAW IMA_ADPCM MPEG GSM SPÉCIAL S24_3LE S24_3BE U24_3LE U24_3BE S20_3LE S20_3BE U20_3LE U20_3BE S18_3LE S18_3BE U18_3LE
Certains d'entre eux peuvent ne pas être disponibles sur certains matériels
Les raccourcis de format disponibles sont :

-f cd (16 bit little endian, 44100, stereo) [-f S16_LE -c2 -r44100]
-f cdr (16 bit big endian, 44100, stereo) [-f S16_BE -c2 -r44100]
-f dat (16 bit little endian, 48000, stereo) [-f S16_LE -c2 -r48000]

Si aucun format n'est donné, U8 est utilisé.

-r, --rate=#<Hz>

Taux d'échantillonnage en Hertz. Le débit par défaut est de 8000 Hertz. Si la valeur spécifiée est inférieure à 300, elle est prise comme taux en kilohertz. Les valeurs valides sont comprises entre 2 000 et 192 000 Hertz.

-d, --duration=#

Interrompre après # secondes. Une valeur de zéro signifie l'infini. La valeur par défaut est zéro, donc si cette option est omise, le processus d'enregistrement/lecture s'exécutera jusqu'à ce qu'il soit tué. L'option '-d' ou '-s' est disponible exclusivement.

-s, --samples=#

Interruption après transmission de # trames PCM. Une valeur de zéro signifie l'infini. La valeur par défaut est zéro, donc si cette option est omise, le processus d'enregistrement/lecture s'exécutera jusqu'à ce qu'il soit tué. L'option '-d' ou '-s' est disponible exclusivement.

-M, --mmap

Utilisez le mode E/S mappé en mémoire (mmap) pour le flux audio. Si cette option n'est pas définie, le mode E/S de lecture/écriture sera utilisé.

-N, --nonblock

Ouvrez le périphérique audio en mode non bloquant. Si l'appareil est occupé, le programme se fermera immédiatement. Si cette option n'est pas définie, le programme se bloquera jusqu'à ce que le périphérique audio soit à nouveau disponible.

-F, --period-time=#

La distance entre les interruptions est de # microsecondes. Si aucun temps de période et aucune taille de période ne sont donnés, alors un quart du temps de tampon est défini.

-B, --buffer-time=#

La durée du tampon est de # microsecondes Si aucun temps de tampon et aucune taille de tampon ne sont donnés, alors le temps de tampon maximal autorisé mais pas plus de 500 ms est défini.

--period-size=#

La distance entre les interruptions est de # trames. Si aucune taille de période et aucun temps de période n'est donné, alors un quart de la taille de la mémoire tampon est défini.

--buffer-size=#

La durée du tampon est de # images Si aucun temps de tampon et aucune taille de tampon ne sont donnés, alors le temps de tampon maximal autorisé mais pas plus de 500 ms est défini.

-A, --avail-min=#

L'espace minimal disponible pour le réveil est de # microsecondes

-R, --start-delay=#

Le délai pour le démarrage automatique du PCM est de # microsecondes (par rapport à la taille de la mémoire tampon si <= 0)

-T, --stop-delay=#

Le délai d'arrêt automatique du PCM est de # microsecondes à partir de xrun

-v, --verbose

Afficher la structure et la configuration du PCM. Cette option est cumulative. Le VU-mètre s'affiche lorsqu'il est donné deux ou trois fois.

-V, --vumeter=TYPE

Spécifie le type de VU-mètre, soit stéréo ou mono. Le VU-mètre stéréo n'est disponible que pour les échantillons stéréo à 2 canaux au format entrelacé.

-I, --separate-channels

Un fichier pour chaque canal. Cette option désactive max-file-time et use-strftime, et ignore SIGUSR1. Le VU-mètre stéréo n'est pas disponible avec des canaux séparés.

-P

Relecture. C'est la valeur par défaut si le programme est appelé en tapant aplay.

-C

Enregistrer. C'est la valeur par défaut si le programme est appelé en tapant un enregistrement.

-i, --interactive

Autoriser le fonctionnement interactif via stdin. Actuellement, seule la pause/reprise via l'espace ou la touche Entrée est implémentée.

-m, --chmap=ch1,ch2,...

Donnez la carte des canaux à remplacer ou à suivre. Passez des chaînes de position de chaîne telles que FL, FR, etc.

Si un appareil prend en charge le remplacement de la carte des chaînes, aplay essaie de passer la carte des chaînes donnée. S'il ne prend pas en charge le remplacement de la carte des chaînes mais qu'il fournit toujours les informations de carte des chaînes, aplay essaie de réorganiser l'ordre des chaînes dans le tampon pour qu'il corresponde à la carte des chaînes renvoyée par l'appareil.

--disable-resample

Désactivez le rééchantillonnage automatique du taux.

--disable-channels

Désactivez les conversions automatiques des canaux.

--disable-format

Désactiver les conversions de format automatiques.

--disable-softvol

Désactivez le contrôle du volume logiciel (softvol).

--test-position

Testez la position du tampon circulaire.

--test-coef=<coef>

Coefficient de test pour la position du tampon circulaire ; la valeur par défaut est 8. L'expression de validation est : coef * (buffer_size/2). La valeur minimale est 1.

--test-nowait

N'attendez pas que le tampon en anneau ‐ mange tout le processeur.

--max-file-time

Pendant l'enregistrement, lorsque le fichier de sortie accumule du son depuis si longtemps, fermez-le et ouvrez un nouveau fichier de sortie. La valeur par défaut est la taille maximale prise en charge par le format de fichier : 2 Gio pour les fichiers WAV. Cette option n'a aucun effet si --separate-channels est spécifié.

--process-id-file <file name>

aplay écrit son ID de processus ici, afin que d'autres programmes puissent lui envoyer des signaux.

--use-strftime

Lors de l'enregistrement, interprétez les codes % dans le paramètre de nom de fichier à l'aide de la fonction strftime chaque fois que le fichier de sortie est ouvert. Les codes strftime importants sont : %Y est l'année, %m mois, %d jour du mois, %H heure, %M minute et %S seconde. De plus, %v est le numéro de fichier, commençant à 1. Lorsque cette option est spécifiée, les répertoires intermédiaires pour le fichier de sortie sont créés automatiquement. Cette option n'a aucun effet si --separate-channels est spécifié.

--dump-hw-params

Videz hw_params de l'état préconfiguré de l'appareil vers stderr. Le vidage répertorie les capacités du périphérique sélectionné, telles que les formats pris en charge, les taux d'échantillonnage, le nombre de canaux, la période et les octets/tailles/durées de la mémoire tampon. Pour le périphérique brut hw:X, cette option répertorie essentiellement les capacités matérielles de la carte son.

--fatal-errors

Désactive les tentatives de récupération lorsque des erreurs (par exemple xrun) sont rencontrées ; le processus aplay s'interrompt immédiatement.

SIGNAUX

Lors de l'enregistrement, SIGINT, SIGTERM et SIGABRT fermeront le fichier de sortie et quitteront. SIGUSR1 fermera le fichier de sortie, en ouvrira un nouveau et poursuivra l'enregistrement. Cependant, SIGUSR1 ne fonctionne pas avec --separate-channels.

EXEMPLES

aplay -c 1 -t raw -r 22050 -f mu_law foobar

lira le fichier brut "foobar" comme un fichier .au Mu-Law 22050 Hz, mono, 8 bits.

arecord -d 10 -f cd -t wav -D copy foobar.wav

enregistrera foobar.wav sous la forme d'un fichier wave de qualité CD de 10 secondes, en utilisant la "copie" PCM (qui peut être définie dans le fichier .asoundrc de l'utilisateur comme suit :

pcm.copy {
  type plug
  slave {
    pcm hw
  }
  route_policy copy
}
arecord -t wav --max-file-time 30 mon.wav

Enregistrez à partir de la source audio par défaut en monaural, 8 000 échantillons par seconde, 8 bits par échantillon. Démarrez un nouveau fichier toutes les 30 secondes. Les noms de fichiers sont mon-nn.wav, où nn augmente à partir de 01. Le fichier après mon-99.wav est mon-100.wav.

arecord -f cd -t wav --max-file-time 3600 --use-strftime %Y/%m/%d/listen-%H-%M-%v.wav

Enregistrez en stéréo à partir de la source audio par défaut. Créez un nouveau fichier toutes les heures. Les fichiers sont placés dans des répertoires en fonction de leurs dates de début et ont des noms qui incluent leurs heures de début et leurs numéros de fichier.

VOIR ÉGALEMENT

alsamixer(1), amixer(1)

INSECTES

Notez que les fichiers .aiff ne sont actuellement pas pris en charge.

AUTEUR

arecord et aplay sont de Jaroslav Kysela perex@perex.cz Ce document est de Paul Winkler zarmzarm@erols.com. Mise à jour pour Alsa 0.9 par James Tappin james@xena.uklinux.net