EXAILE(1)

📦
version 4.2.2 · 8 versions
, in fedora 43, fedora 44

💖 EXAILE 💖 — the music manager & player, section 1 (User Commands)

okay bestie, sit down, hydrate, and let me tell you about exaile — it's a music manager and a player, and it's literally the main character of your desktop, no cap 🎀

✨ SYNOPSIS ✨

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

🌸 DESCRIPTION 🌸

So you launch Exaile, right? And if you toss in some tracks with LOCATION, those get added to the active playlist too — cute, convenient, iconic. 💅

But here's the tea: if Exaile is already running, it doesn't spawn a whole new one. It tries to use the existing instance instead. Teamwork, bestie. 🫶

🎧 Playback Options: the "control the vibes" section

  • -n, --next — skip to the next track, slay
  • -p, --prev — go back to the previous track
  • -s, --stop — stop playback entirely, we're done here
  • -a, --play — play it 🔥
  • -u, --pause — pause it
  • -t, --play-pause — pause or resume, whichever is the vibe rn
  • --stop-after-current — let the current track finish and then stop, so polite of it

🗂️ Collection Options: hoard the music

  • --add LOCATION — add the tracks from LOCATION straight into your collection

📜 Playlist Options: export the whole aesthetic

  • --export-playlist LOCATION — dump your current playlist out to LOCATION

🔍 Track Options: the info dump era

  • -q, --query — query the player
  • --format-query FORMAT — grab the current playback state plus track info, formatted as FORMAT
  • --format-query-tags TAGS — the tags to pull from the current track; use this together with --format-query
  • --gui-query — pop up a little window with the current track's data ✨
  • --get-title — print the title of the current track
  • --get-album — print the album of the current track
  • --get-artist — print the artist of the current track
  • --get-length — print the length of the current track
  • --set-rating N — set the current track's rating to N% ⭐
  • --get-rating — get the current track's rating
  • --current-position — print the current playback position as time
  • --current-progress — print the current playback progress as a percentage

🔊 Volume Options: turn it UP

  • -i, --increase-vol N — bump the volume up by N%
  • -l, --decrease-vol N — bring the volume down by N%
  • -m, --toggle-mute — mute or unmute, flip a coin 🪙
  • --get-volume — print the current volume percentage

🦋 Other Options: the everything-else drawer

  • --new — start a brand new instance
  • -h, --help — show this help message and exit
  • --version — show the program's version number and exit
  • --start-minimized — start minimized (to the tray, if that's even possible)
  • --toggle-visible — toggle the GUI's visibility (again, if possible)
  • --safemode — start in safe mode; sometimes this genuinely helps when you're running into problems 🚑
  • --force-import — force an import of old data from version 0.2.x
⚠️ heads up bestie: this overwrites your current data. like, gone-gone. 😭
  • --no-import — don't import old data from version 0.2.x
  • --start-anyway — makes control options like --play actually start Exaile if it isn't already running
  • --use-lang USELANGUAGE — the locale to use for Exaile

🧪 Development/Debug Options: for when you're in your scientist era

  • --datadir DIRECTORY — set the data directory
  • --all-data-dir DIRECTORY — set both the data and config directory
  • --modulefilter MODULE — limit log output to MODULE
  • --levelfilter LEVEL — limit log output to LEVEL
  • --debug — show debugging output
  • --eventdebug — enable debugging of xl.event
fr fr, this generates lots of output. you've been warned 💀
  • --eventdebug-full — enable full debugging of xl.event
and this one generates LOTS of output. all caps. respect the caps. 🙈
  • --threaddebug — add the thread name to logging messages
  • --eventfilter TYPE — limit the xl.event debug output to TYPE
  • --quiet — reduce the level of output
  • --startgui
  • --no-dbus — disable D-Bus support
  • --no-hal — disable HAL support

and that's the whole page, bestie — every flag, every default, every little detail, untouched and unproblematic 🌈

this was Exaile version 4.2.2, dated April 2026 🎀 ty for reading, mwah 💖 periodt ✨

📦 where this page comes from