audtool
Command-line interface for controlling the Audacious media player.
TLDR
Get current song
$ audtool current-song
Play/Pause playback$ audtool playback-playpause
Skip to next track$ audtool playlist-advance
Get playback status$ audtool playback-status
Set volume$ audtool set-volume [75]
SYNOPSIS
audtool command [arguments]
DESCRIPTION
audtool is a command-line interface for controlling the Audacious media player. It allows remote control, playlist management, and status queries without opening the GUI.
The tool is useful for scripts, keybindings, and automation.
PARAMETERS
playback-play
Start playbackplayback-pause
Pause playbackplayback-playpause
Toggle play/pauseplayback-stop
Stop playbackplayback-status
Show playback statusplaylist-advance
Next trackplaylist-reverse
Previous trackcurrent-song
Print current song infocurrent-song-filename
Print filename of current songset-volume n
Set volume (0-100)get-volume
Get current volumeplaylist-length
Number of tracks in playlistplaylist-song n
Get song at position n
CAVEATS
Requires Audacious to be running. Commands fail if player is not active. Some features depend on Audacious version.
HISTORY
audtool was developed alongside Audacious to provide scriptable control, continuing the tradition of beep-media-player-control and xmmsctrl.