Bip

h1. About

Bip is an *IRC proxy*, which means it keeps connected to your preferred IRC servers, can store the logs for you, and even send them back to your IRC client(s) upon connection.

You may want to use bip to keep your logfiles (in a unique format and on a unique computer) whatever your client is, when you connect from multiple workstations, or when you simply want to have a playback of what was said while you were away.

h2. Features

There are many [[Features|features]] !

h2. Basic usage

* Copy sample bip.conf file found in tarball in ~/.bip/bip.conf

* Edit according to your needs

* Setup your favorite IRC client to connect to bip, and setup a IRC password according to the format “bip_username:bip_password:connection_id”

Use a single bip session for multiple irc connections. Each bip user can have multiple irc networks to connect to, the connection_id identifies a connection for a user. For example if a user connects on OFTC and efnet, he would configure his client to connect to two servers, all with the same host (the one on which bip is running), and he would set a different irc password for each of the networks. ie “user:pass:OFTC” and “user:pass:efnet”.

h2. Documentation

Here is the bip documentation:

* bip [[FAQ]]

* bip README: source:README

* bip.conf manual page: source:bip.conf.5

* bip manual page: source:bip.1

* bipmkpw manual page: source:bipmkpw.1

* "NEWS":https://projects.duckcorp.org/projects/bip/news (and source:NEWS)

Blog posts which talk about bip:

* "Creating an EC2 IRC Proxy with bip":http://sickbits.net/creating-an-ec2-irc-proxy-with-bip/ _Keywords: EC2, Limechat_ (Synner, June 2014)

*  "BIP IRC Proxy":https://stevengorrell.com/bip-irc-proxy/ _Keywords: Ubuntu installation, X-Chat2, Colloquy_ (Steven Gorrell, August 2013)

* "how to bip":https://wiki.linaro.org/Resources/HowTo/BIP _Keywords: XChat_ (Linaro, August 2012)

* "Admin BIP (IRC Proxy) remotely":http://situmam.blogspot.fr/2012/03/admin-bip-irc-proxy-remotely.html (Anmar Oueja, March 2012)

* "AndroidIRC, bip and SSHTunnel on your Android device ":http://blog.xtremeghost.com/2011/08/androidirc-bip-and-sshtunnel-on-your.html (Juan Negron, August 2011)

* "Keep One SSH Tunnel to a Bip Proxy Server Running":http://blog.dustinkirkland.com/2011/08/keep-one-ssh-tunnel-to-bip-proxy-server.html (Dustin Kirkland, August 2011)

* "Bip: IRC proxying":http://www.happyassassin.net/2010/01/19/bip-irc-proxying/ (Adam Williamson, January 2010)

* "Configuring pidgin to work with BIP":http://fredinfinite23.wordpress.com/2009/07/28/configuring-pidgin-to-work-with-bip/ (Frederic Plourde, July 2009)

h2. Getting the code

* Git repository:

  use @git clone https://vcs-git.duckcorp.org/projects/bip/bip.git@

* Download "Released tarballs":https://projects.duckcorp.org/projects/bip/files

h2. License

Bip is open source and released under the terms of the GNU General Public License v2 (source:COPYING).

h2. IRC channel 

* #bip on "OFTC":http://www.oftc.net