audtool - Referenzhandbuch, Optionen, Befehlsbeispiele


NAME

audtool - ein kleines Tool zur Steuerung von Audacious über die Befehlszeile.

ZUSAMMENFASSUNG

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

BESCHREIBUNG

audtool sendet Befehle an eine laufende Instanz von Audacious.

Es kann viele gängige Befehle senden, z. B. zum Springen zum nächsten Titel in der Wiedergabeliste, und auch Statusinformationen ausdrucken, z. B. den Titel des aktuellen Titels.

instance kann als -1, -2 usw. (bis zu -9) angegeben werden, um anzugeben, welche Instanz von Audacious, um zu steuern, wann mehrere Instanzen gestartet wurden.

BEFEHLE

Aktuelle Songinformationen:

--current-song

Drucken Sie den formatierten Titel des aktuellen Songs. Abhängig von den Audacious-Einstellungen können dazu Informationen wie der Künstler und der Albumname gehören. Um nur den Songtitel auszudrucken, verwenden Sie stattdessen --current-song-tuple-data title.

--current-song-filename

Gibt den Dateinamen (vollständiger Pfad oder URI) des aktuellen Songs aus.

--current-song-length

Drucken Sie die Länge des aktuellen Songs im M:SS-Format.

--current-song-length-seconds

Gibt die Länge des aktuellen Songs in Sekunden aus.

--current-song-length-frames

Gibt die Länge des aktuellen Songs in Millisekunden aus.

--current-song-output-length

Drucken Sie den Wiedergabezeitzähler im M:SS-Format.

--current-song-output-length-seconds

Drucken Sie den Wiedergabezeitzähler in Sekunden aus.

--current-song-output-length-frames

Gibt den Wiedergabezeitzähler in Millisekunden aus.

--current-song-bitrate

Gibt die Streaming-Bitrate in Bits pro Sekunde aus.

--current-song-bitrate-kbps

Geben Sie die Streaming-Bitrate in Kilobit pro Sekunde aus (1 Kilobit=1000 Bit).

--current-song-frequency

Drucken Sie die Abtastrate in Hertz aus.

--current-song-frequency-khz

Drucken Sie die Abtastrate in Kilohertz aus.

--current-song-channels

Drucken Sie die Anzahl der Audiokanäle aus.

--current-song-tuple-data field

Gibt den Wert eines benannten Felds (Künstler, Jahr, Genre usw.) für das aktuelle Lied aus. Wenn der Feldname weggelassen wird, wird eine Liste der zulässigen Felder gedruckt.

--current-song-info

Drucken Sie die Streaming-Bitrate, die Abtastrate und die Anzahl der Audiokanäle aus.

Wiedergabebefehle:

--playback-play

Starten Sie die Wiedergabe. Bei einer Pause wird die Wiedergabe an derselben Stelle fortgesetzt. Wenn es bereits aktiv und nicht pausiert ist, wird es vom Anfang des Songs neu gestartet.

--playback-pause

Unterbrechen Sie die Wiedergabe oder setzen Sie sie fort, wenn sie bereits angehalten wurde.

--playback-playpause

Entspricht --playback-pause, wenn die Wiedergabe aktiv ist, andernfalls --playback-play.

--playback-stop

Stoppen Sie die Wiedergabe.

--playback-playing

Gibt einen Exit-Code von 0 (wahr) zurück, wenn die Wiedergabe aktiv ist.

--playback-paused

Gibt einen Exit-Code von 0 (wahr) zurück, wenn die Wiedergabe angehalten ist.

--playback-stopped

Gibt einen Exit-Code von 0 (wahr) zurück, wenn die Wiedergabe nicht aktiv ist.

--playback-status

Drucken Sie den Wiedergabestatus („wird abgespielt“, „pausiert“ oder „gestoppt“).

--playback-seek time

Suchen Sie nach der angegebenen Zeit in Sekunden, relativ zum Anfang des Songs.

--playback-seek-relative time

Sucht nach der angegebenen Zeit in Sekunden, relativ zum aktuellen Zeitzähler.

--playback-record

Schalten Sie die Aufzeichnung des Ausgabestreams um (mit FileWriter).

--playback-recording

Gibt einen Exit-Code von 0 (wahr) zurück, wenn die Stream-Aufzeichnung aktiviert ist.

Auswahl der Playlist:

--select-displayed

Gibt an, dass alle nachfolgenden Wiedergabelistenbefehle für die aktuell von Audacious angezeigte Wiedergabeliste gelten sollen, unabhängig davon, welche Wiedergabeliste abgespielt wird. Diese Einstellung bleibt wirksam, bis sie durch --select-playing überschrieben wird oder Audacious neu gestartet wird.

Betroffen sind auch die folgenden Befehle:

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

Gibt an, dass bei aktiver Wiedergabe alle nachfolgenden Wiedergabelistenbefehle für die aktuell wiedergegebene Wiedergabeliste gelten sollen. Wenn die Wiedergabe gestoppt wird, ist das Verhalten dasselbe wie bei --select-displayed. Diese Einstellung ist die Standardeinstellung.

Playlist-Befehle:

--playlist-advance

Springen Sie zum nächsten Song in der Playlist.

--playlist-reverse

Springen Sie zum vorherigen Lied in der Wiedergabeliste.

--playlist-addurl path

Fügen Sie am Ende der Wiedergabeliste ein Lied hinzu. Es kann entweder ein URI oder ein lokaler Dateipfad (absolut oder relativ) angegeben werden.

--playlist-insurl path position

Fügen Sie einen Song an der angegebenen Position (einsbasiert) in die Playlist ein.

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

Fügen Sie der Wiedergabeliste „Aktuelle Wiedergabe“ ein Lied hinzu, erstellen Sie ggf. die Wiedergabeliste und beginnen Sie mit der Wiedergabe des Liedes. Abhängig von den Audacious-Einstellungen wird die Wiedergabeliste möglicherweise zuerst gelöscht.

--playlist-delete position

Entfernen Sie den Song an der angegebenen Position aus der Playlist.

--playlist-length

Drucken Sie die Anzahl der Songs in der Playlist aus.

--playlist-song position

Drucken Sie den formatierten Titel eines Songs in der Playlist.

--playlist-song-filename position

Drucken Sie den Dateinamen (vollständiger Pfad oder URI) eines Songs in der Playlist.

--playlist-song-length position

Drucken Sie die Länge eines Songs in der Playlist im M:SS-Format.

--playlist-song-length-seconds position

Gibt die Länge eines Songs in der Playlist in Sekunden aus.

--playlist-song-length-frames position

Gibt die Länge eines Songs in der Playlist in Millisekunden aus.

--playlist-tuple-data field position

Gibt den Wert eines benannten Felds für einen Song in der Playlist aus.

--playlist-display

Drucken Sie die Titel aller Songs in der Playlist aus.

--playlist-position

Drucken Sie die Position des aktuellen Songs in der Playlist.

--playlist-jump position

Springen Sie zum Song an der angegebenen Position in der Playlist.

--playlist-clear

Löschen Sie die Wiedergabeliste.

--playlist-auto-advance-status

Drucken Sie den Status des automatischen Vorlaufs der Wiedergabeliste („ein“ oder „aus“).

--playlist-auto-advance-toggle

Schalten Sie den automatischen Vorlauf der Wiedergabeliste um.

--playlist-repeat-status

Drucken Sie den Status der Wiedergabelistenwiederholung („ein“ oder „aus“).

--playlist-repeat-toggle

Wiedergabelistenwiederholung umschalten.

--playlist-shuffle-status

Gibt den Status der Playlist-Zufallswiedergabe aus („ein“ oder „aus“).

--playlist-shuffle-toggle

Umschalten der Wiedergabelisten-Zufallswiedergabe.

--playlist-stop-after-status

Drucken Sie die Option „Nach aktuellem Song stoppen“ („Ein“ oder „Aus“).

--playlist-stop-after-toggle

Schalten Sie die Option „Nach aktuellem Song stoppen“ um.

Weitere Playlist-Befehle:

--number-of-playlists

Drucken Sie die Anzahl der geöffneten Playlists aus.

--current-playlist

Gibt die Nummer der aktuellen Playlist aus, wobei „current“ gemäß --select-displayed oder --select-playing interpretiert wird.

--play-current-playlist

Starten Sie die Wiedergabe in der aktuellen Wiedergabeliste und setzen Sie sie nach Möglichkeit ab der zuletzt gespielten Stelle fort. Wenn --select-displayed aktiv ist, kann dieser Befehl verwendet werden, um die Wiedergabe auf die angezeigte Wiedergabeliste umzuschalten.

--set-current-playlist playlist

Zeigt die angegebene Playlist an. Wenn --select-playing aktiv ist und eine andere Playlist abgespielt wird, schaltet dieser Befehl auch die Wiedergabe auf die angegebene Playlist um. Die Option --select-displayed deaktiviert dieses Verhalten.

--current-playlist-name

Drucken Sie den Titel der aktuellen Playlist.

--set-current-playlist-name title

Legen Sie den Titel der aktuellen Wiedergabeliste fest.

--new-playlist

Fügen Sie nach der aktuellen eine neue Playlist ein und wechseln Sie zu dieser, als ob --set-current-playlist verwendet würde.

--delete-current-playlist

Entfernen Sie die aktuelle Wiedergabeliste.

Befehle für die Playlist-Warteschlange:

--playqueue-add position

Fügen Sie den Song an der angegebenen Playlist-Position zur Warteschlange hinzu.

--playqueue-remove position

Entfernen Sie den Song an der angegebenen Playlist-Position aus der Warteschlange.

--playqueue-is-queued position

Gibt einen Exit-Code von 0 (wahr) zurück, wenn sich der Song an der angegebenen Playlist-Position in der Warteschlange befindet.

--playqueue-get-queue-position position

Gibt die Warteschlangenposition des Songs an der angegebenen Playlist-Position aus.

--playqueue-get-list-position position

Gibt die Playlist-Position des Songs an der angegebenen Warteschlangenposition aus.

--playqueue-length

Drucken Sie die Anzahl der Songs in der Warteschlange.

--playqueue-display

Drucken Sie die Titel aller Songs in der Warteschlange.

--playqueue-clear

Löschen Sie die Warteschlange.

Lautstärkeregelung und Equalizer:

--get-volume

Drucken Sie den aktuellen Lautstärkepegel in Prozent.

--set-volume level

Stellen Sie die aktuelle Lautstärke in Prozent ein.

--equalizer-activate [on|off]

Aktivieren oder deaktivieren Sie den Equalizer.

--equalizer-get

Drucken Sie die Equalizer-Einstellungen (Vorverstärker und Verstärkung für alle Bänder) in Dezibel aus.

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

Legen Sie die Equalizer-Einstellungen (Vorverstärker und Verstärkung für alle Bänder) in Dezibel fest.

--equalizer-get-preamp

Drucken Sie die Vorverstärkung des Equalizers in Dezibel aus.

--equalizer-set-preamp preamp

Stellen Sie die Vorverstärkung des Equalizers in Dezibel ein.

--equalizer-get-band band

Drucken Sie die Verstärkung des angegebenen Equalizer-Bandes (0-9) in Dezibel aus.

--equalizer-set-band band gain

Stellen Sie die Verstärkung des angegebenen Equalizer-Bandes (0-9) in Dezibel ein.

Sonstig:

--mainwin-show [on|off]

Blenden Sie das Audacious-Fenster ein oder aus.

--filebrowser-show [on|off]

Blenden Sie das Fenster „Dateien hinzufügen“ ein oder aus.

--jumptofile-show [on|off]

Blenden Sie das Fenster „Zum Lied springen“ ein oder aus.

--preferences-show [on|off]

Blenden Sie das Fenster „Einstellungen“ ein oder aus.

--about-show [on|off]

Blenden Sie das Info-Fenster ein oder aus.

--version

Informationen zur Druckversion.

--plugin-is-enabled plugin

Gibt einen Exit-Code von 0 (wahr) zurück, wenn das angegebene Plugin aktiviert ist. Das Plugin wird mit dem Namen der installierten Datei ohne Ordnerpfad und Suffix angegeben: zum Beispiel crossfade für lib/audacious/Effect/crossfade.so.

--plugin-enable plugin [on|off]

Aktivieren oder deaktivieren Sie das angegebene Plugin. Beachten Sie, dass Schnittstellen- und Ausgabe-Plugins nicht direkt deaktiviert werden können, da jeweils eines davon immer aktiv sein muss. Durch die Aktivierung einer Schnittstelle oder eines Ausgabe-Plugins wird das vorherige Plugin automatisch deaktiviert.

--config-get [section:]name

Drucken Sie den Wert einer Konfigurationseinstellung. Die Verwendung dieses Befehls wird überhaupt nicht unterstützt. Wie man den Abschnitt und den Namen einer bestimmten Einstellung findet, bleibt dem Leser als Übung überlassen.

--config-set [section:]name value

Ändern Sie den Wert einer Konfigurationseinstellung. Dieser Befehl wird nicht unterstützt und ist gefährlich. Es kann unerwartete Nebenwirkungen haben (z. B. den Absturz von Audacious) oder überhaupt keine Wirkung haben. Die Nutzung erfolgt auf eigene Gefahr!

--shutdown

Schalten Sie Audacious aus.

--help

Drucken Sie eine kurze Zusammenfassung der audtool-Befehle.

Den Befehlen kann nach Wahl ein „--“ (lange Optionen im GNU-Stil) vorangestellt werden oder nicht.

Fehler

Derzeit sind keine Fehler in audtool bekannt. Wenn Sie welche finden, melden Sie sie bitte unter https://redmine.audacious-media-player.org/projects/audacious.

AUTOREN

audtool wurde von George Averill und Ariadne Conill geschrieben.

Diese Handbuchseite wurde von Adam Cecile und Kiyoshi Aman geschrieben. Einige zusätzliche Optimierungen wurden von Ariadne Conill und Tony Vroon vorgenommen. Die Handbuchseite wurde für Audacious 3.7 und höher von John Lindgren aktualisiert.

Dieses Werk ist unter einer Creative Commons Attribution 3.0 Unported License lizenziert.

SIEHE AUCH

audacious(1)

WEBSEITE

https://audacious-media-player.org