MU-ADD(1)

📦
version 1.14.2 · 11 versions
, in ubuntu stonking

💖 NAME 💖

okay so mu-add — it adds one or more messages to the database. that's it, that's the whole vibe ✨

🦋 SYNOPSIS 🦋

mu [COMMON-OPTIONS] add [OPTIONS] FILE...

🌸 DESCRIPTION 🌸

so mu add is literally the command for adding specific message files to your database, bestie. but heads up — every single file has to be specified with an absolute path. no relative paths, no shortcuts, no "but it's right there in my cwd" energy. absolute. path. periodt 💅

🎀 ADD OPTIONS 🎀

  • --muhome — use a non-default directory to store and read the database, write the logs, whatever else needs a home. by default mu follows the XDG Base Directory Specification (so like, on GNU/Linux it defaults to ~/.cache/mu and ~/.config/mu). earlier versions of mu defaulted to ~/.mu, which now means you gotta say --muhome=~/.mu if that's still your thing 🙈

the environment variable MUHOME can be used as an alternative to --muhome. and the latter has precedence — so --muhome wins the vibe check if they ever disagree 👑

✨ COMMON OPTIONS ✨

  • -d, --debug — makes mu generate extra debug information, which is useful for debugging the program itself. where does it go? to the standard logging location; peep mu(1) for that 🫶
  • -q, --quiet — causes mu to not output informational messages and progress information to standard output, but only to the log file. error messages will still be sent to standard error, so don't worry, you won't be totally ghosted. also note that mu index is much faster with --quiet, so it's recommended you use this option when using mu from scripts etc. scripts girlies rise up 🔥
  • --log-stderr — causes mu to not output log messages to standard error, in addition to sending them to the standard logging location. yes, that's the actual wording, read it twice, it's giving double negative 💀
  • --nocolor — do not use ANSI colors. the environment variable NO_COLOR can be used as an alternative to --nocolor. monochrome era, we respect it 🌈
  • -V, --version — prints mu version and copyright information. the receipts, basically.
  • -h, --help — lists the various command line options. your bestie when you forget everything.

👑 EXIT CODE 👑

this command returns 0 upon successful completion, or a non-zero exit code otherwise. here's the whole roster, no gatekeeping:

  1. 0 — success 🎉
  2. 2 — no matches found. try a different query 😭
  3. 11 — database schema mismatch. you need to re-initialize mu, see mu-init(1) 💀
  4. 19 — failed to acquire lock. some other program has exclusive access to the mu database 🙈
  5. 99 — caught an exception ⚠️

💜 REPORTING BUGS 💜

please report bugs at https://github.com/djcb/mu/issues. we love a bug report, fr fr 🐛

🌟 AUTHOR 🌟

Dirk-Jan C. Binnema <djcb@djcbsoftware.nl> — king behavior, no cap 👑

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.

🌈 SEE ALSO 🌈

mu(1), mu-index(1), mu-remove(1)

and that's the whole page babes 🫶 this one's MU ADD(1) from the General Commands Manual, serving mu 1.14.2 realness — go forth and add your messages to that database, you absolute icon 💅✨🎀

📦 where this page comes from