MC-TOOL(1) Utilities MC-TOOL(1)
mc-tool – manipulate Mission Control accounts from the command line
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-
mc-tool nick ACCOUNT NICK
mc-tool service ACCOUNT SERVICE-
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
mc-tool’s usage depends on its first argument (the “command”)
Where an account name is needed, it may be given as a full object path
(e.g. /org/freedesktop/Telepathy/Account/gabble/jabber/example), or as
the unique account-specific suffix (e.g. gabble/jabber/example).
SPECIFYING PARAMETER SETTINGS
Many commands take arguments that represent Telepathy connection man‐
ager parameters (see the Telepathy Specification for details of these).
Each argument has the following form:
where TYPE is either int, uint, bool, or string (other parameter types
exist, but are currently unsupported by mc-tool), NAME is the name of
the connection manager parameter (e.g. account or password), and VALUE
is the parameter’s value (with integers in decimal, and booleans as 0
The update command also accepts arguments of the form clear:NAME which
delete the named parameter from the account configuration.
mc-tool list lists the available accounts.
mc-tool add adds an account. The connection manager and protocol can
either be given as the name of a Mission Control profile, (e.g.
gtalk), or as a slash-separated connection manager name and protocol
mc-tool display ACCOUNT DISPLAY-NAME sets the DisplayName property of
ACCOUNT to DISPLAY-NAME.
mc-tool nick ACCOUNT NICKNAME sets the Nickname property of ACCOUNT to
mc-tool service ACCOUNT SERVICE-NAME sets the Service property of
ACCOUNT to SERVICE-NAME.
mc-tool icon ACCOUNT ICON sets the Icon property of ACCOUNT to ICON.
mc-tool show ACCOUNT shows information about ACCOUNT.
mc-tool get ACCOUNT PARAMETER [PARAMETER…] shows the values of the
given parameters of ACCOUNT.
mc-tool enable ACCOUNT sets the Enabled property of ACCOUNT to True.
mc-tool disable ACCOUNT sets the Enabled property of ACCOUNT to False.
mc-tool auto-presence ACCOUNT STATUS [MESSAGE] sets the AutomaticPres‐
ence property of ACCOUNT to STATUS with optional message MESSAGE.
mc-tool request ACCOUNT STATUS [MESSAGE] sets the RequestedPresence
property of ACCOUNT to STATUS with optional message MESSAGE; this is
how you tell an account to connect or go offline, for example.
mc-tool auto-connect ACCOUNT on sets the ConnectAutomatically property
of ACCOUNT to True. mc-tool auto-connect ACCOUNT off sets it to False.
Telepathy July 2009 MC-TOOL(1)