kawaii

This repository contains some crates that may be helpful to the IRC smith of the 21st century! They were built around ellidri, a modern IRC server (or IRCd, for short). You will especially find:

• an IRC parsing library, ellidri-tokens, which provides tools to correctly and efficiently parse IRC messages and mode strings,
• ellidri-unicase, providing a wrapper around strings to make them case-insensitive regarding IRC's different case mappings,
• an IRC server, ellidri, that aims to be simple to setup, widely compatible, feature complete and scalable.

To discuss about ellidri and cie, join the IRC channel: #ellidri on freenode! There is also a test server running at ellidri.org, if you want to try it out!

The rest of this document is about ellidri, the IRC server. All other projects have their own README.md.

Features

• RFC 1459 and 2812 compliance (almost! see #1)
• IRCv3 support
• Configurable via a file that can be reloaded at runtime
• SASL support with SQLite and PostgreSQL
• kawaii messages

Supported extensions: account-notify, away-notify, batch, cap-notify, echo-message, extended-join, invite-notify, labeled-response, message-ids, message-tags, multi-prefix, sasl, server-time, setname, userhost-in-names

ellidri doesn't support any server-to-server (S2S) protocol. As such, it is impossible to make several instances of ellidri manage the same IRC network.

ellidri requires UTF-8 from clients, and for now it only supports ascii as casemapping.

Build and install

Prerequisites:

• The Rust compiler (at least version 1.39, or v1.41 when using PostgreSQL) and Cargo: https://rustup.rs/
• SQLite 3 (if the sqlite feature is enabled)
• PostgreSQL client libraries (if the postgres feature is enabled)
• On Linux, the OpenSSL library and its development files

Install ellidri with cargo install ellidri, or with the AUR package.

During development, build it with cargo build, and run it with cargo run.

For packaging, build it with cargo build --release --locked. The release flag will enable optimizations and the locked flag will require a valid lock file (Cargo.lock), to make sure that the same dependencies are used for development and for release. The executable is generated at target/release/ellidri.

Usage

ellidri must be started with a configuration file, for example:

# Configuration file
domain  your.domain.tld

# Bind to an address and port.
bind_to 127.0.0.1:6667

# TLS-enabled port, with a PKCS12 archive.
bind_to 0.0.0.0:6697 /var/lib/ellidri/identity.p12

# Default is /etc/motd
motd_file  custom_motd.txt

And start ellidri with the --config argument like so:

ellidri --config /path/to/the.configuration.file

An example configuration file with all settings and their defaults can be found in doc/ellidri.conf.

Contributing

Patches are welcome! Here are some links to get started:

• Documentation: https://docs.rs/ellidri (please note! This documentation only shows public items, but private items are also documented! Developpers can generate the documentation by hand the command below)
• Git repository: https://git.sr.ht/~taiite/ellidri
• Submit PRs on Github or send patches to the mailing list: https://lists.sr.ht/~taiite/public-inbox
• Report bugs on the issue tracker: https://todo.sr.ht/~taiite/ellidri

When developing ellidri, you can use the following command to generate the documentation of all items:

cargo doc --no-deps --document-private-items --open

Acknowledgments

ellidri couldn't have existed without the help of https://ircdocs.horse. Thank you Daniel Oaks and all other contributors!

Also thanks to the IRCv3 working group for all the work on modernizing the IRC protocol!

License

ellidri is under the ISC license. See LICENSE for a copy.