C'est quoi ?

Bitlbee est une passerelle de messagerie instantanée. Elle permet de faire un pont entre IRC/ICQ/MSN/Jabber/AIM/Yahoo!… En gros ça vous permet d'utiliser votre client IRC favori et de pouvoir chatter avec vos contacts qui sont sur d'autres réseauxx ! ( qui a dit boulets ? LOL )
Les contacts apparaissent comme des utilisateurs normaux dans un canal et les conversations utilisent la puissance d'IRC pour les messages privés.

Comment qu'on fait ?

C'est très compliqué ! Prévoyez largement 2 minutes.

Installation

# pacman -S bitlbee

ou

$ yaourt -S bitlbee

Configuration (serveur)

Il existe deux façons de procéder, bien sûr, il vous faudra choisir entre l'une ou l'autre (la première est, au passage, plus rapide et récente).

Utiliser bitlbee en tant que démon

Ouvrez /etc/bitlbee/bitlbee.conf. Là, décommentez la ligne « RunMode » et modifiez là comme suit :

RunMode = ForkDaemon

Décommentez aussi la ligne suivante :

User = bitlbee

À présent lancez :

# /etc/rc.d/bitlbee start

pour lancer le server Bitlbee.

N'oubliez pas d'ajouter Bitlbee à vos démons dans le /etc/rc.conf pour lancer le serveur au démarrage d'Arch :

DAEMONS=(syslog-ng network ...  bitlbee ...)

Ancienne technique : avec xinetd

Bitlbee n'a pas toujours était doté d'une fonction démon, il utilisait donc xinetd, ce qu'il est encore possible de lui faire faire. Commençons par configurer ce dernier :
Éditez avec votre logiciel préféré /etc/xinetd.d/bitlbee pour que xinetd se sente moins seul et lance bitlbee

service bitlbee
{
        type = UNLISTED
        socket_type = stream
        protocol = tcp
        wait = no
        user = bitlbee
        group = bitlbee
        server = /usr/sbin/bitlbee
        port = 6667
        disable = no
}

Il faut juste changer disable = yes par disable = no

Il ne faut pas oublier d'autoriser l'IP 127.0.0.1 pour bitlbee dans /etc/hosts.allow

bitlbee:    127.0.0.1

Après ça se complique ! Il faut lancer xinetd en tant que racine (root 8-)) :

# /etc/rc.d/xinetd start

Bon si votre PC a pas explosé c'est que ça fonctionne !
Pendant qu'on y'est on va rajouter xinetd dans /etc/rc.conf histoire qu'il se lance à chaque boot :

DAEMONS=(syslog-ng network ... xinetd ...)

Et voilà !

Configuration (client)

Connexion

Là aussi c'est ultra balaise, alors soyez bien attentifs.
Lancez votre client irc préféré ( mIRC par exemple… ha nan =) ) et tapez :

/connect 127.0.0.1

Cela vous créé un nouveau canal qui s'appelle « &bitlbee » ; c'est sur ce canal que l'on va pouvoir configurer vos identifiants sur les réseaux que vous utilisez.

Connectez-vous maintenant au canal *&bitlbee*

/join &bitlbee

Enregistrement

Bitlbee est un serveur ce qui veut dire qu'il stocke des informations et notament votre configuration ( pratique pour éviter de le refaire à chaque fois ).
La première chose a faire est donc de s'enregistrer :

register <votre_mot_de_passe_que_vous_trouvez_bien>

Le serveur doit vous répondre : Password successfully changed
Souvenez-vous en car à la prochaine connexion au serveur il faudra vous identifier, avec la commande qui suit :

identify <votre_mot_de_passe_que_vous_trouvez_bien>

Bien, maintenant on va rajouter nos pseudos/réseaux :
Exemples d'ajout :

account add jabber user@server.com password
account add msn user@domain.com password
account add yahoo nickname password
account add oscar 123456 password login.icq.com
account add oscar aimuser password login.oscar.aol.com
account add Jabber YOURUSERNAME@gmail.com/BitlBee YOURPASSWORD talk.google.com:ssl

Le format est simple, c'est : account add <protocol> <username> <password> [<server>] Vous devez voir apparaitre un joli message de ce style après chaque ajout :

@root -> Account successfully added

ça cause en anglish mais bon c'est relativement compréhensible ;-)

Sauvegarde

Génial ! J'ai mis tout mes nicks je fais quoi ?
On va sauvegarder la config ! (la bonne idée ^_^”)

save

Le gentil serveur doit vous dire : Configuration saved

Commandes Principales

set

Vous permet de changer les paramètres de certaines variables, les plus importants sont :

set charset utf-8
set typing_notice true

Pour pas galérer et avoir les notices quand votre correspondant vous parle.

help

Qui vous file la syntaxe d'une commande ! En anglish :-/

account

Gère vos comptes !
Exemples :

account list

Renvoie la liste des comptes et leur statuts :

@root -> 0. JABBER, pseudo@jabber.fr
@root -> 1. MSN, pseudo@hotmail.com (connected)
account on

Connexion sur tous les réseaux !

account on 1

Connexion au réseau 1 ( MSN dans notre exemple )

account off 1

Déconnexion du réseau 1 ( toujours MSN dans notre exemple)

account del 1

Suppression du réseau 1 ( encore et toujours MSN dans notre exemple)

Vrac

Voici quelques syntaxes intéressantes :

add <connexion> <nick>

Ajouter le gars <nick> à votre connexion n° <connexion> !

remove <nick>

Supprime <nick>.

rename <ancien nick> <nouveau nick>

Permet de renommer le contact kikoololnomsuperlong(f)(l)mdr en un truc lisible.

Pour la liste de toutes les commandes disponibles :

help commands

Webcam & son

Un super support en mode texte de la webcam ! Ascii powered ! Nan désolé pas de support.

Groupes

help groupchats
et
help groupchats2
et
help groupchats3

En gros si un gars vous invite dans un salon de discussion (Yahoo! / MSN seulement), vous le rejoindrez de force ou serez invité.
Note : Les commandes de bases ne fonctionnent pas dans les salons.
Si vous voulez ouvrir un salon avec truc_msn, il vous suffit de rejoindre le chan #truc_msn, Bitlbee refusera de se connecter mais créera un salon avec vous root et truc_msn. Évidemment créée un salon pour parler avec truc_msn c'est moisi, faut inviter pleins de monde ! pour ça il vous suffit d'utiliser /invite
Note 2 : Vous pouvez de ce fait inviter des contacts Yahoo! dans un salon MSN ^_^
Note 3 : Le nom du salon est un nom généré par Bitlbee et a un nom .. aléatoire …
Note 4 : Les salons ne sont pas supportés sur tous les protocols pour l'instant, mais de toutes façon vous vous ferez jeter si c'est pas possible

Rejoindre un salon Jabber

La version de bitlbee proposée dans le dépôt extra (extra/bitlbee 1.0.4-2, le 29/11/2008) ne supporte pas le groupchat avec jabber. Il faut donc en prendre une plus récente dans Aur (j'ai opté pour bitlbee-recode 1.2.3-1, le 29/11/2008).

Il suffit ensuite de se connecter de la façon suivante

join_chat Numero_compte Nom_du_salon

Par exemple :

join_chat 3 linuxpedia@chat.jabberfr.org

FAQ

  • C'est qui ce root ?

J'ai pas démarré mon client en tant que root :@ … Root est seulement l'équivalent de chanserv, c'est l'utilisateur qui a le plus de pouvoir dans Bitlbee ! Comme dans votre système en gros. Et en plus il répondra à vos commandes .. la plupart du temps. Si vraiment c'est l'ultra-loose vous pouvez le renommer ! (rename root <son_nouveau_pseudo> )

  • Les messages que j'envois/reçois arrivent complètement atomisés

ça sent le html ^_^ et/ou l'utf-8 :

help set strip_html
help charset
  • où est la faq officielle ?

Là : http://www.bitlbee.org/main.php/faq.html

  • Il manque le support de <truc qui manque> je me plains où ?

Ici : http://bugs.bitlbee.org/

Liens

Wiki original : http://wiki.archlinux.org/index.php/Bitlbee (anglais)
Notice : http://princessleia.com/bitlbee.php (anglais)
Site principal : http://www.bitlbee.org (anglais)
Doc O'Reilly : http://www.bitlbee.org/main.php/irchacks_bitlbee.html (anglais)

warnaud 13/11/2006 15:20

 
howto/bitlbee.txt · Dernière modification: 2010/07/26 21:08 par elaboile
 
Recent changes RSS feed Creative Commons License Donate Powered by PHP Valid XHTML 1.0 Valid CSS Driven by DokuWiki