mc-tool's usage depends on its first argument (the "command")
SPECIFYINGACCOUNTS
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).
SPECIFYINGPARAMETERSETTINGS
Many commands take arguments that represent Telepathy connection manager parameters (see the Telepathy
Specification for details of these). Each argument has the following form:
TYPE:NAME=VALUE
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 or 1).
The update command also accepts arguments of the form clear:NAME which delete the named parameter from
the account configuration.
LISTmc-toollist lists the available accounts.
ADDmc-tooladd 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
(e.g. gabble/jabber).
DISPLAYmc-tooldisplayACCOUNTDISPLAY-NAME sets the DisplayName property of ACCOUNT to DISPLAY-NAME.NICKmc-toolnickACCOUNTNICKNAME sets the Nickname property of ACCOUNT to NICKNAME.
SERVICEmc-toolserviceACCOUNTSERVICE-NAME sets the Service property of ACCOUNT to SERVICE-NAME.
ICONmc-tooliconACCOUNTICON sets the Icon property of ACCOUNT to ICON.
SHOWmc-toolshowACCOUNT shows information about ACCOUNT.
GETmc-toolgetACCOUNTPARAMETER [PARAMETER...] shows the values of the given parameters of ACCOUNT.
ENABLEmc-toolenableACCOUNT sets the Enabled property of ACCOUNT to True.
DISABLEmc-tooldisableACCOUNT sets the Enabled property of ACCOUNT to False.
AUTO-PRESENCEmc-toolauto-presenceACCOUNTSTATUS [MESSAGE] sets the AutomaticPresence property of ACCOUNT to STATUS
with optional message MESSAGE.
REQUESTmc-toolrequestACCOUNTSTATUS [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.
AUTO-CONNECTmc-toolauto-connectACCOUNTon sets the ConnectAutomatically property of ACCOUNT to True. mc-toolauto-connectACCOUNToff sets it to False.
Telepathy July 2009 MC-TOOL(1)