Project

General

Profile

Bip » History » Version 23

Pierre-Louis Bonicoli, 2017-08-07 22:58
Update "getting the code" section

1 1 Pierre-Louis Bonicoli
h1. About
2 1 Pierre-Louis Bonicoli
3 9 Pierre-Louis Bonicoli
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.
4 7 Pierre-Louis Bonicoli
5 7 Pierre-Louis Bonicoli
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.
6 3 Pierre-Louis Bonicoli
7 10 Pierre-Louis Bonicoli
h2. Features
8 6 Pierre-Louis Bonicoli
9 16 Pierre-Louis Bonicoli
There are many [[Features|features]] !
10 4 Pierre-Louis Bonicoli
11 10 Pierre-Louis Bonicoli
h2. Basic usage
12 4 Pierre-Louis Bonicoli
13 4 Pierre-Louis Bonicoli
* Copy sample bip.conf file found in tarball in ~/.bip/bip.conf
14 1 Pierre-Louis Bonicoli
* Edit according to your needs
15 4 Pierre-Louis Bonicoli
* Setup your favorite IRC client to connect to bip, and setup a IRC password according to the format “bip_username:bip_password:connection_id”
16 4 Pierre-Louis Bonicoli
17 4 Pierre-Louis Bonicoli
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”.
18 5 Pierre-Louis Bonicoli
19 1 Pierre-Louis Bonicoli
h2. Documentation
20 10 Pierre-Louis Bonicoli
21 5 Pierre-Louis Bonicoli
Here is the bip documentation:
22 14 Pierre-Louis Bonicoli
* bip [[FAQ]]
23 5 Pierre-Louis Bonicoli
* bip README: source:README
24 1 Pierre-Louis Bonicoli
* bip.conf manual page: source:bip.conf.5
25 1 Pierre-Louis Bonicoli
* bip manual page: source:bip.1
26 1 Pierre-Louis Bonicoli
* bipmkpw manual page: source:bipmkpw.1
27 11 Pierre-Louis Bonicoli
* [[old_news|Old news]]
28 5 Pierre-Louis Bonicoli
29 19 Pierre-Louis Bonicoli
Blog posts which talk about bip:
30 22 Pierre-Louis Bonicoli
* "Creating an EC2 IRC Proxy with bip":http://sickbits.net/creating-an-ec2-irc-proxy-with-bip/ _Keywords: EC2, Limechat_ (Synner, June 2014)
31 20 Pierre-Louis Bonicoli
*  "BIP IRC Proxy":https://stevengorrell.com/bip-irc-proxy/ _Keywords: Ubuntu installation, X-Chat2, Colloquy_ (Steven Gorrell, August 2013)
32 20 Pierre-Louis Bonicoli
* "how to bip":https://wiki.linaro.org/Resources/HowTo/BIP _Keywords: XChat_ (Linaro, August 2012)
33 20 Pierre-Louis Bonicoli
* "Admin BIP (IRC Proxy) remotely":http://situmam.blogspot.fr/2012/03/admin-bip-irc-proxy-remotely.html (Anmar Oueja, March 2012)
34 20 Pierre-Louis Bonicoli
* "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)
35 20 Pierre-Louis Bonicoli
* "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)
36 20 Pierre-Louis Bonicoli
* "Bip: IRC proxying":http://www.happyassassin.net/2010/01/19/bip-irc-proxying/ (Adam Williamson, January 2010)
37 19 Pierre-Louis Bonicoli
* "Configuring pidgin to work with BIP":http://fredinfinite23.wordpress.com/2009/07/28/configuring-pidgin-to-work-with-bip/ (Frederic Plourde, July 2009)
38 19 Pierre-Louis Bonicoli
39 10 Pierre-Louis Bonicoli
h2. Getting the code
40 10 Pierre-Louis Bonicoli
41 23 Pierre-Louis Bonicoli
* Git repository:
42 23 Pierre-Louis Bonicoli
43 23 Pierre-Louis Bonicoli
 * Either using "DuckCorp CA":http://ca.duckcorp.org/
44 23 Pierre-Louis Bonicoli
45 23 Pierre-Louis Bonicoli
  # install "DuckCorp CA":https://users.duckcorp.org/upload/b/b5/Duckcorp.crt
46 23 Pierre-Louis Bonicoli
  # use @git clone https://vcs-git.duckcorp.org/projects/bip/bip.git@
47 23 Pierre-Louis Bonicoli
48 23 Pierre-Louis Bonicoli
 * or using Git protocol: @git clone git://vcs-git.duckcorp.org/projects/bip/bip.git@
49 23 Pierre-Louis Bonicoli
50 23 Pierre-Louis Bonicoli
 * or disabling the verification of the SSL certificate: @GIT_SSL_NO_VERIFY=1 git clone https://vcs-git.duckcorp.org/projects/bip/bip.git@
51 23 Pierre-Louis Bonicoli
52 23 Pierre-Louis Bonicoli
* Download "Released tarballs":https://projects.duckcorp.org/projects/bip/files
53 23 Pierre-Louis Bonicoli
54 8 Pierre-Louis Bonicoli
55 8 Pierre-Louis Bonicoli
h2. License
56 8 Pierre-Louis Bonicoli
57 8 Pierre-Louis Bonicoli
Bip is open source and released under the terms of the GNU General Public License v2 (source:COPYING).
58 15 Pierre-Louis Bonicoli
59 15 Pierre-Louis Bonicoli
h2. IRC channel 
60 15 Pierre-Louis Bonicoli
61 15 Pierre-Louis Bonicoli
* #bip on "OFTC":http://www.oftc.net