A list of bitlbees commands, with syntax and description. Arranged by category.

Bitlbee management

register <password>

BitlBee can save your settings so you won't have to enter all your IM passwords every time you log in. If you want the Bee to save your settings, use the register command. Please do pick a secure password, don't just use your nick as your password. Please note that IRC is not an encrypted protocol, so the passwords still go over the network in plaintext. Evil people with evil sniffers will read it all. (So don't use your root password.. ;-) To identify yourself in later sessions, you can use the identify command. To change your password later, you can use the set password command.

identify [-noload|-force] <password>

BitlBee saves all your settings (contacts, accounts, passwords) on-server. To prevent other users from just logging in as you and getting this information, you'll have to identify yourself with your password. You can register this password using the register command. Once you're registered, you can change your password using set password <password>. The -noload and -force flags can be used to identify when you're logged into some IM accounts already. -force will let you identify yourself and load all saved accounts (and keep the accounts you're logged into already). -noload will log you in but not load any accounts and settings saved under your current nickname. These will be overwritten once you save your settings (i.e. when you disconnect).

drop <password>

Drop your BitlBee registration. Your account files will be removed and your password will be forgotten. For obvious security reasons, you have to specify your NickServ password to make this command work.

IM Account management

account [<account id>] <action> [<arguments>]

Available actions: add, del, list, on, off and set. See help account <action> for more information.

account add <protocol> <username> <password>

Adds an account on the given server with the specified protocol, username and password to the account list. Supported protocols right now are: Jabber, MSN, OSCAR (AIM/ICQ), Yahoo and Twitter. For more information about adding an account, see help account add <protocol>.

account <account id> del

This commands deletes an account from your account list. You should signoff the account before deleting it. The account ID can be a number/tag (see account list), the protocol name or (part of) the screenname, as long as it matches only one connection.

account list

This command gives you a list of all the accounts known by BitlBee.

account [<account id>] on

This command will try to log into the specified account. If no account is specified, BitlBee will log into all the accounts that have the auto_connect flag set. The account ID can be a number/tag (see account list), the protocol name or (part of) the screenname, as long as it matches only one connection.

account [<account id>] off

This command disconnects the connection for the specified account. If no account is specified, BitlBee will deactivate all active accounts and cancel all pending reconnects. The account ID can be a number/tag (see account list), the protocol name or (part of) the screenname, as long as it matches only one connection.

account <account id> set

Other syntaxes include:

Syntax: account <account id> set <setting>
Syntax: account <account id> set <setting> <value>
Syntax: account <account id> set -del <setting>

This command can be used to change various settings for IM accounts. For all protocols, this command can be used to change the handle or the password BitlBee uses to log in and if it should be logged in automatically. Some protocols have additional settings. You can see the settings available for a connection by typing account <account id> set. For more infomation about a setting, see help set <setting>. The account ID can be a number/tag (see account list), the protocol name or (part of) the screenname, as long as it matches only one connection.

Manage IM contacts

===add <account id> <handle> [<nick>]=== Other syntaxs include

add -tmp <account id> <handle> [<nick>]

Source:

This document contains info deived from the help command in biltbee. The first version was based on BitlBee version bzr-devel-689.