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¶
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.