MU-BOOKMARKS(5)

📦
version 1.14.2 · 10 versions
, in ubuntu stonking

🌸 MU-BOOKMARKS(5) 🌸

okay bestie, welcome to section 5 of the File Formats Manual — it's giving "tiny file, huge power", and honestly? iconic. this page is about mu-bookmarks, the file that holds your bookmarks (a.k.a. shortcuts) for mu search expressions. 💅

✨ NAME ✨

mu-bookmarks — a whole file of bookmarks (shortcuts) for your mu search expressions. that's it, that's the girl. 🎀

🦋 DESCRIPTION 🦋

so like. bookmarks are named shortcuts for search queries, periodt. you get to slap a cute convenient name on a query you type over and over, and then never type the long version again. main character energy fr fr. ✨

and not me forgetting the best part — these bookmarks also show up as shortcuts in mu's experimental user interfaces, mug and mug2. lowkey obsessed. 👑

the bookmarks file gets read from <muhome>/bookmarks. on Unix that's typically ~/.config/mu/bookmarks, but heads up — you can influence that using the --muhome parameter for mu-find(1). so it's not locked in, you have options, we love that for you. 💖

the bookmarks file is a typical key=value .ini-file, and ngl the best way to show you is literally just an example:

[mu]
inbox=maildir:/inbox                  # inbox
oldhat=maildir:/archive subject:hat   # archived with subject containing 'hat'
⚠️ okay so the [mu] group header is required. like, mandatory mandatory. don't skip it, bestie, the file will simply not vibe without it.

for practical uses of bookmarks, go see mu-find(1). iykyk. 🫶

💜 AUTHOR 💜

Dirk-Jan C. Binnema <djcb@djcbsoftware.nl>

this manpage is part of mu 1.14.2. 💖

Copyright © 2008-2026 Dirk-Jan C. Binnema. License GPLv3+: GNU GPL version 3 or later https://gnu.org/licenses/gpl.html. This is free software: you are free to change and redistribute it. There is NO WARRANTY, to the extent permitted by law. (say it louder for the people in the back 📢)

👑 SEE ALSO 👑

and that's the whole page, bestie — thanks for reading all the way to the bottom, you're a real one 🥹✨ this was MU BOOKMARKS(5) from the mu 1.14.2 era, section 5 of the File Formats Manual, signing off with a lil 🎀 and a reminder that the [mu] header is required. mwah. 💋

📦 where this page comes from