version wilmer@gaast.net-20051106182318-bcd0c40510635707 163 5a4988187151696f0c794791dfe2cc68221db79f wilmer@gaast.net-20051106182318-bcd0c40510635707 wilmer@gaast.net-20051106182318-bcd0c40510635707 Quickstart wilmer@gaast.net-20051106182318-bcd0c40510635707 wilmer@gaast.net-20051106182318-bcd0c40510635707 wilmer@gaast.net-20051106182318-bcd0c40510635707 Welcome to BitlBee, your IRC gateway to ICQ, MSN, AOL, Jabber and Yahoo Instant Messaging Systems. wilmer@gaast.net-20051106182318-bcd0c40510635707 wilmer@gaast.net-20051106182318-bcd0c40510635707 wilmer@gaast.net-20051106182318-bcd0c40510635707 wilmer@gaast.net-20051106182318-bcd0c40510635707 The center of BitlBee is the control channel, #bitlbee. Two users will always be there, you (where "you" is the nickname you are using) and the system user, root. wilmer@gaast.net-20051106182318-bcd0c40510635707 wilmer@gaast.net-20051106182318-bcd0c40510635707 wilmer@gaast.net-20051106182318-bcd0c40510635707 wilmer@gaast.net-20051106182318-bcd0c40510635707 You need register so that all your IM settings (passwords, contacts, etc) can be saved on the BitlBee server. It's important that you pick a good password so no one else can access your account. Register with this password using the register command: register <password> (without the brackets!). wilmer@gaast.net-20051106182318-bcd0c40510635707 wilmer@gaast.net-20051106182318-bcd0c40510635707 wilmer@gaast.net-20051106182318-bcd0c40510635707 wilmer@gaast.net-20051106182318-bcd0c40510635707 Be sure to remember your password. The next time you connect to the BitlBee server you will need to identify <password> so that you will be recognised and logged in to all the IM services automatically. wilmer@gaast.net-20051106182318-bcd0c40510635707 wilmer@gaast.net-20051106182318-bcd0c40510635707 wilmer@gaast.net-20051106182318-bcd0c40510635707 wilmer@gaast.net-20051106182318-bcd0c40510635707 When finished, type help quickstart2 to continue. wilmer@gaast.net-20051106182318-bcd0c40510635707 wilmer@gaast.net-20051106182318-bcd0c40510635707 wilmer@gaast.net-20051106182318-bcd0c40510635707 wilmer@gaast.net-20051106182318-bcd0c40510635707 Add and Connect To your IM Account(s) wilmer@gaast.net-20051106182318-bcd0c40510635707 wilmer@gaast.net-20051106182318-bcd0c40510635707 wilmer@gaast.net-20051106182318-bcd0c40510635707 Step Two: Add and Connect To your IM Account(s). wilmer@gaast.net-20051106182318-bcd0c40510635707 wilmer@gaast.net-20051106182318-bcd0c40510635707 wilmer@gaast.net-20051106182318-bcd0c40510635707 wilmer@gaast.net-20051106182318-bcd0c40510635707 To add an account to the account list you will need to use the account add command: account add <protocol> <username> <password> [<server>]. wilmer@gaast.net-20051106182318-bcd0c40510635707 wilmer@gaast.net-20051106182318-bcd0c40510635707 wilmer@gaast.net-20051106182318-bcd0c40510635707 wilmer@gaast.net-20051106182318-bcd0c40510635707 For instance, suppose you have an ICQ account with UIN 72696705 with password QuickStart, you would: wilmer@gaast.net-20051106182318-bcd0c40510635707 wilmer@gaast.net-20051106182318-bcd0c40510635707 wilmer@gaast.net-20051106182318-bcd0c40510635707 wilmer@gaast.net-20051106182318-bcd0c40510635707 account add oscar 72696705 QuickStart login.icq.com wilmer@gaast.net-20051106182318-bcd0c40510635707 Account successfully added wilmer@gaast.net-20051106182318-bcd0c40510635707 wilmer@gaast.net-20051106182318-bcd0c40510635707 wilmer@gaast.net-20051106182318-bcd0c40510635707 wilmer@gaast.net-20051106182318-bcd0c40510635707 Other available IM protocols are jabber, msn, and yahoo. Oscar is the protocol used by ICQ and AOL. For oscar, you need to specify the IM-server as a fourth argument (for msn and yahoo there is no fourth argument). For AOL Instant Messenger, the server name is login.oscar.aol.com. For ICQ, the server name is login.icq.com. wilmer@gaast.net-20051106182318-bcd0c40510635707 wilmer@gaast.net-20051106182318-bcd0c40510635707 wilmer@gaast.net-20051106182318-bcd0c40510635707 wilmer@gaast.net-20051106182318-bcd0c40510635707 When you are finished adding your account(s) use the account on command to enable all your accounts, type help quickstart3 to continue. wilmer@gaast.net-20051106182318-bcd0c40510635707 wilmer@gaast.net-20051106182318-bcd0c40510635707 wilmer@gaast.net-20051106182318-bcd0c40510635707 wilmer@gaast.net-20051106182318-bcd0c40510635707 wilmer@gaast.net-20051106182318-bcd0c40510635707 wilmer@gaast.net-20051106182318-bcd0c40510635707 Managing Contact Lists: Rename wilmer@gaast.net-20051106182318-bcd0c40510635707 wilmer@gaast.net-20051106182318-bcd0c40510635707 wilmer@gaast.net-20051106182318-bcd0c40510635707 wilmer@gaast.net-20051106182318-bcd0c40510635707 Step Three: Managing Contact Lists: Rename wilmer@gaast.net-20051106182318-bcd0c40510635707 wilmer@gaast.net-20051106182318-bcd0c40510635707 wilmer@gaast.net-20051106182318-bcd0c40510635707 wilmer@gaast.net-20051106182318-bcd0c40510635707 For most protocols (currently MSN, Jabber, Yahoo and AOL) BitlBee can download the contact list automatically from the IM server and all the on-line users should appear in the control channel when you log in. wilmer@gaast.net-20051106182318-bcd0c40510635707 wilmer@gaast.net-20051106182318-bcd0c40510635707 wilmer@gaast.net-20051106182318-bcd0c40510635707 wilmer@gaast.net-20051106182318-bcd0c40510635707 BitlBee will convert names into irc-friendly form (for instance: tux@example.com will be given the nickname tux). If you have more than one person who would have the same name by this logic (for instance: tux@example.com and tux@bitlbee.org) the second one to log on will be tux_. The same is true if you have a tux log on to AOL and a tux log on from Yahoo. wilmer@gaast.net-20051106182318-bcd0c40510635707 wilmer@gaast.net-20051106182318-bcd0c40510635707 wilmer@gaast.net-20051106182318-bcd0c40510635707 wilmer@gaast.net-20051106182318-bcd0c40510635707 It would be easy to get these two mixed up, so BitlBee has a rename command to change the nickname into something more suitable: rename <oldnick> <newnick> wilmer@gaast.net-20051106182318-bcd0c40510635707 wilmer@gaast.net-20051106182318-bcd0c40510635707 wilmer@gaast.net-20051106182318-bcd0c40510635707 wilmer@gaast.net-20051106182318-bcd0c40510635707 rename tux_ bitlbeetux wilmer@gaast.net-20051106182318-bcd0c40510635707 is now known as bitlbeetux wilmer@gaast.net-20051106182318-bcd0c40510635707 Nick successfully changed wilmer@gaast.net-20051106182318-bcd0c40510635707 wilmer@gaast.net-20051106182318-bcd0c40510635707 wilmer@gaast.net-20051106182318-bcd0c40510635707 wilmer@gaast.net-20051106182318-bcd0c40510635707 When finished, type help quickstart4 to continue. wilmer@gaast.net-20051106182318-bcd0c40510635707 wilmer@gaast.net-20051106182318-bcd0c40510635707 wilmer@gaast.net-20051106182318-bcd0c40510635707 wilmer@gaast.net-20051106182318-bcd0c40510635707 wilmer@gaast.net-20051106182318-bcd0c40510635707 wilmer@gaast.net-20051106182318-bcd0c40510635707 Step Four: Managing Contact Lists: Add and Remove. wilmer@gaast.net-20051106182318-bcd0c40510635707 wilmer@gaast.net-20051106182318-bcd0c40510635707 wilmer@gaast.net-20051106182318-bcd0c40510635707 Step Four: Managing Contact Lists: Add and Remove. wilmer@gaast.net-20051106182318-bcd0c40510635707 wilmer@gaast.net-20051106182318-bcd0c40510635707 wilmer@gaast.net-20051106182318-bcd0c40510635707 wilmer@gaast.net-20051106182318-bcd0c40510635707 Now you might want to add some contacts, to do this we will use the add command. It needs two arguments: a connection ID (which can be a number (try account list), protocol name or (part of) the screenname) and the user's handle. It is used in the following way: add <connection> <handle> wilmer@gaast.net-20051106182318-bcd0c40510635707 wilmer@gaast.net-20051106182318-bcd0c40510635707 wilmer@gaast.net-20051106182318-bcd0c40510635707 wilmer@gaast.net-20051106182318-bcd0c40510635707 add 0 r2d2@example.com wilmer@gaast.net-20051106182318-bcd0c40510635707 has joined #bitlbee wilmer@gaast.net-20051106182318-bcd0c40510635707 wilmer@gaast.net-20051106182318-bcd0c40510635707 wilmer@gaast.net-20051106182318-bcd0c40510635707 wilmer@gaast.net-20051106182318-bcd0c40510635707 In this case r2d2 is online, since he/she joins the channel immediately. If the user is not online you will not see them join until they log on. wilmer@gaast.net-20051106182318-bcd0c40510635707 wilmer@gaast.net-20051106182318-bcd0c40510635707 wilmer@gaast.net-20051106182318-bcd0c40510635707 wilmer@gaast.net-20051106182318-bcd0c40510635707 Lets say you accidentally added r2d3@example.com rather than r2d2@example.com, or maybe you just want to remove a user from your list because you never talk to them. To remove a name you will want to use the remove command: remove <nick> wilmer@gaast.net-20051106182318-bcd0c40510635707 wilmer@gaast.net-20051106182318-bcd0c40510635707 wilmer@gaast.net-20051106182318-bcd0c40510635707 wilmer@gaast.net-20051106182318-bcd0c40510635707 When finished, type help quickstart5 to continue. wilmer@gaast.net-20051106182318-bcd0c40510635707 wilmer@gaast.net-20051106182318-bcd0c40510635707 wilmer@gaast.net-20051106182318-bcd0c40510635707 wilmer@gaast.net-20051106182318-bcd0c40510635707 wilmer@gaast.net-20051106182318-bcd0c40510635707 wilmer@gaast.net-20051106182318-bcd0c40510635707 Chatting wilmer@gaast.net-20051106182318-bcd0c40510635707 wilmer@gaast.net-20051106182318-bcd0c40510635707 wilmer@gaast.net-20051106182318-bcd0c40510635707 Step Five: Chatting. wilmer@gaast.net-20051106182318-bcd0c40510635707 wilmer@gaast.net-20051106182318-bcd0c40510635707 wilmer@gaast.net-20051106182318-bcd0c40510635707 wilmer@gaast.net-20051106182318-bcd0c40510635707 First of all, a person must be on your contact list for you to chat with them (unless it's a group chat, help groupchats for more). If someone not on your contact list sends you a message, simply add them to the proper account with the add command. Once they are on your list and online, you can chat with them in #bitlbee: wilmer@gaast.net-20051106182318-bcd0c40510635707 wilmer@gaast.net-20051106182318-bcd0c40510635707 wilmer@gaast.net-20051106182318-bcd0c40510635707 wilmer@gaast.net-20051106182318-bcd0c40510635707 tux: hey, how's the weather down there? wilmer@gaast.net-20051106182318-bcd0c40510635707 you: a bit chilly! wilmer@gaast.net-20051106182318-bcd0c40510635707 wilmer@gaast.net-20051106182318-bcd0c40510635707 wilmer@gaast.net-20051106182318-bcd0c40510635707 wilmer@gaast.net-20051106182318-bcd0c40510635707 If you'd rather chat with them in a separate window use the /msg or /query command, just like you would for a private message in IRC. If you want to have messages automatically come up in private messages rather than in the #bitlbee channel, use the set private command: set private true (set private false to change back). wilmer@gaast.net-20051106182318-bcd0c40510635707 wilmer@gaast.net-20051106182318-bcd0c40510635707 wilmer@gaast.net-20051106182318-bcd0c40510635707 wilmer@gaast.net-20051106182318-bcd0c40510635707 You know the basics. If you want to get to know more about BitlBee, please type help quickstart6. wilmer@gaast.net-20051106182318-bcd0c40510635707 wilmer@gaast.net-20051106182318-bcd0c40510635707 wilmer@gaast.net-20051106182318-bcd0c40510635707 wilmer@gaast.net-20051106182318-bcd0c40510635707 wilmer@gaast.net-20051106182318-bcd0c40510635707 wilmer@gaast.net-20051106182318-bcd0c40510635707 Further Resources wilmer@gaast.net-20051106182318-bcd0c40510635707 wilmer@gaast.net-20051106182318-bcd0c40510635707 wilmer@gaast.net-20051106182318-bcd0c40510635707 So you want more than just chatting? Or maybe you're just looking for a feature? wilmer@gaast.net-20051106182318-bcd0c40510635707 wilmer@gaast.net-20051106182318-bcd0c40510635707 wilmer@gaast.net-20051106182318-bcd0c40510635707 wilmer@gaast.net-20051106182318-bcd0c40510635707 You can type help set to learn more about the possible BitlBee user settings. Among these user settings you will find options for common issues, such as changing the charset, HTML stripping and automatic connecting (simply type set to see current user settings). wilmer@gaast.net-20051106182318-bcd0c40510635707 wilmer@gaast.net-20051106182318-bcd0c40510635707 wilmer@gaast.net-20051106182318-bcd0c40510635707 wilmer@gaast.net-20051106182318-bcd0c40510635707 For more subjects (like groupchats and away states), please type help index. wilmer@gaast.net-20051106182318-bcd0c40510635707 wilmer@gaast.net-20051106182318-bcd0c40510635707 wilmer@gaast.net-20051106182318-bcd0c40510635707 wilmer@gaast.net-20051106182318-bcd0c40510635707 If you're still looking for something, please visit us in #bitlbee on the OFTC network (you can connect via irc.bitlbee.org), or mail us your problem/suggestion. Good luck and enjoy the Bee! wilmer@gaast.net-20051106182318-bcd0c40510635707 wilmer@gaast.net-20051106182318-bcd0c40510635707 wilmer@gaast.net-20051106182318-bcd0c40510635707 wilmer@gaast.net-20051106182318-bcd0c40510635707 wilmer@gaast.net-20051106182318-bcd0c40510635707 end wilmer@gaast.net-20051106182318-bcd0c40510635707 version wilmer@gaast.net-20051121115348-47a35a345605739b 8 e38c3b59a13cc21855122ec7d863112f7e9fe031 8,9,1 wilmer@gaast.net-20051121115348-47a35a345605739b The center of BitlBee is the control channel, &bitlbee. Two users will always be there, you (where "you" is the nickname you are using) and the system user, root. 98,99,1 wilmer@gaast.net-20051121115348-47a35a345605739b has joined &bitlbee 123,124,1 wilmer@gaast.net-20051121115348-47a35a345605739b First of all, a person must be on your contact list for you to chat with them (unless it's a group chat, help groupchats for more). If someone not on your contact list sends you a message, simply add them to the proper account with the add command. Once they are on your list and online, you can chat with them in &bitlbee: 132,133,1 wilmer@gaast.net-20051121115348-47a35a345605739b If you'd rather chat with them in a separate window use the /msg or /query command, just like you would for a private message in IRC. If you want to have messages automatically come up in private messages rather than in the &bitlbee channel, use the set private command: set private true (set private false to change back). end wilmer@gaast.net-20051121115348-47a35a345605739b version wilmer@gaast.net-20071212233051-fn8bh4aytsx0hiz9 4 2ec8d5c20c30ad6a9afe56d706491e36ec4dc924 39,40,1 wilmer@gaast.net-20071212233051-fn8bh4aytsx0hiz9 account add jabber bitlbee@jabber.org QuickStart 44,45,1 wilmer@gaast.net-20071212233051-fn8bh4aytsx0hiz9 Other available IM protocols are msn, oscar, and yahoo. Oscar is the protocol used by ICQ and AOL. end wilmer@gaast.net-20071212233051-fn8bh4aytsx0hiz9 version wilmer@gaast.net-20080113144551-zrvtxf43x1jz3i7q 4 a12130917f76d971b2e5af09acc2e569625c9135 35,36,1 wilmer@gaast.net-20080113144551-zrvtxf43x1jz3i7q For instance, suppose you have a Jabber account at jabber.org with handle bitlbee@jabber.org with password QuickStart, you would: 44,45,1 wilmer@gaast.net-20080113144551-zrvtxf43x1jz3i7q Other available IM protocols are msn, oscar, and yahoo. OSCAR is the protocol used by ICQ and AOL. For more information about the account add command, see help account add. end wilmer@gaast.net-20080113144551-zrvtxf43x1jz3i7q version wilmer@gaast.net-20080302175821-aor9yjf3q6k0hf9y 12 0b4f8fe2c7a8dd17b895ec523bd96ad907e8fae6 62,63,1 wilmer@gaast.net-20080302175821-aor9yjf3q6k0hf9y Now BitlBee logs in and downloads the contact list from the IM server. In a few seconds, all your on-line buddies should show up in the control channel. 66,67,1 wilmer@gaast.net-20080302175821-aor9yjf3q6k0hf9y BitlBee will convert names into IRC-friendly form (for instance: tux@example.com will be given the nickname tux). If you have more than one person who would have the same name by this logic (for instance: tux@example.com and tux@bitlbee.org) the second one to log on will be tux_. The same is true if you have a tux log on to AOL and a tux log on from Yahoo. 128,129,1 wilmer@gaast.net-20080302175821-aor9yjf3q6k0hf9y you: a bit chilly! 132,133,5 wilmer@gaast.net-20080302175821-aor9yjf3q6k0hf9y Note that, although all contacts are in the &bitlbee channel, only tux will actually receive this message. The &bitlbee channel shouldn't be confused with a real IRC channel. wilmer@gaast.net-20080302175821-aor9yjf3q6k0hf9y wilmer@gaast.net-20080302175821-aor9yjf3q6k0hf9y wilmer@gaast.net-20080302175821-aor9yjf3q6k0hf9y wilmer@gaast.net-20080302175821-aor9yjf3q6k0hf9y If you prefer chatting in a separate window, use the /msg or /query command, just like on real IRC. BitlBee will remember how you talk to someone and show his/her responses the same way. If you want to change the default behaviour (for people you haven't talked to yet), see help set private. end wilmer@gaast.net-20080302175821-aor9yjf3q6k0hf9y version kenobi@rhea-20071218235935-utpyo7hoo9imtr2c 4 2ec8d5c20c30ad6a9afe56d706491e36ec4dc924 39,40,1 kenobi@rhea-20071218235935-utpyo7hoo9imtr2c account add jabber bitlbee@jabber.org QuickStart 44,45,1 kenobi@rhea-20071218235935-utpyo7hoo9imtr2c Other available IM protocols are msn, oscar, and yahoo. Oscar is the protocol used by ICQ and AOL. end kenobi@rhea-20071218235935-utpyo7hoo9imtr2c version a.sporto+bee@gmail.com-20080215173857-19ptd7cwwi4e1jic 0 a12130917f76d971b2e5af09acc2e569625c9135 end a.sporto+bee@gmail.com-20080215173857-19ptd7cwwi4e1jic version a.sporto+bee@gmail.com-20080414131053-x7o8w2fgi20cu0yv 12 0b4f8fe2c7a8dd17b895ec523bd96ad907e8fae6 62,63,1 wilmer@gaast.net-20080302175821-aor9yjf3q6k0hf9y Now BitlBee logs in and downloads the contact list from the IM server. In a few seconds, all your on-line buddies should show up in the control channel. 66,67,1 wilmer@gaast.net-20080302175821-aor9yjf3q6k0hf9y BitlBee will convert names into IRC-friendly form (for instance: tux@example.com will be given the nickname tux). If you have more than one person who would have the same name by this logic (for instance: tux@example.com and tux@bitlbee.org) the second one to log on will be tux_. The same is true if you have a tux log on to AOL and a tux log on from Yahoo. 128,129,1 wilmer@gaast.net-20080302175821-aor9yjf3q6k0hf9y you: a bit chilly! 132,133,5 wilmer@gaast.net-20080302175821-aor9yjf3q6k0hf9y Note that, although all contacts are in the &bitlbee channel, only tux will actually receive this message. The &bitlbee channel shouldn't be confused with a real IRC channel. wilmer@gaast.net-20080302175821-aor9yjf3q6k0hf9y wilmer@gaast.net-20080302175821-aor9yjf3q6k0hf9y wilmer@gaast.net-20080302175821-aor9yjf3q6k0hf9y wilmer@gaast.net-20080302175821-aor9yjf3q6k0hf9y If you prefer chatting in a separate window, use the /msg or /query command, just like on real IRC. BitlBee will remember how you talk to someone and show his/her responses the same way. If you want to change the default behaviour (for people you haven't talked to yet), see help set private. end a.sporto+bee@gmail.com-20080414131053-x7o8w2fgi20cu0yv