SYNOPSIS
audtool command [parameter ...] ...
DESCRIPTION
audtool sends commands to a running instance of Audacious.It can send many common commands, such as to skip to the next song in the playlist, and can also print status information, such as the title of the current song.
COMMANDS
Current song information:
- --current-song
- Print the formatted title of the current song. Depending on Audacious settings, this may include information such as the artist and album name. To print only the song title, use --current-song-tuple-data title instead.
- --current-song-filename
- Print the file name (full path or URI) of the current song.
- --current-song-length
- Print the length of the current song in M:SS format.
- --current-song-length-seconds
- Print the length of the current song in seconds.
- --current-song-length-frames
- Print the length of the current song in milliseconds.
- --current-song-output-length
- Print the playback time counter in M:SS format.
- --current-song-output-length-seconds
- Print the playback time counter in seconds.
- --current-song-output-length-frames
- Print the playback time counter in milliseconds.
- --current-song-bitrate
- Print the streaming bitrate in bits per second.
- --current-song-bitrate-kbps
- Print the streaming bitrate in kilobits per second (1 kilobit = 1000 bits).
- --current-song-frequency
- Print the sampling rate in hertz.
- --current-song-frequency-khz
- Print the sampling rate in kilohertz.
- --current-song-channels
- Print the number of audio channels.
- --current-song-tuple-data field
- Print the value of a named field (artistFR, year, genre, etc.) for the current song. If the field name is omitted, a list of allowed fields will be printed.
- --current-song-info
-
Print the streaming bitrate, sampling rate, and number of audio channels.
Playback commands:
- --playback-play
- Start playback. If paused, playback will resume from the same point. If already active and not paused, it will restart from the beginning of the song.
- --playback-pause
- Pause playback, or resume if already paused.
- --playback-playpause
- Equivalent to --playback-pause if playback is active, otherwise --playback-play.
- --playback-stop
- Stop playback.
- --playback-playing
- Return an exit code of 0 (true) if playback is active.
- --playback-paused
- Return an exit code of 0 (true) if playback is paused.
- --playback-stopped
- Return an exit code of 0 (true) if playback is not active.
- --playback-status
- Print the playback status (``playing'', ``paused'', or ``stopped'').
- --playback-seek time
- Seek to the given time in seconds, relative to the beginning of the song.
- --playback-seek-relative time
-
Seek to the given time in seconds, relative to the current time counter.
Playlist commands:
- --playlist-advance
- Skip to the next song in the playlist.
- --playlist-reverse
- Skip to the previous song in the playlist.
- --playlist-addurl path
- Add a song to end of the playlist. Either a URI or a local file path (absolute or relative) may be given.
- --playlist-insurl path position
- Insert a song at the given position (one-based) in the playlist.
- --playlist-addurl-to-new-playlist path
- Add a song to the ``Now Playing'' playlist, creating the playlist if necessary, and begin to play the song. Depending on Audacious settings, the playlist may first be cleared.
- --playlist-delete position
- Remove the song at the given position from the playlist.
- --playlist-length
- Print the number of songs in the playlist.
- --playlist-song position
- Print the formatted title of a song in the playlist.
- --playlist-song-filename position
- Print the file name (full path or URI) of a song in the playlist.
- --playlist-song-length position
- Print the length of a song in the playlist in M:SS format.
- --playlist-song-length-seconds position
- Print the length of a song in the playlist in seconds.
- --playlist-song-length-frames position
- Print the length of a song in the playlist in milliseconds.
- --playlist-tuple-data field position
- Print the value of a named field for a song in the playlist.
- --playlist-display
- Print the titles of all the songs in the playlist.
- --playlist-position
- Print the position of the current song in the playlist.
- --playlist-jump position
- Skip to the song at the given position in the playlist.
- --playlist-clear
- Clear the playlist.
- --playlist-auto-advance-status
- Print the status of playlist auto-advance (``on'' or ``off'').
- --playlist-auto-advance-toggle
- Toggle playlist auto-advance.
- --playlist-repeat-status
- Print the status of playlist repeat (``on'' or ``off'').
- --playlist-repeat-toggle
- Toggle playlist repeat.
- --playlist-shuffle-status
- Print the status of playlist shuffle (``on'' or ``off'').
- --playlist-shuffle-toggle
- Toggle playlist shuffle.
- --playlist-stop-after-status
- Print the ``stop after current song'' option (``on'' or ``off'').
- --playlist-stop-after-toggle
-
Toggle the ``stop after current song'' option.
More playlist commands:
- --number-of-playlists
- Print the number of open playlists.
- --current-playlist
- Print the number of the current playlist. When a song is playing, the current playlist is defined as the playlist containing that song. Otherwise, it is the playlist currently displayed in Audacious.
- --play-current-playlist
- Start playback. If paused or previously stopped in the middle of a song, playback will resume from the last point played. There is no effect if playback is already active and not paused.
- --set-current-playlist playlist
- Switch to the given playlist. If another playlist is playing, playback will switch to this one, resuming from the last point played. If playback is currently paused, it will remain so after the switch.
- --current-playlist-name
- Print the title of the current playlist.
- --set-current-playlist-name title
- Set the title of the current playlist.
- --new-playlist
- Insert a new playlist after the current one and switch to it as if --set-current-playlist were used.
- --delete-current-playlist
-
Remove the current playlist. Playback, if active, will be stopped.
Playlist queue commands:
- --playqueue-add position
- Add the song at the given playlist position to the queue.
- --playqueue-remove position
- Remove the song at the given playlist position from the queue.
- --playqueue-is-queued position
- Return an exit code of 0 (true) if the song at the given playlist position is in the queue.
- --playqueue-get-queue-position position
- Print the queue position of the song at the given playlist position.
- --playqueue-get-list-position position
- Print the playlist position of the song at the given queue position.
- --playqueue-length
- Print the number of songs in the queue.
- --playqueue-display
- Print the titles of all the songs in the queue.
- --playqueue-clear
-
Clear the queue.
Volume control and equalizer:
- --get-volume
- Print the current volume level in percent.
- --set-volume level
- Set the current volume level in percent.
- --equalizer-activate [on|off]
- Activate or deactivate the equalizer.
- --equalizer-get
- Print the equalizer settings (preamp and gain for all bands) in decibels.
- --equalizer-set preamp band0 band1 band2 band3 band4 band5 band6 band7 band8 band9
- Set the equalizer settings (preamp and gain for all bands) in decibels.
- --equalizer-get-preamp
- Print the equalizer pre-amplification in decibels.
- --equalizer-set-preamp preamp
- Set the equalizer pre-amplification in decibels.
- --equalizer-get-band band
- Print the gain of the given equalizer band (0-9) in decibels.
- --equalizer-set-band band gain
-
Set the gain of the given equalizer band (0-9) in decibels.
Miscellaneous:
- --mainwin-show [on|off]
- Show or hide the Audacious window.
- --filebrowser-show [on|off]
- Show or hide the Add Files window.
- --jumptofile-show [on|off]
- Show or hide the Jump to Song window.
- --preferences-show [on|off]
- Show or hide the Settings window.
- --about-show [on|off]
- Show or hide the About window.
- --version
- Print version information.
- --shutdown
- Shut down Audacious.
- --help
- Print a brief summary of audtool commands.
Commands may be prefixed with `--' (GNU-style long options) or not, your choice.
BUGS
There are no known bugs in audtool at this time; if you find any please report them at http://redmine.audacious-media-player.org/projects/audacious.
AUTHORS
audtool was written by George Averill <[email protected]> and William Pitcock <[email protected]>.
This manual page was written by Adam Cecile <[email protected]> and Kiyoshi Aman <[email protected]>. Some additional tweaks were done by William Pitcock <[email protected]> and Tony Vroon <[email protected]>. The manual page was updated for Audacious 3.7 by John Lindgren <[email protected]>.
This work is licensed under a Creative Commons Attribution 3.0 Unported License <http://creativecommons.org/licenses/by/3.0/>.