audtool: A small tool to modify behavior of a running audacious instance.

OPTIONS

Now playing information:

--current-song: Returns current song title.
--current-song-filename: Returns current song filename.
--current-song-length: Returns current song length.
--current-song-length-seconds: Returns current song length in seconds.
--current-song-length-frames: Returns current song length in frames.
--current-song-output-length: Returns current song output length.
--current-song-output-length-seconds: Returns current song output length in seconds.
--current-song-output-length-frames: Returns current song output length in frames.
--current-song-bitrate: Returns current song bitrate in bits per second.
--current-song-bitrate-kbps: Returns current song bitrate in kilobits per second.
--current-song-frequency: Returns current song frequency in hertz.
--current-song-frequency-khz: Returns current song frequency in kilohertz.
--current-song-channels: Returns current song channels.
--current-song-tuple-data <fieldname>: Returns the value of a tuple field for the current song.
--current-song-info: Returns current song bitrate, frequency and channels.

Playlist manipulation:

--playlist-advance: Go to the next song in the playlist.
--playlist-reverse: Go to the previous song in the playlist.
--playlist-addurl <uri>: Adds a URI to the playlist.
--playlist-insurl <uri> <position>: Inserts a URL at specified position in the playlist.
--playlist-delete <position>: Deletes the song at <position> from the playlist.
--playlist-length: Returns the total length of the playlist.
--playlist-song <position>: Returns the title of the song at <position> in the playlist.
--playlist-song-filename <position>: Returns the filename of the song at <position> in the playlist.
--playlist-song-length <position>: Returns the length of the song at <position> in the playlist.
--playlist-song-length-seconds <position>: Returns the length of the song at <position> in the playlist in seconds.
--playlist-song-length-frames <position>: Returns the length of the song at <position> in the playlist in frames.
--playlist-display: Returns the entire playlist.
--playlist-position: Returns the current position in the playlist.
--playlist-jump <position>: Jumps to <position> in the playlist.
--playlist-clear: Clears the playlist.
--playlist-repeat-status: Returns the status of playlist repeat.
--playlist-repeat-toggle: Toggles playlist repeat.
--playlist-shuffle-status: Returns the status of playlist shuffle.
--playlist-shuffle-toggle: Toggles playlist shuffle.
--playlist-stop-after-status: Queries whether the "stop after current song" option is set.
--playlist-stop-after-toggle: Toggles the "stop after current song" option.
--playlist-tuple-data <fieldname> <position>: Returns the value of a tuple field for a song in the playlist.

More playlist manipulation:

--number-of-playlists: Returns the number of open playlists.
--current-playlist: Returns the number of the active playlist.
--set-current-playlist: Activates the specified playlist.
--current-playlist-name: Returns the title of the active playlist.
--set-current-playlist-name: Sets the title of the active playlist.
--new-playlist: Creates a new playlist.
--delete-current-playlist: Removes the active playlist.
--play-current-playlist: Starts or resumes playing the active playlist.

Playqueue manipulation:

--playqueue-add <position>: Adds the song at <position> in the playlist to the playqueue.
--playqueue-remove <position>: Removes the song at <position> in the playlist from the playqueue.
--playqueue-is-queued <position>: Returns OK if the song at <position> in the playlist is queued.
--playqueue-get-position <position>: Returns the playqueue position of the song at <position> in the playlist.
--playqueue-get-queue-position <position>: Returns the playqueue position of a song in the given <position> in the playlist.
--playqueue-get-list-position <position>: Returns the playlist position of a song in the given position in the playqueue.
--playqueue-length: Returns the length of the playqueue.
--playqueue-display: Returns a list of currently-queued songs.
--playqueue-clear: Clears the playqueue.

Playback manipulation:

--playback-play: Starts/unpauses song playback.
--playback-pause: (Un)pauses song playback.
--playback-playpause: Plays/(un)pauses song playback.
--playback-stop: Stops song playback.
--playback-playing: Returns OK if Audacious is playing.
--playback-paused: Returns OK if Audacious is paused.
--playback-stopped: Returns OK if Audacious is stopped.
--playback-status: Returns the playback status.
--playback-seek: Performs an absolute seek in seconds.
--playback-seek-relative: Performs a seek relative to the current position in seconds.

Volume control:

--get-volume: Returns the current volume level in percent.
--set-volume <level>: Sets the current volume level in percent.

Equalizer manipulation:

--equalizer-activate <on/off>: Activates/deactivates the equalizer.
--equalizer-get: Gets the equalizer settings.
--equalizer-set <preamp> <band0> <band1> <band2> <band3> <band4> <band5> <band6> <band7> <band8> <band9>: Sets the equalizer settings.
--equalizer-get-preamp: Gets the equalizer pre-amplification.
--equalizer-set-preamp <preamp>: Gets the equalizer pre-amplification.
--equalizer-get-band <band>: Gets the equalizer value in specified band.
--equalizer-set-band <band> <value>: Sets the equalizer value in specified band.

Miscellaneous:

--mainwin-show <on/off>: Shows/hides the main window.
--filebrowser-show <on/off>: Shows/hides the filebrowser.
--jumptofile-show <on/off>: Shows/hides the jump to file window.
--preferences-show <on/off>: Shows/hides the preferences window.
--about-show <on/off>: Shows/hides the about window.
--version: Displays Audacious version.
--shutdown: Shuts down Audacious.

Help system:

--list-handlers: Shows handlers list.
--help: Shows handlers list.

Handlers may be prefixed with `--' (GNU-style long-options) or not, your choice.

audtool (1)

SYNOPSIS

DESCRIPTION

OPTIONS

BUGS

AUTHORS

RELATED TO audtool…

WEBSITE