Your company here — click to reach over 10,000 unique daily visitors

exaile - Man Page

music manager and player


exaile [OPTION...] [LOCATION...]


Launch Exaile, optionally adding tracks specified by LOCATION to the active playlist. If Exaile is already running, this attempts to use the existing instance instead of creating a new one.

Playback Options

-n,  --next

Play the next track

-p,  --prev

Play the previous track

-s,  --stop

Stop playback

-a,  --play


-u,  --pause


-t,  --play-pause

Pause or resume playback


Stop playback after current track

Collection Options


Add tracks from LOCATION to the collection

Playlist Options

--export-playlist LOCATION

Export the current playlist to LOCATION

Track Options

-q,  --query

Query player

--format-query FORMAT

Retrieve the current playback state and track information as FORMAT

--format-query-tags TAGS

Tags to retrieve from the current track; use with --format-query


Show a popup with data of the current track


Print the title of current track


Print the album of current track


Print the artist of current track


Print the length of current track

--set-rating N

Set rating for current track to N%


Get rating for current track


Print the current playback position as time


Print the current playback progress as percentage

Volume Options

-i N, --increase-vol N

Increase the volume by N%

-l N, --decrease-vol N

Decrease the volume by N%

-m,  --toggle-mute

Mute or unmute the volume


Print the current volume percentage

Other Options


Start new instance

-h,  --help

Show this help message and exit


Show program's version number and exit.


Start minimized (to tray, if possible)


Toggle visibility of the GUI (if possible)


Start in safe mode - sometimes useful when you're running into problems


Force import of old data from version 0.2.x (overwrites current data)


Do not import old data from version 0.2.x


Make control options like --play start Exaile if it is not running

--use-lang USELANGUAGE

Locale to use for Exaile

Development/Debug Options

--datadir DIRECTORY

Set data directory

--all-data-dir DIRECTORY

Set data and config directory

--modulefilter MODULE

Limit log output to MODULE

--levelfilter LEVEL

Limit log output to LEVEL


Show debugging output


Enable debugging of xl.event. Generates lots of output


Enable full debugging of xl.event. Generates LOTS of output


Add thread name to logging messages.

--eventfilter TYPE

Limit xl.event debug to output of TYPE


Reduce level of output



Disable D-Bus support


Disable HAL support.


January 2024 Exaile 4.1.3