mc-tool1
Manipulate mission control accounts from the command line
Usage
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
Overview
mc-tool's usage depends on its first argument (the "command")
Specifying accounts
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 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.
List
mc-tool list lists the available accounts.
Add
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 (e.g. gabble/jabber).
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.
Get
mc-tool get ACCOUNT PARAMETER [PARAMETER...] shows the values of the given parameters of ACCOUNT.
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 optional message MESSAGE.
Request
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.
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.
Releases
9 releases since Debian 6.0 (Squeeze); the text changed 1 time.