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


NOM

audtool - un petit outil pour contrôler Audacious depuis la ligne de commande.

SYNOPSIS

audtool [instance] command [parameter ...] ...

DESCRIPTION

audtool envoie des commandes à une instance en cours d'exécution d'Audacious.

Il peut envoyer de nombreuses commandes courantes, telles que le passage à la chanson suivante de la liste de lecture, et peut également imprimer des informations d'état, telles que le titre de la chanson en cours.

instance peut être donnée sous la forme -1, -2, etc. (jusqu'à -9) pour spécifier quelle instance d'Audacious pour contrôler le démarrage de plusieurs instances.

COMMANDES

Informations sur la chanson actuelle :

--current-song

Imprimer le titre formaté de la chanson en cours. Selon les paramètres d'Audacious, cela peut inclure des informations telles que le nom de l'artiste et de l'album. Pour imprimer uniquement le titre de la chanson, utilisez plutôt --current-song-tuple-data title.

--current-song-filename

Affiche le nom du fichier (chemin complet ou URI) de la chanson en cours.

--current-song-length

Imprime la longueur de la chanson en cours au format M:SS.

--current-song-length-seconds

Imprimer la longueur de la chanson en cours en secondes.

--current-song-length-frames

Imprimer la longueur de la chanson en cours en millisecondes.

--current-song-output-length

Imprimez le compteur de temps de lecture au format M:SS.

--current-song-output-length-seconds

Imprimer le compteur de temps de lecture en secondes.

--current-song-output-length-frames

Imprimer le compteur de temps de lecture en millisecondes.

--current-song-bitrate

Affiche le débit binaire du streaming en bits par seconde.

--current-song-bitrate-kbps

Imprimez le débit binaire du streaming en kilobits par seconde (1 kilobit=1000 bits).

--current-song-frequency

Imprimer le taux d'échantillonnage en hertz.

--current-song-frequency-khz

Imprimer le taux d'échantillonnage en kilohertz.

--current-song-channels

Imprimer le nombre de canaux audio.

--current-song-tuple-data field

Affiche la valeur d'un champ nommé (artiste, année, genre, etc.) pour la chanson en cours. Si le nom du champ est omis, une liste des champs autorisés sera imprimée.

--current-song-info

Imprimez le débit binaire de diffusion, le taux d'échantillonnage et le nombre de canaux audio.

Commandes de lecture :

--playback-play

Démarrez la lecture. En cas de pause, la lecture reprendra à partir du même point. S'il est déjà actif et non en pause, il redémarrera depuis le début de la chanson.

--playback-pause

Mettez la lecture en pause ou reprenez-la si elle est déjà en pause.

--playback-playpause

Équivalent à --playback-pause si la lecture est active, sinon --playback-play.

--playback-stop

Arrêtez la lecture.

--playback-playing

Renvoie un code de sortie de 0 (vrai) si la lecture est active.

--playback-paused

Renvoie un code de sortie de 0 (vrai) si la lecture est en pause.

--playback-stopped

Renvoie un code de sortie de 0 (vrai) si la lecture n'est pas active.

--playback-status

Affiche l'état de la lecture (``lecture'', ``pause'' ou ``arrêté'').

--playback-seek time

Recherche le temps donné en secondes, par rapport au début de la chanson.

--playback-seek-relative time

Recherche le temps donné en secondes, par rapport au compteur de temps actuel.

--playback-record

Basculer l'enregistrement du flux de sortie (à l'aide de FileWriter).

--playback-recording

Renvoie un code de sortie de 0 (vrai) si l'enregistrement de flux est activé.

Sélection de la liste de lecture :

--select-displayed

Spécifie que toutes les commandes de playlist suivantes doivent s'appliquer à la playlist actuellement affichée par Audacious, quelle que soit la playlist en cours de lecture. Ce paramètre prend effet jusqu'à ce qu'il soit remplacé par --select-playing ou qu'Audacious soit redémarré.

Les commandes suivantes sont également affectées :

--current-song
--current-song-filename
--current-song-length[-seconds,-frames]
--current-song-tuple-data
--select-playing

Spécifie que lorsque la lecture est active, toutes les commandes de liste de lecture suivantes doivent s'appliquer à la liste de lecture en cours de lecture. Lorsque la lecture est arrêtée, le comportement est le même que pour --select-displayed. Ce paramètre est la valeur par défaut.

Commandes de liste de lecture :

--playlist-advance

Passer à la chanson suivante dans la liste de lecture.

--playlist-reverse

Passer à la chanson précédente dans la liste de lecture.

--playlist-addurl path

Ajoutez une chanson à la fin de la liste de lecture. Un URI ou un chemin de fichier local (absolu ou relatif) peut être donné.

--playlist-insurl path position

Insérez une chanson à la position donnée (basée sur un) dans la liste de lecture.

--playlist-addurl-to-new-playlist path

Ajoutez une chanson à la liste de lecture `` Lecture en cours '', créez la liste de lecture si nécessaire et commencez à jouer la chanson. Selon les paramètres d'Audacious, la liste de lecture peut d'abord être effacée.

--playlist-delete position

Supprimez la chanson à la position donnée de la liste de lecture.

--playlist-length

Imprimer le nombre de chansons dans la liste de lecture.

--playlist-song position

Imprimer le titre formaté d'une chanson dans la liste de lecture.

--playlist-song-filename position

Imprimer le nom de fichier (chemin complet ou URI) d'une chanson dans la liste de lecture.

--playlist-song-length position

Imprimer la durée d'une chanson dans la liste de lecture au format M:SS.

--playlist-song-length-seconds position

Imprimer la longueur d'une chanson dans la liste de lecture en secondes.

--playlist-song-length-frames position

Imprimer la longueur d'une chanson dans la liste de lecture en millisecondes.

--playlist-tuple-data field position

Imprimer la valeur d'un champ nommé pour une chanson dans la liste de lecture.

--playlist-display

Imprimer les titres de toutes les chansons de la liste de lecture.

--playlist-position

Imprimer la position de la chanson en cours dans la liste de lecture.

--playlist-jump position

Passer à la chanson à la position donnée dans la liste de lecture.

--playlist-clear

Effacez la liste de lecture.

--playlist-auto-advance-status

Affiche l'état de l'avancement automatique de la liste de lecture (``on'' ou ``off'').

--playlist-auto-advance-toggle

Basculer l'avance automatique de la liste de lecture.

--playlist-repeat-status

Affiche l'état de la répétition de la liste de lecture (``on'' ou ``off'').

--playlist-repeat-toggle

Basculer la répétition de la liste de lecture.

--playlist-shuffle-status

Affiche l'état de la liste de lecture aléatoire (``on'' ou ``off'').

--playlist-shuffle-toggle

Basculer la liste de lecture aléatoire.

--playlist-stop-after-status

Affiche l'option ``stop après la chanson en cours'' (``on'' ou ``off'').

--playlist-stop-after-toggle

Activez l'option ``arrêter après la chanson en cours''.

Plus de commandes de playlist :

--number-of-playlists

Imprimer le nombre de listes de lecture ouvertes.

--current-playlist

Affiche le numéro de la playlist en cours, où "current" est interprété selon --select-displayed ou --select-playing.

--play-current-playlist

Démarrez la lecture dans la liste de lecture en cours, en reprenant à partir du dernier point lu si possible. Lorsque --select-displayed est activé, cette commande peut être utilisée pour basculer la lecture vers la liste de lecture affichée.

--set-current-playlist playlist

Afficher la liste de lecture donnée. Lorsque --select-playing est en vigueur et qu'une autre liste de lecture est en cours de lecture, cette commande basculera également la lecture vers la liste de lecture donnée. L'option --select-displayed désactive ce comportement.

--current-playlist-name

Imprimer le titre de la liste de lecture en cours.

--set-current-playlist-name title

Définissez le titre de la liste de lecture actuelle.

--new-playlist

Insérez une nouvelle liste de lecture après l'actuelle et basculez vers celle-ci comme si --set-current-playlist était utilisé.

--delete-current-playlist

Supprimer la liste de lecture actuelle.

Commandes de file d'attente de la liste de lecture :

--playqueue-add position

Ajoutez la chanson à la position de playlist donnée à la file d'attente.

--playqueue-remove position

Supprimez la chanson à la position de liste de lecture donnée de la file d'attente.

--playqueue-is-queued position

Renvoie un code de sortie de 0 (vrai) si la chanson à la position de la liste de lecture donnée est dans la file d'attente.

--playqueue-get-queue-position position

Imprimer la position de file d'attente de la chanson à la position de liste de lecture donnée.

--playqueue-get-list-position position

Imprimer la position de la liste de lecture de la chanson à la position de file d'attente donnée.

--playqueue-length

Imprimer le nombre de chansons dans la file d'attente.

--playqueue-display

Imprimer les titres de toutes les chansons de la file d'attente.

--playqueue-clear

Videz la file d'attente.

Contrôle du volume et égaliseur :

--get-volume

Imprimer le niveau de volume actuel en pourcentage.

--set-volume level

Réglez le niveau de volume actuel en pourcentage.

--equalizer-activate [on|off]

Activez ou désactivez l'égaliseur.

--equalizer-get

Imprime les réglages de l'égaliseur (préampli et gain pour toutes les bandes) en décibels.

--equalizer-set preamp band0 band1 band2 band3 band4 band5 band6 band7 band8 band9

Réglez les paramètres de l'égaliseur (préampli et gain pour toutes les bandes) en décibels.

--equalizer-get-preamp

Imprime la pré-amplification de l'égaliseur en décibels.

--equalizer-set-preamp preamp

Réglez la préamplification de l'égaliseur en décibels.

--equalizer-get-band band

Imprimer le gain de la bande d'égalisation donnée (0-9) en décibels.

--equalizer-set-band band gain

Réglez le gain de la bande d'égalisation donnée (0-9) en décibels.

Divers:

--mainwin-show [on|off]

Afficher ou masquer la fenêtre Audacious.

--filebrowser-show [on|off]

Afficher ou masquer la fenêtre Ajouter des fichiers.

--jumptofile-show [on|off]

Afficher ou masquer la fenêtre Aller au morceau.

--preferences-show [on|off]

Afficher ou masquer la fenêtre Paramètres.

--about-show [on|off]

Afficher ou masquer la fenêtre À propos de.

--version

Imprimer les informations de version.

--plugin-is-enabled plugin

Renvoie un code de sortie de 0 (vrai) si le plugin donné est activé. Le plugin est spécifié en utilisant son nom de fichier installé moins le chemin du dossier et le suffixe : par exemple, crossfade pour lib/audacious/Effect/crossfade.so.

--plugin-enable plugin [on|off]

Activez ou désactivez le plugin donné. Notez que les plugins d'interface et de sortie ne peuvent pas être désactivés directement car l'un de chaque doit toujours être actif. L'activation d'un plugin d'interface ou de sortie désactivera automatiquement le plugin précédent.

--config-get [section:]name

Imprimer la valeur d'un paramètre de configuration. Toute utilisation de cette commande est entièrement non prise en charge. Comment trouver la section et le nom d'un paramètre donné est laissé en exercice au lecteur.

--config-set [section:]name value

Modifier la valeur d'un paramètre de configuration. Cette commande n'est pas prise en charge et est dangereuse. Cela peut avoir des effets secondaires inattendus (comme planter Audacious), ou cela peut n'avoir aucun effet du tout. Utilisez à vos risques et périls!

--shutdown

Arrêtez Audacious.

--help

Imprimer un bref résumé des commandes audtool.

Les commandes peuvent être préfixées par `--' (options longues de style GNU) ou non, selon votre choix.

INSECTES

Il n'y a pas de bugs connus dans audtool pour le moment ; si vous en trouvez, veuillez les signaler sur https://redmine.audacious-media-player.org/projects/audacious.

AUTEURS

audtool a été écrit par George Averill nhjm@nhjm.net et Ariadne Conill ariadne@dereferenced.org.

Cette page de manuel a été écrite par Adam Cecile gandalf@le-vert.net et Kiyoshi Aman kiyoshi@atheme.org. Quelques ajustements supplémentaires ont été effectués par Ariadne Conill ariadne@dereferenced.org et Tony Vroon chainsaw@gentoo.org. La page de manuel a été mise à jour pour Audacious 3.7 et versions ultérieures par John Lindgren john@jlindgren.net.

Ce travail est sous licence Creative Commons Attribution 3.0 Unported License https://creativecommons.org/licenses/by/3.0/.

VOIR ÉGALEMENT

audacious(1)

SITE INTERNET

https://audacious-media-player.org