Currentsonginformation:--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-datatitle 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-datafield
Print the value of a named field (artist, 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.
Playbackcommands:--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-seektime
Seek to the given time in seconds, relative to the beginning of the song.
--playback-seek-relativetime
Seek to the given time in seconds, relative to the current time counter.
--playback-record
Toggle recording of the output stream (using FileWriter).
--playback-recording
Return an exit code of 0 (true) if stream recording is enabled.
Playlistselection:--select-displayed
Specifies that any subsequent playlist commands should apply to the playlist currently displayed
by Audacious, regardless of which playlist is playing. This setting takes effect until it is
overridden by --select-playing or Audacious is restarted.
The following commands are also affected:
--current-song
--current-song-filename
--current-song-length[-seconds,-frames]
--current-song-tuple-data
--select-playing
Specifies that when playback is active, any subsequent playlist commands should apply to the
playlist currently playing. When playback is stopped, the behavior is the same as --select-displayed. This setting is the default.
Playlistcommands:--playlist-advance
Skip to the next song in the playlist.
--playlist-reverse
Skip to the previous song in the playlist.
--playlist-addurlpath
Add a song to end of the playlist. Either a URI or a local file path (absolute or relative) may
be given.
--playlist-insurlpathposition
Insert a song at the given position (one-based) in the playlist.
--playlist-addurl-to-new-playlistpath
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-deleteposition
Remove the song at the given position from the playlist.
--playlist-length
Print the number of songs in the playlist.
--playlist-songposition
Print the formatted title of a song in the playlist.
--playlist-song-filenameposition
Print the file name (full path or URI) of a song in the playlist.
--playlist-song-lengthposition
Print the length of a song in the playlist in M:SS format.
--playlist-song-length-secondsposition
Print the length of a song in the playlist in seconds.
--playlist-song-length-framesposition
Print the length of a song in the playlist in milliseconds.
--playlist-tuple-datafieldposition
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-jumpposition
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.
Moreplaylistcommands:--number-of-playlists
Print the number of open playlists.
--current-playlist
Print the number of the current playlist, where "current" is interpreted according to --select-displayed or --select-playing.
--play-current-playlist
Start playback in the current playlist, resuming from the last point played if possible. When
--select-displayed is in effect, this command can be used to switch playback to the displayed
playlist.
--set-current-playlistplaylist
Display the given playlist. When --select-playing is in effect and a different playlist is
playing, this command will also switch playback to the given playlist. The --select-displayed
option disables this behavior.
--current-playlist-name
Print the title of the current playlist.
--set-current-playlist-nametitle
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.
Playlistqueuecommands:--playqueue-addposition
Add the song at the given playlist position to the queue.
--playqueue-removeposition
Remove the song at the given playlist position from the queue.
--playqueue-is-queuedposition
Return an exit code of 0 (true) if the song at the given playlist position is in the queue.
--playqueue-get-queue-positionposition
Print the queue position of the song at the given playlist position.
--playqueue-get-list-positionposition
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.
Volumecontrolandequalizer:--get-volume
Print the current volume level in percent.
--set-volumelevel
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-setpreampband0band1band2band3band4band5band6band7band8band9
Set the equalizer settings (preamp and gain for all bands) in decibels.
--equalizer-get-preamp
Print the equalizer pre-amplification in decibels.
--equalizer-set-preamppreamp
Set the equalizer pre-amplification in decibels.
--equalizer-get-bandband
Print the gain of the given equalizer band (0-9) in decibels.
--equalizer-set-bandbandgain
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.
--plugin-is-enabledplugin
Return an exit code of 0 (true) if the given plugin is enabled. The plugin is specified using its
installed filename minus the folder path and suffix: for example, crossfade for lib/x86_64-linux-gnu/audacious/Effect/crossfade.so.
--plugin-enableplugin [on|off]
Enable or disable the given plugin. Note that interface and output plugins cannot be disabled
directly since one of each must always be active. Enabling an interface or output plugin will
automatically disable the previous plugin.
--config-get[section:]name
Print the value of a configuration setting. Any use of this command is entirely unsupported. How
to find the section and name of a given setting is left as an exercise for the reader.
--config-set[section:]namevalue
Change the value of a configuration setting. This command is unsupported and dangerous. It might
have unexpected side effects (such as crashing Audacious), or it might have no effect at all. Use
it at your own risk!
--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.
Install Now
PNG Icons
