XMPP to IRC gateway
louiz’ 2f0e26db4c Channels’ disco#info includes the number of participants 1 day ago
.gitlab/issue_templates Talk about debug logs in contributing.rst and a gitlab ticket template 1 year ago
cmake/Modules Add postgresql support 6 months ago
conf Add signature_methods=IMPLICIT for ppirc and gimp.org servers 1 month ago
doc Also handle SIGHUP to reload the configuration 1 month ago
docker Remove build packages from docker image by using multistage Dockerfile. 4 days ago
packaging Merge branch 'v8' 2 weeks ago
scripts Add a documentation to explain how to migrate from sqlite3 to postgresl 5 months ago
src Channels’ disco#info includes the number of participants 1 day ago
tests Channels’ disco#info includes the number of participants 1 day ago
unit Add https to the unit file DOC thing 1 year ago
.gitignore Update .gitignore 2 years ago
.gitlab-ci.yml build:archlinux is way too slow, run it only manually 2 months ago
CHANGELOG.rst Merge branch 'v8' 2 weeks ago
CMakeLists.txt Correctly use target_sources instead of target_link_libraries 1 week ago
CONTRIBUTING.rst Trivial formatting issue 1 month ago
COPYING Remove a useless line in the COPYING file 1 year ago
INSTALL.rst Revert "C++17" 3 months ago
README.rst Revert "C++17" 3 months ago

README.rst

Biboumi
=======

.. image:: https://lab.louiz.org/louiz/biboumi/badges/master/build.svg
:target: https://lab.louiz.org/louiz/biboumi/pipelines

.. image:: https://coverity.proxy.louiz.org/projects/3726/badge.svg
:target: https://scan.coverity.com/projects/louiz-biboumi

.. image:: https://coreinfrastructure.proxy.louiz.org/projects/450/badge
:target: https://bestpractices.coreinfrastructure.org/projects/450

Biboumi is an XMPP gateway that connects to IRC servers and translates
between the two protocols. It can be used to access IRC channels using any
XMPP client as if these channels were XMPP MUCs.

It is written in modern C++14 and makes great efforts to have as little
dependencies and to be as simple as possible.

The goal is to provide a way to access most of IRC features using any XMPP
client. It doesn’t however try to provide a complete mapping of the
features of both worlds simply because this is not useful and most probably
impossible. For example all IRC modes are not all translatable into an XMPP
features. Some of them are (like +m (mute) or +o (operator) modes), but
some others are IRC-specific. If IRC is the limiting factor (for example
you cannot have a non-ASCII nickname on IRC) then biboumi doesn’t try to
work around this issue: it just enforces the rules of the IRC server by
telling the user that he/she must choose an ASCII-only nickname. An
important goal is to keep the software (and its code) light and simple.


Install
-------
Refer to the INSTALL_ file.


Usage
-----
Read `the documentation`_.


Authors
-------
Florent Le Coz (louiz’)


Contact/Support
---------------
* XMPP ChatRoom: biboumi@muc.poez.io
* Report a bug: https://lab.louiz.org/louiz/biboumi/issues/new

Also, see the `contributing`_ page.


Licence
-------
Biboumi is Free Software.
(learn more: http://www.gnu.org/philosophy/free-sw.html)

Biboumi is released under the zlib license.
Please read the COPYING file for details.

.. _INSTALL: INSTALL.rst
.. _the documentation: doc/biboumi.1.rst
.. _contributing: CONTRIBUTING.rst