BitlBee HOWTO
Nonoo (nonoo kuukac nonoo.hu)
v1.0 2005. 09. 19.
Ezt a leírást egyben innen tudod letölteni.
BitlBee HOWTONonoo (nonoo kuukac nonoo.hu)v1.0 2005. 09. 19. Ezt a leírást egyben innen tudod letölteni. |
|
A BitBlee irc -> instant messenger (MSN, AOL, ICQ stb.) gateway bemutatása.
A BitlBee röviden összefoglalva egy irc->im (instant messenger) gateway (átjáró). Arra való hogy egy sima irc kliens segítségével el tudd érni a BitlBee által támogatott instant messenger hálózatokat. Ez a leírás a BitlBee 0.92es verziója alapján készült, jelenleg a következő im hálózatokat tudja használni: MSN Messenger, AOL, ICQ, Jabber.
Tehát úgy tudsz pl. MSN Messengerezni, mintha ircelnél! Az emberekkel privi ablakban beszélgethetsz, a jól megszokott módon!
Ha pl. utálod a Messenger idióta kliensét és szeretsz ircelni, akkor ez a neked való megoldás! :) Kevés erőforrást igényel, szemben az im kliensek csillivilli grafikus felületével, továbbá erőteljesen hozza az irces feelinget. ;) Sajnos manapság az instant messengerek elterjedésével ezt egyre ritkábban érzi az ember... :(
A BitlBee óriási előnye az is, hogy egyszerre, egy programon belül el tudod érni különféle im hálózatokban lévõ kapcsolataidat (MSN, ICQ, AOL stb.), valamint webes felületen keresztül is elérhető! Tehát csak egy böngésző és máris eléred a barátaid pl. az MSNen. Ennek módjáról a leírás későbbi részében lesz szó.
Egy irc kliensre van csak szükséged (pl. netZ Script Pro), vagy egy böngészőre, ha webes felületen keresztül szeretnéd elérni.
A BitlBeet nem szükséges telepítened, ugyanis világszerte elérhetőek ingyenesen használható szerverek, amiket egy irc klienssel felkapcsolódva máris használni tudsz. Ha mégis szeretnél saját szerver létrehozni, vagy egyszerűen csak jobban szeretnéd ha a saját gépedről futna a program, itt olvashatsz a telepítés módjairól különféle oprendszerekre.
Tehát ha nem akarsz a BitlBee telepítésével bajlódni, használj publikus szervert! A doksi olvasását pedig a 3-as pontnál folytathatod.
A BitlBee alapvetően Linuxos program, de természetesen létezik (nagyonis jól használható) változata Windowsra, ami innen letölthető: http://win32.bitlbee.org/
Telepítés után, a programot elindítva a systraybe (tálcára jobb oldalt) teszi az ikonját. Erre duplán rákattintva jelenik meg a beállító ablak. Csak a legfontosabb, magyarázatra szoruló részeket mutatom be:
Három lehetőséged van:
A BitlBee innen tölthető le: http://www.bitlbee.org/main.php/download.html
A forráskód leforgatása meglehetősen egyszerű, kicsomagolod egy könyvtárba (tar -xzf bitlbee-0.92.tar.gz), elindítod a ./configure scriptet, elindítod a make-t, majd a végén a make install-t.
Ha hibát jelez, valószínűleg nincs feltelepítve SSL könyvtár. Ez a titkosítást végzi, pl. a Messenger hálózat használatához nélkülözhetetlen. Ilyenkor a legegyszerűbb ha a disztribúciód csomagkezelőjét használva felteszed pl. a gnutls-t. (Debian alatt add ki az apt-get install gnutls parancsot).
Add hozzá ezt a sort az /etc/inetd.conf-hoz: 6667 stream tcp nowait nobody /usr/sbin/tcpd /usr/local/sbin/bitlbee
Hozd létre a /var/lib/bitlbee/ könyvtárat! Itt fognak tárolódni az egyes userek beállításai.
Kicsomagolás után nyisd meg egy szövegszerkesztővel (pl. mcedit) a configure scriptet, majd az elején írd át az elérési utakat pl. így:
prefix='/home/nonoo'
bindir='$prefix/bitlbee/'
etcdir='$prefix/bitlbee/'
mandir='$prefix/bitlbee/'
datadir='$prefix/bitlbee/data/'
config='$prefix/bitlbee'
A /home/nonoo-t értelemszerűen írd át a home könyvtáradra. A ./configure és a make parancs után ne add ki a make installt, hanem kézileg másold a fentebb megadott könyvtárba a bitlbee binárist, a bitlbee.conf-ot, valamint a data könyvtárba a help.txt fájlt (ezt a forráskód doc könyvtárában találod meg). A help.txt az ircen lekérhető instant helphez kell, hasznos ha épp nem jut eszedbe valamilyen parancs használati módja.
Ezután add ki a következő parancsot (a /home/nonoo-t írd át a home könyvtáradra):
crontab -l>a;echo "@reboot cd /home/nonoo/bitlbee;./bitlbee">>a;crontab a;rm a
Ez a crontabodhoz adja hozzá a BitlBeet, hogy minden bootoláskor elinduljon. Kicsit fapad módszer, de kiválóan működik :)
A beállításhoz a bitlbee.conf-ot kell szerkesztened. Ha rootként tetted fel a programot, ezt az /etc/bitlbee könyvtárban találod meg. Az alábbiakban végigmegyek a konfig fájl fontosabb szekcióin:
RunMode: alap az Inetd, ha rootként telepítetted fel, maradhat, ha a kézi telepítést választottad, állítsd Daemonra. A leírások szerint még nem ajánlatos ezt az opciót használni, a program még nem elég stabil sok kapcsolat egy processzből történő kezelésére, de ha nem publikus BitlBee szervert indítasz, csak saját használatra, nyugodtan írd át.
DaemonInterface / Daemonport: milyen ipre, portra bindelődjön. Ugyanaz mint a Windowsos változatnál.
AuthMode / AuthPassword: ugyanaz mint a Windowsos változatnál.
HostName: itt beállíthatsz egy egyedi hostnevet, ha esetleg a BitlBee rosszul kérné le.
PingInterval / PingTimeOut: az egyes kapcsolatokra a megadott intervallumonként PING üzenetet küld (mint az irc szerverek), ha PingTimeOut másodpercen belül nem érkezik PONG válasz, megszakítottnak tekinti a kapcsolatot.
MotdFile: MOTD fájl, minden új kliens kapcsolódásakor elküldi.
ConfigDir: ez alapból /var/lib/bitlbee, itt fognak tárolódni az egyes felhasználók adatai. Ha kézileg telepítetted fel a klienst, állítsd ezt át pl. /home/nonoo/bitlbee/data könyvtárra (/home/nonoo-t értelemszerűen írd át a home könyvtáradra)
Proxy: ugyanaz mint a Windowsos változatnál.
[defaults] szekció: itt állíthatod be a beállítási változók alap értékeit. Ezeket később a felhasználók meg tudják változtatni!
A BitlBeehez irc klienssel, vagy webes felületen tudsz kapcsolódni. Irc kliensnek használhatsz pl. netZ Script Pro-t Windows alatt, Linux alatt BitchX-et, grafikus felület alatt XChatet. Nincs más dolgod mint kapcsolódni egy BitlBee szerverhez. Ha feltelepítetted a BitlBeet, kapcsolódj ahhoz, ha publikus szervert használnál, itt van pár cím:
Publikus szerverek: im.bitlbee.org:6667 vagy im.uk.bitlbee.org:6667 vagy im.us.bitlbee.org:6667
A képen éppen kapcsolódni készülök az egyik publikus szerverre.
Webes irc felület használata esetén is csak annyit kell tenned hogy valamilyen BitlBee szerverhez csatlakozol. Ehhez a legegyszerűbb a http://cgi.bitlbee.org/ oldalt használnod:
Kapcsolódás után automatikusan a #bitlbee csatira kerülsz. Ez az alap csatorna, itt történik minden ami a BitlBeevel kapcsolatos. Egyelőre saját magadat láthatod itt (most karcsi néven vagyok bennt), valamint egy root nevű botot:
A root mindig ott van a csatin, később majd meglátod miért. Erről a csatiról ha kilépsz, automatikusan visszakerülsz, továbbá nem tudod a modeokat, topicot se változtatni. FONTOS: ez csak ircnek látszik, de mégsem az! Ne kezdj el ész nélkül belépdesni mindenféle csatornára, ezen a kapcsolaton csak egyedül vagy és senki más. Majd később meglátod, megérted hogy működik minden!
A csatornára parancsokat, üzeneteket írhatsz. A parancsok a root nevű bot fogja értelmezni, ezért van itt állandóan.
Először is érdemes regisztrálni magad a BitlBee szerveren, hogy a beállításaid (pl. MSN, ICQ eléréseid) eltárolódjanak. Ehhez add ki a register jelszó parancsot! (jelszó helyére egy jelszót írj)
Legközelebb ha ugyanerre a BitlBee szerverre belépsz, az identify jelszó segítségével tudod azonosítani magad. Ilyenkor a szerveren eltárolt beállításaid automatikusan megmaradnak, valamint a már aktivizált MSN, AOL stb. eléréseid automatikusan kapcsolódni fognak.
A regisztrációd nick-függő, kisbetű/nagybetű érzékeny! Tehát ha Jozsi névvel regisztráltál és legközelebbi kapcsolódáskor jozsi névvel próbálsz identifyzni, nem fog menni! Nicket váltani - ha már fennt vagy a BitlBee szerveren - nem lehet! Ezért kapcsolódás, regisztrálás előtt gondosan állítsd be a nicked az irc kliensedben.
A jelszavad a későbbiekben a set password jelszó paranccsal tudod megváltoztatni.
Ha lekapcsolódsz a BitlBee szerverről és ott regisztrált felhasználó vagy, beállításaid automatikusan mentődnek.
Itt láthatod amint karcsi néven regisztrálom magamat: (a jelszó ki van pixelezve)
MSN, AOL, ICQ stb. elérést az account add típus név jelszó szerver parancs segítségével tudsz. Ez elsőre bonyolultnak hangzik, de nem mindig kell minden paraméterét használnod. Például egy szimpla MSN Messenger account hozzáadásához írd be a csatira az account add msn jozsi@bacsi.hu jelszo parancsot. Itt az msn a kapcsolat típusa, a jozsi@bacsi.hu az MSN email cím, a jelszo pedig a hozzá tartozó jelszó.
A kapcsolat típusa lehet pl. oscar, jabber. AOL és ICQ kapcsolatokhoz az oscar típust add meg, szervernek pedig login.oscar.aol.com-ot vagy login.icq.com-ot.
Ha nincs MSN Messenger elérésed, a http://www.passport.net/ oldalon csinálhatsz egyet egy már meglévő email címedre, vagy itt létrehozhatsz egy új Hotmailes címet is.
FONTOS: mindegyik hozzáadott kapcsolathoz tartozik egy azonosító szám. Az azonosító számok, kapcsolatok listáját az account list paranccsal kérheted le:
A képen látható hogy az újonnan létrehozott MSN hozzáférésünk a 0 sorszámot kapta. Erre az azonosítóra az account felkapcsolásánál kapásból szükségünk van:
Miután hozzáadtunk egy accountot, az még nincs felkapcsolódva (pl. hozzáadtunk egy MSN accot, az még nem kapcsolódott fel a Microsoft szerverére). Nekünk kell kézileg elindítani a kapcsolódást, az account on azonosító parancs kiadásával, ahol az azonosító a felkapcsolni kívánt hozzáférés sorszáma (ezt a számot az account list paranccsal kérhetjük le).
Általában a BitlBee szervereken alap beállítás hogy ha már vannak hozzáadva accountjaink és felkapcsolódunk, identifyvel azonosítjuk magunkat, akkor automatikusan felkapcsolja az összes meglévő accountunkat. Ha mégsincs beállítva, a set auto_connect 1 parancs kiadásával tudod ezt bekapcsolni:
Ha törölni szeretnél egy hozzáférést, azt az account del sorszám parancs segítségével teheted meg, de előtte érdemes lekapcsolni az account off sorszám parancs segítségével.
Először hadd ejtsek néhány szót a saját felhasználódról.
A többi im partnered számára alaphelyzetben az accountod nevével jelensz meg, ez pl. Messenger esetében az email címed. Ha ezt szeretnéd megváltoztatni, használd a nick accountszám név parancsot, ahol a név a használni kívánt neved legyen. Ez a parancs csak akkor működik rendesen ha már legalább 1 embert felvettél az adott kapcsolaton a partnereid közé.
Ha szóközt is használni akarsz a nevedben, rakd azt idézőjelek közé, pl. nick 0 "Beteg Ló"
Ezt az add accountszám felhasználónév parancs segítségével teheted meg. A felhasználónév Messenger esetében az email cím. Mivel sokszor előfordul hogy az email cím nem egyezik meg az illető nevével (pl. van egy Sanyi nevű partnered, de az email címe dlg_att@freemail.hu - a listádban dlg_att néven fog megjelenni), a partner hozzáadást úgy is végrehajthatod hogy add accountszám felhasználónév partnernév ahol a partnernév a listádban megjelenítendő név legyen:
Ha valakit át szeretnél nevezni a listádban, azt a rename réginév újnév parancs segítségével teheted meg.
Online partnereid listáját a blist parancs kiadásával kérheted le. Ha mindenkit listázni akarsz (azokat is akik éppen nincsenek fennt), akkor a blist all parancsot használd:
Látni hogy a hozzáadott partner "belépett a csatira". Ez azt jelenti hogy fut az instant messenger kliense a gépén. Voiceot kap az, aki nem away. Ha valaki away, vagy busy, vagy idle stb. akkor elveszti voiceát. Ha valaki kikapcsolja az instant messenger kliensét (pl. kikapcsolja a gépét) akkor azt úgy fogod látni mintha "kilépne az ircről":
Információt valakiről kétféleképpen kérhetsz. Az egyik módszer egy sima /whois parancs kiadása:
A másik módszer az info név parancs használata:
Látható hogy csak egy urlt adott vissza információként. Ez csak akkor használható ha az illetőnek van MSN-es honlapja.
Ha valaki idegesítően sokat piszkál, letilthatod - nem fogod megkapni az üzeneteit. Ezt a block név parancs segítségével teheted meg, ahol a név a listádban látható partnernév:
Ha valakit le akarsz szedni az ignore listádról, azt az allow név parancs segítségével teheted meg.
Ez a remove név parancs használatával tehető meg:
A BitlBee időnként kérdéseket tesz fel neked, amikre yes-szel vagy no-val válaszolhatsz. Kérdés akkor jön pl. amikor valaki hozzáad téged a partnereihez és szeretné ha te is hozzáadnád őt a partnereidhez:
Az eddig még függőben lévő, meg nem válaszolt kérdéseket a qlist parancs segítségével kérheted le. Ilyenkor alapból a lista legutóbbi, legfrissebb kérdését kell megválaszolnod.
Üzenetet küldeni valakinek kétféleképpen tudsz. Az egyik, hogy a #bitlbee csatira írsz, a címzett nevével kezdve a mondatot + kettőspont, a másik pedig a sima, megszokott privi ablak használata. Mindegyik módszerről itt van 1-1 kép:
Látható hogy hibaüzenet jön ha nem teszünk kettőspontot az illető neve után.
Konferencia beszélgetést úgy tudsz létrehozni hogy belépsz egy olyan csatira amelyiknek az a neve akivel konferenciabeszélgetést szeretnél folytatni (pl. /join #nonoo). Persze így csak ketten lesztek a csatin, de a többieket az /invite parancs segítségével hívhatod meg:
Az ebbe az ablakba beírt üzenetek közvetlenül továbbítódnak a csatin lévő embereknek. A sima BitlBee parancsok itt nem működnek, azokat a #bitlbee csatira írd!
A használható smileyk, emoticonok listáját a help smileys parancs segítségével kérheted le. Ezeket ha simán beírod egy üzenetbe, a másik félnél megjelennek. (pl. (f) beírására megjelenik egy vörös rózsa).
A változókat a set változónév érték parancs segítségével tudod állítani.
Az üzenetek kódolásának karakterkészletét állíthatod vele. Alapból ez iso-8859-15.
Az állítható vele hogy a beérkező üzenetek külön ablakban nyíljanak-e meg, vagy minden menjen a #bitlbee csatira.
Amikor lekapcsolódsz a szerverről, mentse-e a beállításaidat. Ha ki van kapcsolva, esetleg használhatod a save parancsot a beállításaid elmentéséhez.
HTML üzeneteknél bekapcsolható hogy kivágja az üzenetből a tageket. A readme szerint nem működik megbízhatóan.
Az kapcsolható hogy menjenek-e debug üzenetek a csatira.
Amikor úgy üzensz valakinek, hogy a #bitlbee csatira írsz, alapból kettőspontot kell tenned a neve után. Ezt a kettőspontot változtathatod meg ezzel a beállítással más karakterre (de csak maximum 2 karaktert állíthatsz be!)
Van az MSNnek egy semmire se jó képessége, hogy figyelmeztet ha a másik fél elkezdett gépelni. Ha ezeket a figyelmeztetéseket meg akarod kapni, kapcsold be ezt.
Beállíthatod hogy ki legyen op a #bitlbee csatin. both - te és a root, root - csak a root, user - csak te, none - senki
Ha valaki awayre vált, elvegye-e a voiceát. Alapból 1, hasznos dolog.
Ha valaki olyan küld neked üzenetet aki nincs bennt a partnerlistádban, akkor ezzel beállíthatod hogy hol jelenjen meg nálad. Alapból a root üzeni be a csatira. add - automatikusan felveszi partnernek az ilyen felhasználót, add_private - felveszi+query ablakba teszi az üzenetet, add_channel - felveszi+csati ablakba megy az üzenet, ignore - blokkolja a felhasználót (blokkolnám ;))
Automatikusan kapcsolódjon-e ha a felhasználó identifyzte magát.
Ha megszakad valamelyik account kapcsolata, újrakapcsolódjon-e.
Hány másodperc múlva próbálja meg felépíteni a megszakadt kapcsolatot.
Ha valakinek üzenetet küldesz, több sort egymás után, akkor ezzel az opcióval kapcsolhatod hogy ezeket a sorokat összegyűjtse-e és egy üzenetben küldje-e el.
Az összegyűjtési időt állíthatod vele.
Az állítható vele hogy a#bitlbee csatira írt üzenetek alapból kinek menjenek. Kapcsolható hogy a rootnak, vagy a legutóbb megszólaló embernek.
Ha valaki megváltoztatja a nevét, figyelmeztessen-e.
A regisztrációnál megadott jelszavadat módosíthatod.
A kérdések megválaszolási sorrendjét állíthatod vele. Ez alapból lifo, így mindig a legutóbbi, legfrisebb kérdést kell megválaszolnod ha több is van a qlist listádban. Ha fifora állítod, mindig a legrégebbi kérdést válaszolod meg először.
Ha törölni szeretnéd a szerverről a beállításaidat, regisztrációdat, használd a drop jelszó parancsot.
Ha elmész a gépedtől, vagy valamit csinálsz, érdemes beállítani az awayt a /away irc parancs használatával. A következő, im-kompatibilis módok használhatóak:
nem vagy a gépnél - Away from computer, Away, Extended away
nem vagy elérhető - NA, N/A, Not available
ne zavarjon senki - Busy, Do not disturb, DND, Occupied
mindjárt leszel - Be right back, BRB
telefonálsz - On the phone, Phone, On phone
kajálsz - Out to lunch, Lunch, Food
Pl. ha kajálsz, használd az /away food parancsot. Ha nem vagy a gépnél, az /away away parancsot.
Ha ki akarod kapcsolni az awayt, használd simán, paraméter nélkül az /away parancsot.
A BitlBeenek jól használható, részletes súgója van. Ezt a help parancs beírásával érheted el:
A help quickstart parancs kiadásával lekérhetsz egy gyors használati útmutatót a szerverhez. A help commands az elérhető parancsokat listázza ki. A help away a használható away módokat, a help smileys a smileykat, emoticonokat listázza, a help groupchats a konferencia beszélgetésekről ad tájékoztatást. Ha egy konkrét parancs leírására, használati útmutatójára vagy kíváncsi, használd a help parancsnév parancsot. pl. help add.
Az általam használt BitlBee változat forráskódját innen (p1-es verzió) tudod letölteni. A bináris fájlokat is benne hagytam, ha valakinek így kényelmesebb... Ha saját magad szeretnéd leforgatni, a make clean parancs kiadásával meg tudod pucolni a forráskódot a binárisoktól.
Az általam módosított BitlBee nem küld felesleges, zavaró üzeneteket a kliensnek, valamint patchelve van az msn6 és az msn plus kiegészítéssel. Beállíthatsz magadnak egy bármekkora méretű .png fájlt képként (bitlbee.conf alján az msn_images_mybuddyimage változó), ami a többi felhasználónál megjelenik. A szabvány képméret MSNen 96x96 pixel, ennél nagyobbat sima Windowsos kliensben nem is lehet beállítani, de itt ez a korlátozás nem érvényes. A kliensek teljesen jól megjelenítik a nagyobb képeket is.
A módosított változat a többi felhasználó képét is automatikusan letölti, ezeket a config fájl végén beállított msn_images_path_buddy könyvtárba teszi. Az msn plus kiegészítés lehetővé teszi az away üzenet kibővített használatát, azaz nem csak az előre megadott food, brb stb. szövegeket állíthatod be szabványos away szövegként, hanem bármi mást is.
