version=pmwiki-2.2.130 ordered=1 urlencoded=1 agent=Mozilla/5.0 (Windows NT 6.3; Win64; x64; rv:78.0) Gecko/20100101 Firefox/78.0 author=mkf charset=UTF-8 csum= ctime=1620357579 host=188.210.102.116 name=Bitlbee.Install rev=5 targets=Openbsd.Znc text=(:title Install Bitlbee:)%0a%0a[[https://www.bitlbee.org/|Bitlbee]] is a gateway from IRC clients to [[https://wiki.bitlbee.org/|a variety of other protocols]], by acting like a server for IRC clients and a client for other protocols. For example, you can use Bitlbee to connect your perfered IRC client to Telegram, Discord, or Slack.%0a%0aThe core of bitlbee itself is written in C.%0a%0a!! Installation and configuration%0aFirst, let's install the package:%0a[@%0a$ doas pkg_add bitlbee-3.6p1-libpurple%0a@]%0a%0a'''Note''': There are multiple flavors of bitlbee:%0a%0a'''bitlbee-libpurple''' is bitlbee compiled with libpurple support. This is what we want because it supports the most protocols.%0a%0a'''bitlbee-otr''' is bitlbee compiled with Off The Record ('''OTR''') encryption support. However, the developers suggest not installing OTR version of bitlbee if you plan to provide a public bitlbee instance. This is because the encryption provided by [[https://otr.cypherpunks.ca/|OTR]] (Off-the-Record) is undermined by the fact that the sysadmin can intercept the messages in plaintext. It gives a false sense of security. Moreover, OTR messaging is often fails when the same account is used with other XMPP clients besides bitlbee.%0a%0abitlbee-libpurple-otr is bitlbee with OTR and libpurple support. We avoid it for the same reason as above.%0a%0aAfter installation edit /etc/bitlbee/bitlbee.conf:%0a%0a[@%0aRunMode = ForkDaemon%0aUser = _bitlbee%0a# Bitlbee will only be bound to localhost on port 8171%0aDaemonInterface = 127.0.0.1%0aDaemonPort = 8171%0aOperPassword = password%0aAllowAccountAdd 1%0aHostName = example.com%0a@]%0a%0aReplace @@password@@ with your own password. We set bitlbee to be bound to localhost on port 8171, which users of [[openbsd/znc|our bouncer]] will be able to connect to, because there is no SSL support in bitlbee (unlike ZNC).%0a%0aTo start bitlbee:%0a%0a[@%0a$ doas rcctl enable bitlbee%0a$ doas rcctl start bitlbee%0a@]%0a%0a!! Discord Support%0a%0aUse [[https://github.com/sm00th/bitlbee-discord|sm00th's bitlbee-discord]] plugin. Here is a [[https://www.namtsui.com/cgi-bin/cvsweb/ports/net/bitlbee-discord/|convenient port]] provided by namtsui:%0a%0a[@%0a$ cvs -d anoncvs@namtsui.com:/cvs checkout -P ports/net/bitlbee-discord/%0a@]%0a%0a!! Telegram Support%0a%0a$ doas pkg_add telegram-purple%0a%0a!! Matrix Support%0a%0aFrom packages:%0a%0aNote: packaged version of purple-matrix is not working with bitlbee, so we have to install it from source instead.%0a%0a[@%0a$ doas pkg_add purple-matrix%0a@]%0a%0aFrom source:%0a%0a[@%0a$ doas pkg_add olm glib json-glib%0a$ cd ~/%0a$ git clone https://github.com/matrix-org/purple-matrix.git%0a$ cd purple-matrix%0a$ gmake MATRIX_NO_E2E=1%0a$ doas gmake install%0a@]%0a%0a!! RocketChat support%0a[@%0a$ doas pkg_add purple-rocketchat%0a@]%0a%0a!! Mastodon support%0a[@%0a$ doas pkg_add bitlbee-mastodon%0a@]%0a!! Adding accounts%0aconnect with your IRC client to your bitlbee server, this usually will be localhost, then join &bitlbee (not #bitlbee), you can see your buddy list or generally your chats with people in there. by default only 'root' user exist in there. root can used as a configuration panel to bitlbee.%0a%0afirst let's register your account, this will helps to store your settings.%0a[@%0aregister %3cpassword>%0a@]%0athen save it.%0a[@%0asave%0a@]%0a%0anext time you connected into bitlbee, you can login via NickServ or write directly in &bitlbee%0a[@%0aidentify %3cpassword>%0a@]%0a%0acreate your account using following command:%0a[@%0aaccount add %3cprotocol> %3cusername> [password] [server]%0a@]%0apassword and server are optional and depends on the protocol, for example, telegram does not require them by default.%0afor protocol, there are two types of protocols, ones are supported by bitlbee and ones are supported by libpurple.%0afor checking bitlbee built-in protocols:%0a[@%0ahelp plugins%0a@]%0a%0aand for checking available protocols supported by libpurple:%0a[@%0ahelp purple%0a@]%0a%0athe @@add@@ command by default gives a id to your account by the protocol name, for example if you add a matrix account it id will be 'matrix', if you had more than one matrix account, they will be named like matrix2, matrix3 and so on.%0a%0ayou can check your accounts using %0a[@%0aaccount list%0a@] %0a%0alet's add a jabber account:%0a[@%0aaccount add jabber myusername@ircnow.org MyPassword%0a@]%0aof course, replace myusername@ircnow.org with your JID and @@MyPassword@@ with your password%0a%0aanother example for telegram:%0a[@%0aaccount add telegram +11234567%0a@]%0ait will ask for login code later.%0a%0aNote: telegram-purple is known to be buggy and can't connect to telegram sometimes. try to disconnect using following command:%0a%0a[@%0aaccount %3cid> off%0aaccount %3cid> on%0a@]%0a!! chatting%0aafter adding your accounts, you can start chating using msg or query command, for example%0a[@%0a/query my_buddy%0a@]%0awill open a query with my_buddy user. if you want to message your buddy in jabber, do following%0a[@%0a/query JID%0a@] time=1626894721 title=Install Bitlbee author:1626894721=mkf diff:1626894721:1622788251:minor=3,4c3,4%0a%3c [[https://www.bitlbee.org/|Bitlbee]] is a gateway from IRC clients to [[https://wiki.bitlbee.org/|a variety of other protocols]], by acting like a server for IRC clients and a client for other protocols. For example, you can use Bitlbee to connect your perfered IRC client to Telegram, Discord, or Slack.%0a%3c %0a---%0a> [[https://www.bitlbee.org/|Bitlbee]] is a gateway from IRC clients to [[https://wiki.bitlbee.org/|a variety of other protocols]], by acting like a server for IRC clients and a client for those other networks. For example, you can use Bitlbee to connect your perfered IRC client to many popular protocols, such as Telegram, Discord, or Slack.%0a> %0a13,14c13,14%0a%3c '''Note''': There are multiple flavors of bitlbee:%0a%3c %0a---%0a> '''Note''': There are multiple versions of bitlbee:%0a> %0a34,35c34,35%0a%3c Replace @@password@@ with your own password. We set bitlbee to be bound to localhost on port 8171, which users of [[openbsd/znc|our bouncer]] will be able to connect to, because there is no SSL support in bitlbee (unlike ZNC).%0a%3c %0a---%0a> Replace @@password@@ with your own password. We set bitlbee to be bound to localhost on port 8171, which users of [[openbsd/znc|our bouncer]] will be able to connect to, because remote connections of bitlbee server can't support SSL (unlike ZNC).%0a> %0a102c102%0a%3c create your account using following command:%0a---%0a> create your account using following command%0a113c113%0a%3c and for checking available protocols supported by libpurple:%0a---%0a> and for checking avaliable protocols supported by libpurple:%0a127c127%0a%3c account add jabber myusername@ircnow.org MyPassword%0a---%0a> account add jabber myusername@ircnow.org MyVerySecurePassword%0a129c129%0a%3c of course, replace myusername@ircnow.org with your JID and @@MyPassword@@ with your password%0a---%0a> of course, replace myusername@ircnow.org with your JID and @@MyVerySecurePassword@@ with your password (maybe YourVerySecurePassword? :] )%0a host:1626894721=188.210.102.116 author:1622788251=jrmu diff:1622788251:1621147724:=1,8c1,4%0a%3c (:title Install Bitlbee:)%0a%3c %0a%3c [[https://www.bitlbee.org/|Bitlbee]] is a gateway from IRC clients to [[https://wiki.bitlbee.org/|a variety of other protocols]], by acting like a server for IRC clients and a client for those other networks. For example, you can use Bitlbee to connect your perfered IRC client to many popular protocols, such as Telegram, Discord, or Slack.%0a%3c %0a%3c The core of bitlbee itself is written in C.%0a%3c %0a%3c !! Installation and configuration%0a%3c First, let's install the package:%0a---%0a> bitlbee is a custom irc server that can act a IM (and libpurple) client, you can use it for connecting to XMPP, twitter, discord, Matrix and telegram.%0a> %0a> for installing%0a> %0a10c6,14%0a%3c $ doas pkg_add bitlbee-3.6p1-libpurple%0a---%0a> $ doas pkg_add bitlbee%0a> quirks-3.442 signed on 2021-04-25T17:01:22Z%0a> Ambiguous: choose package for bitlbee%0a> a 0: %3cNone>%0a> 1: bitlbee-3.6p1%0a> 2: bitlbee-3.6p1-libpurple%0a> 3: bitlbee-3.6p1-libpurple-otr%0a> 4: bitlbee-3.6p1-otr%0a> Your choice: 2%0a12,151c16,20%0a%3c %0a%3c '''Note''': There are multiple versions of bitlbee:%0a%3c %0a%3c '''bitlbee-libpurple''' is bitlbee compiled with libpurple support. This is what we want because it supports the most protocols.%0a%3c %0a%3c '''bitlbee-otr''' is bitlbee compiled with Off The Record ('''OTR''') encryption support. However, the developers suggest not installing OTR version of bitlbee if you plan to provide a public bitlbee instance. This is because the encryption provided by [[https://otr.cypherpunks.ca/|OTR]] (Off-the-Record) is undermined by the fact that the sysadmin can intercept the messages in plaintext. It gives a false sense of security. Moreover, OTR messaging is often fails when the same account is used with other XMPP clients besides bitlbee.%0a%3c %0a%3c bitlbee-libpurple-otr is bitlbee with OTR and libpurple support. We avoid it for the same reason as above.%0a%3c %0a%3c After installation edit /etc/bitlbee/bitlbee.conf:%0a%3c %0a%3c [@%0a%3c RunMode = ForkDaemon%0a%3c User = _bitlbee%0a%3c # Bitlbee will only be bound to localhost on port 8171%0a%3c DaemonInterface = 127.0.0.1%0a%3c DaemonPort = 8171%0a%3c OperPassword = password%0a%3c AllowAccountAdd 1%0a%3c HostName = example.com%0a%3c @]%0a%3c %0a%3c Replace @@password@@ with your own password. We set bitlbee to be bound to localhost on port 8171, which users of [[openbsd/znc|our bouncer]] will be able to connect to, because remote connections of bitlbee server can't support SSL (unlike ZNC).%0a%3c %0a%3c To start bitlbee:%0a%3c %0a%3c [@%0a%3c $ doas rcctl enable bitlbee%0a%3c $ doas rcctl start bitlbee%0a%3c @]%0a%3c %0a%3c !! Discord Support%0a%3c %0a%3c Use [[https://github.com/sm00th/bitlbee-discord|sm00th's bitlbee-discord]] plugin. Here is a [[https://www.namtsui.com/cgi-bin/cvsweb/ports/net/bitlbee-discord/|convenient port]] provided by namtsui:%0a%3c %0a%3c [@%0a%3c $ cvs -d anoncvs@namtsui.com:/cvs checkout -P ports/net/bitlbee-discord/%0a%3c @]%0a%3c %0a%3c !! Telegram Support%0a%3c %0a%3c $ doas pkg_add telegram-purple%0a%3c %0a%3c !! Matrix Support%0a%3c %0a%3c From packages:%0a%3c %0a%3c Note: packaged version of purple-matrix is not working with bitlbee, so we have to install it from source instead.%0a%3c %0a%3c [@%0a%3c $ doas pkg_add purple-matrix%0a%3c @]%0a%3c %0a%3c From source:%0a%3c %0a%3c [@%0a%3c $ doas pkg_add olm glib json-glib%0a%3c $ cd ~/%0a%3c $ git clone https://github.com/matrix-org/purple-matrix.git%0a%3c $ cd purple-matrix%0a%3c $ gmake MATRIX_NO_E2E=1%0a%3c $ doas gmake install%0a%3c @]%0a%3c %0a%3c !! RocketChat support%0a%3c [@%0a%3c $ doas pkg_add purple-rocketchat%0a%3c @]%0a%3c %0a%3c !! Mastodon support%0a%3c [@%0a%3c $ doas pkg_add bitlbee-mastodon%0a%3c @]%0a%3c !! Adding accounts%0a%3c connect with your IRC client to your bitlbee server, this usually will be localhost, then join &bitlbee (not #bitlbee), you can see your buddy list or generally your chats with people in there. by default only 'root' user exist in there. root can used as a configuration panel to bitlbee.%0a%3c %0a%3c first let's register your account, this will helps to store your settings.%0a%3c [@%0a%3c register %3cpassword>%0a%3c @]%0a%3c then save it.%0a%3c [@%0a%3c save%0a%3c @]%0a%3c %0a%3c next time you connected into bitlbee, you can login via NickServ or write directly in &bitlbee%0a%3c [@%0a%3c identify %3cpassword>%0a%3c @]%0a%3c %0a%3c create your account using following command%0a%3c [@%0a%3c account add %3cprotocol> %3cusername> [password] [server]%0a%3c @]%0a%3c password and server are optional and depends on the protocol, for example, telegram does not require them by default.%0a%3c for protocol, there are two types of protocols, ones are supported by bitlbee and ones are supported by libpurple.%0a%3c for checking bitlbee built-in protocols:%0a%3c [@%0a%3c help plugins%0a%3c @]%0a%3c %0a%3c and for checking avaliable protocols supported by libpurple:%0a%3c [@%0a%3c help purple%0a%3c @]%0a%3c %0a%3c the @@add@@ command by default gives a id to your account by the protocol name, for example if you add a matrix account it id will be 'matrix', if you had more than one matrix account, they will be named like matrix2, matrix3 and so on.%0a%3c %0a%3c you can check your accounts using %0a%3c [@%0a%3c account list%0a%3c @] %0a%3c %0a%3c let's add a jabber account:%0a%3c [@%0a%3c account add jabber myusername@ircnow.org MyVerySecurePassword%0a%3c @]%0a%3c of course, replace myusername@ircnow.org with your JID and @@MyVerySecurePassword@@ with your password (maybe YourVerySecurePassword? :] )%0a%3c %0a%3c another example for telegram:%0a%3c [@%0a%3c account add telegram +11234567%0a%3c @]%0a%3c it will ask for login code later.%0a%3c %0a%3c Note: telegram-purple is known to be buggy and can't connect to telegram sometimes. try to disconnect using following command:%0a%3c %0a%3c [@%0a%3c account %3cid> off%0a%3c account %3cid> on%0a%3c @]%0a%3c !! chatting%0a%3c after adding your accounts, you can start chating using msg or query command, for example%0a%3c [@%0a%3c /query my_buddy%0a%3c @]%0a%3c will open a query with my_buddy user. if you want to message your buddy in jabber, do following%0a%3c [@%0a%3c /query JID%0a%3c @]%0a\ No newline at end of file%0a---%0a> bitlbee-libpurple is the bitlbee compiled with libpurple support, this is what you likely want, supports more protocols in cost of more ram/cpu usage and less stablity.%0a> %0a> bitlbee-otr is the bitlbee compiled with Off the Road encryption support, it was quite popular on XMPP. however it's now replaced with OMEMO in most clients, you may not want this.%0a> %0a> bitlbee-libpurple-otr is bitlbee with otr and libpurple support%0a host:1622788251=125.231.28.9 author:1621147724=mkf diff:1621147724:1620357603:minor=5,15c5,14%0a%3c [@%0a%3c $ doas pkg_add bitlbee%0a%3c quirks-3.442 signed on 2021-04-25T17:01:22Z%0a%3c Ambiguous: choose package for bitlbee%0a%3c a 0: %3cNone>%0a%3c 1: bitlbee-3.6p1%0a%3c 2: bitlbee-3.6p1-libpurple%0a%3c 3: bitlbee-3.6p1-libpurple-otr%0a%3c 4: bitlbee-3.6p1-otr%0a%3c Your choice: 2%0a%3c @]%0a---%0a> @@# pkg_add bitlbee@@%0a> @@quirks-3.442 signed on 2021-04-25T17:01:22Z @@%0a> @@Ambiguous: choose package for bitlbee @@%0a> @@a 0: %3cNone> @@%0a> @@ 1: bitlbee-3.6p1 @@%0a> @@ 2: bitlbee-3.6p1-libpurple @@%0a> @@ 3: bitlbee-3.6p1-libpurple-otr @@%0a> @@ 4: bitlbee-3.6p1-otr @@%0a> @@Your choice: 2@@%0a> %0a host:1621147724=198.251.81.133 author:1620357603=mkf csum:1620357603=made the page diff:1620357603:1620357579:= host:1620357603=2.178.139.253 author:1620357579=mkf csum:1620357579=made the page diff:1620357579:1620357579:=1,19d0%0a%3c bitlbee is a custom irc server that can act a IM (and libpurple) client, you can use it for connecting to XMPP, twitter, discord, Matrix and telegram.%0a%3c %0a%3c for installing%0a%3c %0a%3c @@# pkg_add bitlbee@@%0a%3c @@quirks-3.442 signed on 2021-04-25T17:01:22Z @@%0a%3c @@Ambiguous: choose package for bitlbee @@%0a%3c @@a 0: %3cNone> @@%0a%3c @@ 1: bitlbee-3.6p1 @@%0a%3c @@ 2: bitlbee-3.6p1-libpurple @@%0a%3c @@ 3: bitlbee-3.6p1-libpurple-otr @@%0a%3c @@ 4: bitlbee-3.6p1-otr @@%0a%3c @@Your choice: 2@@%0a%3c %0a%3c bitlbee-libpurple is the bitlbee compiled with libpurple support, this is what you likely want, supports more protocols in cost of more ram/cpu usage and less stablity.%0a%3c %0a%3c bitlbee-otr is the bitlbee compiled with Off the Road encryption support, it was quite popular on XMPP. however it's now replaced with OMEMO in most clients, you may not want this.%0a%3c %0a%3c bitlbee-libpurple-otr is bitlbee with otr and libpurple support%0a host:1620357579=2.178.139.253