MC-TOOL(1)

💖 MC-TOOL(1) — the Utilities manual, bestie edition 💖

okay so listen. this is mc-tool, from the Utilities section of the manual, and it is literally the way you talk to Mission Control accounts from the command line. no GUI, no vibes-based clicking, just you and your terminal being iconic together. 🫶

---

✨ NAME ✨

mc-tool — manipulate Mission Control accounts from the command line

---

🌸 SYNOPSIS 🌸

mc-tool list

mc-tool add PROFILE DISPLAY-NAME [PARAMETER-SETTINGS...]

mc-tool add MANAGER/PROTOCOL [PARAMETER-SETTINGS...]

mc-tool update ACCOUNT [PARAMETER-SETTINGS...]

mc-tool display ACCOUNT DISPLAY-NAME

mc-tool nick ACCOUNT NICKNAME

mc-tool service ACCOUNT SERVICE-NAME

mc-tool icon ACCOUNT ICON

mc-tool show ACCOUNT

mc-tool get ACCOUNT PARAMETER [PARAMETER...]

mc-tool auto-presence ACCOUNT STATUS [MESSAGE]

mc-tool request ACCOUNT STATUS [MESSAGE]

mc-tool auto-connect ACCOUNT on|off

mc-tool remove ACCOUNT

---

🦋 DESCRIPTION 🦋

the way mc-tool behaves depends entirely on its first argument, which we're calling the "command". that first word is the whole personality of the call, so pick it with intention. 💅

🎀 SPECIFYING ACCOUNTS 🎀

whenever something needs an account name, you've got two options and both are valid, bestie:

• you can hand over the full object path, like /org/freedesktop/Telepathy/Account/gabble/jabber/example
• or you can just give the unique account-specific suffix, like gabble/jabber/example

short version, long version, both slay. ✨

🍓 SPECIFYING PARAMETER SETTINGS 🍓

so many of these commands take arguments that represent Telepathy connection manager parameters (go check the Telepathy Specification if you want the full lore on those). every one of those arguments looks exactly like this:

TYPE:NAME=VALUE

breaking it down, because we love clarity:

• TYPE is one of int, uint, bool, or string — yes, other parameter types exist out there in the world, but mc-tool is currently unsupported for those, so don't come for her about it 😭
• NAME is the name of the connection manager parameter, like account or password
• VALUE is the parameter's value, with integers in decimal and booleans as 0 or 1

also!! the update command has its own extra lil trick: it also accepts arguments shaped like clear:NAME, and those delete the named parameter from the account configuration. poof. gone. 🙈

---

👑 LIST 👑

mc-tool list lists the available accounts.

like a lil roster of everyone you know. 📋

---

🔥 ADD 🔥

mc-tool add adds an account.

and here's the cute part — the connection manager and protocol can be given either:

• as the name of a Mission Control profile, e.g. gtalk
• or as a slash-separated connection manager name and protocol, e.g. gabble/jabber

either way you're getting a whole new account, periodt. 💖

---

🌈 DISPLAY 🌈

mc-tool display ACCOUNT DISPLAY-NAME sets the DisplayName property of ACCOUNT to DISPLAY-NAME.

---

💜 NICK 💜

mc-tool nick ACCOUNT NICKNAME sets the Nickname property of ACCOUNT to NICKNAME.

---

🧚 SERVICE 🧚

mc-tool service ACCOUNT SERVICE-NAME sets the Service property of ACCOUNT to SERVICE-NAME.

---

⭐ ICON ⭐

mc-tool icon ACCOUNT ICON sets the Icon property of ACCOUNT to ICON.

---

🌸 SHOW 🌸

mc-tool show ACCOUNT shows information about ACCOUNT.

receipts, basically. 💅

---

🦋 GET 🦋

mc-tool get ACCOUNT PARAMETER [PARAMETER...] shows the values of the given parameters of ACCOUNT.

note that you can pass as many PARAMETERs as you want. go off. ✨

---

🎀 ENABLE 🎀

mc-tool enable ACCOUNT sets the Enabled property of ACCOUNT to True.

---

💀 DISABLE 💀

mc-tool disable ACCOUNT sets the Enabled property of ACCOUNT to False.

---

💖 AUTO-PRESENCE 💖

mc-tool auto-presence ACCOUNT STATUS [MESSAGE] sets the AutomaticPresence property of ACCOUNT to STATUS, with an optional message MESSAGE.

---

🔥 REQUEST 🔥

mc-tool request ACCOUNT STATUS [MESSAGE] sets the RequestedPresence property of ACCOUNT to STATUS, with an optional message MESSAGE.

and like — this is how you tell an account to connect or go offline, for example. main character move, honestly. 👑

---

🌈 AUTO-CONNECT 🌈

• mc-tool auto-connect ACCOUNT on — sets the ConnectAutomatically property of ACCOUNT to True
• mc-tool auto-connect ACCOUNT off — sets it to False

---

psst, bestie — mc-tool remove ACCOUNT is in the synopsis up top, so it's very much part of the vibe check. 🫶

---

and that's the whole page!! this absolute gem came to you from Telepathy, dated July 2009 — yeah, she's vintage, she's iconic, and she still eats. 💅✨

stay safe, read your parameters carefully, and go connect some accounts fr fr 🎀🦋💖