Recently testing.bitlbee.org was down for more than a day so I decided to create my own Bitlbee gateway
====== Install ======
Well, nothing special.
====== Configuration ======
===== Server config =====

All of this takes place in /etc/bitlbee/bitlbee.conf
<code>
RunMode = Daemon

User = bitlbee

DaemonInterface = 0.0.0.0
DaemonPort = 6667

AuthMode = Open                                                              
#AuthMode = Registered

</code>
Once registered, you can switch the Authmode to Registered
===== System =====

<code bash>chown -R bitlbee:bitlbee /var/lib/bitlbee</code>
Then start the bitlbee daemon.
<code bash>systemctl start bitlbee</code>
You can also enable the bitlbee daemon to run on startup like so:
<code bash>systemctl enable bitlbee</code>

====== Service ======
===== Register =====
First thing to do, connect via your IRC client, then go to the &bitlbee channel:
<code>
register
/oper
<enter a nice password>
</code>
Should display:
<code>@root -> Account successfully created</code>afortier
Now you can switch the AuthMode (see above)
===== Add accounts =====
==== Jabber ====
<code>
account add jabber me@myself.com P4ssw0rd
</code>
==== Facebook ====
I recommend using the bitlbee-facebook plugin (see References below)
<code>
account add facebook <your email> <your password>
account <number> on
</code>

==== Google Talk ====
:!: Group chat / Hangout is NOT supported :!:
<code>
account add jabber me@gmail.com
</code>
Output:
<code>
@root -> Account successfully added with tag gtalk
@root -> You can now use the /OPER command to enter the password
@root -> Alternatively, enable OAuth if the account supports it: account gtalk set oauth on
</code>
OAuth is your friend!
<code>
account gtalk set oauth on
</code>
Output:
<code>
@root -> oauth = `on'
</code>
Activate the account:
<code>
account gtalk on
</code>
A new window opens called 'jabber_oauth' with a huge link that opens a Google page. You have to authorize Bitlbee then paste the code from the text field in this new window. Once pasted, the following message appears in 'jabber_oauth': jabber_oauth is offline and in &bitlbee:
<code>
@root -> gtalk - Logging in: Starting OAuth authentication
@root -> gtalk - Logging in: Requesting OAuth access token
@root -> gtalk - Logging in: Connecting
@root -> gtalk - Logging in: Connected to server, logging in
@root -> gtalk - Logging in: Converting stream to TLS
@root -> gtalk - Logging in: Connected to server, logging in
@root -> gtalk - Logging in: Authentication finished
@root -> gtalk - Logging in: Server changed session resource string to `BitlBee666777888'
@root -> gtalk - Logging in: Authenticated, requesting buddy list
@root -> gtalk - Logging in: Logged in
</code>

===== Useful Commands =====
==== Accounts ====
  * List <code> account list</code>
  * Delete <code> account <number> del</code>
  * Connect/Disconnect <code> account <number - optional> on</code> Will connect them all if no number is given
  * Change password <code>account <number> set password <new_password> </code>
  * Tags <code> account <number> set tag <new tag> </code>
  * Settings <code> account <number> set </code>
==== Nick ====
  * Info <code>info <nick> Nice for the nicknames of Google</code>
  * Rename <code>rename <nick> <new nick> </code>
  * List \\ 2 ways:
     * <code> /names</code>
     * <code> blist </code>
==== Requests ====
  * List <code> qlist</code>
</code>

====== IRSSI integration ======
If you have a nice IRSSI, you can add these nice commands:
===== Identify =====
<code>
/channel add -auto -botcmd '/say identify\; /oper' &bitlbee bitlbee
/save
</code>

====== OTR ======
FIXME To be completed/tested

====== References ======
  * [[https://wiki.archlinux.org/index.php/Bitlbee]]
  * [[http://510x.se/notes/posts/Install_and_setup_BitlBee/]]
  * [[https://subfictional.com/2013/05/09/how-to-install-bitlbee-irc-to-chat-and-twitter-gateway-on-ubuntu/]]
  * [[https://wiki.bitlbee.org/]]
  * [[https://wiki.bitlbee.org/FAQ]]
  * [[https://wiki.bitlbee.org/ChangingPasswords]]
  * [[https://github.com/jgeboski/bitlbee-facebook]]
  * [[https://help.ubuntu.com/community/Bitlbee]]
  * [[https://wiki.bitlbee.org/bitlbee-otr]]
  * [[https://www.bitlbee.org/user-guide.html#cmd_add]]