EXFALSO(1)

💖 EXFALSO — the audio tag editor bestie 💖

okay so this is the man page for exfalso, and it's a whole mood. it lives in section 1 of your manual, and it's literally about making your music files look cute on the inside. let's get into it 🎀

---

✨ NAME ✨

exfalso — audio tag editor, no cap 🎵💅

---

✨ SYNOPSIS ✨

exfalso [ directory ]

that's it. that's the whole summoning ritual. so simple. iconic.

---

✨ DESCRIPTION ✨

Ex Falso displays and edits audio metadata tags. like, it shows you the tags and then lets you ✨fix✨ them. the formats it fucks with are:

• MP3
• Ogg Vorbis
• FLAC
• Musepack (MPC)
• WavPack
• MOD/XM/IT

heads up bestie: this man page is only a short reference for Ex Falso. it is not the full lore. the complete documentation is sitting right here, waiting for you: https://quodlibet.readthedocs.io/en/latest/guide/

---

✨ OPTIONS ✨

so there's really only one thing to say here:

• a directory — Ex Falso may be given a directory to open on the command line. that's it. that's the option. she's low-maintenance like that 🦋

---

✨ TIED TAGS ✨

okay this is the part that's giving ✨main character energy✨ so pay attention bestie 💖

lots of places in Ex Falso let you use "tied tags". a tied tag is just two tag names joined together with a ~, like title~version or album~part.

and the why is so good: tied tags give you "nice" displays even when one of the tags is missing. for example, title~version will show you Title - Version when a version tag is present... but only Title when it isn't. no awkward dangling dash. no empty space. she just adapts 😌

and you can tie any number of tags together. as many as you want. go off. 🌸

---

✨ RENAMING FILES ✨

Ex Falso lets you rename files based on their tags. super handy. but sometimes you wanna change the filename depending on whether some tags are present or missing — not just based on their values. relatable honestly.

a common pattern might be:

<tracknumber>. <title~version>

you can use a | to only show text when a tag is present:

<tracknumber|<tracknumber>. ><title~version>

and you can also specify literal text to use if the tag is missing by adding another |:

<album|<album>|No Album> - <title>

look at that. two little pipes doing so much work. the way that 🫶

see https://quodlibet.readthedocs.io/en/latest/guide/renaming_files.html for the full tea.

---

✨ BUGS ✨

found a bug? want a feature? don't suffer in silence bestie 😭

see https://github.com/quodlibet/quodlibet/issues for a list of all currently open bugs and feature requests.

---

✨ AUTHORS ✨

Joe Wreschnig and Michael Urman are the primary authors of Ex Falso. kings. legends. we stan 👑

---

✨ SEE ALSO ✨

• https://quodlibet.readthedocs.io/en/latest/guide/
• https://quodlibet.readthedocs.io/en/latest/guide/faq.html

---

aaaand that's the whole page bestie 💜 that was the EXFALSO(1) manual page, top to bottom — no version number, no date stamp, just vibes and tags. go forth and tag ur music, you absolute icon 🌈⭐💖