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 [instance] command [parameter ...] ...Commands may optionally be prefixed with -- (GNU long-option style); both current-song and --current-song work.
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 songcurrent-song-length
Print length of the current song in M:SS formatset-volume n
Set volume (0-100)get-volume
Get current volumeplaylist-length
Number of tracks in playlistplaylist-song n
Get song at position n
INSTALL
sudo apt install audacious
sudo dnf install audacious
sudo pacman -S audacious
sudo apk add audacious
sudo zypper install audacious
brew install audacious
nix profile install nixpkgs#audacious
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.
