Go to file
Artem Savkov 9990487e54 Add license info 2015-12-16 11:25:16 +01:00
src Add license info 2015-12-16 11:25:16 +01:00
.gitignore Initial derp 2015-09-11 17:48:41 +02:00
LICENSE Add license info 2015-12-16 11:25:16 +01:00
Makefile Refactor all the things. 2015-12-05 18:28:53 +01:00
README Add license info 2015-12-16 11:25:16 +01:00

README

Discord protocol plugin for bitlbee.

License
-------
bitlbee-discord plugin is distributed under GPLv2 license.

This program is free software: you can redistribute it and/or modify
it under the terms of the GNU General Public License as published by
the Free Software Foundation, either version 2 of the License, or
(at your option) any later version.

This program is distributed in the hope that it will be useful,
but WITHOUT ANY WARRANTY; without even the implied warranty of
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
GNU General Public License for more details.

You should have received a copy of the GNU General Public License
along with this program. If not, see <http://www.gnu.org/licenses/>.

Build dependencies
------------------
- bitlbee and headers
  If using distribution version of bitlbee you will need to install the dev
  package, usually bitlbee-dev or bitlbee-devel. If bitlbee was built from
  source don't forget to do `make install-dev`.

- libwebsockets >= 1.5 and headers (https://libwebsockets.org)
  Archlinux users can use libwebsocket-git from AUR, others are out of luck and
  will have to build it from source for now, debian's version in sid is too old
  (1.2), fedora23 doesn't provide this package at all.

- glib2 and headers
  The library itself is usually installed as a dependency of bitlbee, headers
  need to be installed separately. In debian the package containing them is
  libglib2.0-dev.

Building and Installing
-----------------------
The process is extremely dumb for now, so it is just:

  $ make && sudo make install

This will build the discord.so file and put it into /usr/lib/bitlbee directory,
if your bitlbee's plugindir is somewhere else you'll have to move it manually.

Usage
-----
Plugint adds 'discord' protocol to bitlbee, add your account as usual:

  > account add discord <email> <password>
  > account discord on

Options
-------
This section describes options available throug "account set" bitlbee command
(for help on usage of this command see "help account set").

  - host (type: string; default: discordapp.com)
    Discord server hostname. Just in case discord changes the hostname or there
    are some alternatives with compatible API.

  - voice_status_notify (type: boolean; default: no)
    This enables text notifications in your control channel about users
    changing/leaving voice channels. Can be noisy on big servers.

Bugs
----
Plugin is in early development stages, so there should be plenty, please report
them at github: https://github.com/sm00th/bitlbee-discord/issues