MJMAP(1)

📦
version 1.1.1 · 2 versions
, in nixpkgs unstable

💖 NAME 💖

okay so bestie, welcome to MJMAP(1) — the general commands manual for mjmap, a sendmail-compatible JMAP client. This is your group chat with Unix, and yes, it slays. 💅

✨ SYNOPSIS ✨

mjmap [-h] [--version] [--mailbox <name>] [-c <file>] [-S] [-d] [-t] [-f <from>] [-i] [-X <file>] [<recipient...>]

🎀 POSITIONAL ARGUMENTS 🎀

  • <recipient...> — email address of a recipient to send the message to. Can be specified multiple times. yes bestie, stack those recipients like your fave playlists 💌

💅 OPTIONS 💅

  • -h, --help — show usage help and exit. your lil “what do I do again?” button 🫶
  • --version — print version information and exit. identity check, iconic behavior 👑
  • -S, --server-info — print information about the JMAP server and exit. a little server vibe check 🔍
  • --mailbox=<name> — additional mailbox to add the message to, in addition to Sent. Can be specified multiple times. yes, one message can live in multiple mailboxes — multitasking queen 💅
  • -c, --config=<file> — use the specified configuration file. point it at ur chosen config, bestie 🎀
  • -d, --debug — print lots of debugging information. lore dump mode 😭
  • -t, --read-recipients — read recipient addresses from the To, Cc, and Bcc headers of the mail in addition to the ones specified on the command line. the headers are speaking, and we’re listening 👀
  • -f, --from=<from> — set the envelope From address if it is missing from the email headers. gotta have a sender, no cap 💌
  • -i, --ignore-dots — compatibility with sendmail(1), ignored option. it’s giving “I’m here for the compatibility” 🫠
  • -X, --logfile=<file> — compatibility with sendmail(1), ignored option. also just vibing in the options list ✨

🌸 CONFIGURATION 🌸

The -c, --config option specifies the configuration file. If the option is omitted, mjmap uses the path in MJMAP_CONFIG when set, then falls back to $XDG_CONFIG_HOME/mjmap/config.scfg. You will find a sample configuration file in /usr/share/mjmap/sample_config.scfg. cute, right? 💖

The file format is SCFG: https://git.sr.ht/~emersion/scfg.

Minimal example, literally right here:

account "myaccount" {
session-url "https://api.fastmail.com/jmap/session"
token "my_token"
}

There must be a single account entry (the name does not matter and can even be omitted). Which supports the following configuration fields:

  • session-url "<url>" (mandatory) — the JMAP session endpoint. This is often in the form: "https://<hostname>/.well-known/jmap".
  • token — the secret token used for OAUTH bearer authentication. keep it secret, keep it safe 🫶
  • token-cmd — a command that will print the token value on its standard output to avoid storing it in plain text. The command is executed with sh -c. Example:
token-cmd "pass fastmail/api-token"
  • username — the username for basic authentication.
  • password — the password for basic authentication.
  • password-cmd — a command that will print the password value on its standard output to avoid storing it in plain text. The command is executed with sh -c. Example:
password-cmd "pass foobar/jmap-password"
bestie, if you’re putting secrets in plain text, maybe don’t? the *-cmd options are right there for a reason 💀

🦋 SEE ALSO 🦋

🌈 AUTHORS 🌈

Created by Tim Culverhouse who is assisted by other open source contributors. For more information about mjmap development, see https://git.sr.ht/~rockorager/mjmap. icons supporting icons, fr fr 👑

xoxo bestie — this page is dated 1980-01-01 and signs off as MJMAP(1) 🫶💖

📦 where this page comes from