mirror of
https://git.sr.ht/~emerson/reflectionircd
synced 2025-08-21 05:43:46 +00:00
54 lines
No EOL
2.6 KiB
Markdown
54 lines
No EOL
2.6 KiB
Markdown
# ReflectionIRCd
|
|
|
|
ReflectionIRCd is an IRCd that interfaces with Matrix, allowing you to use an IRC client to chat on Matrix.
|
|
|
|
This is **very much** not production-ready yet. There's `console.log`s all over the place, no testing or error checking, lots of bugs, etc.
|
|
That said, it is usable for basic chatting.
|
|
|
|
## Highlights
|
|
|
|
- IRC first: The goal is for modern IRC clients to have feature parity with any other Matrix client
|
|
- Standalone: Uses the Client-Server API, so you can use it with any homeserver
|
|
- Built-in bouncer: Multiple IRC clients can be authenticated to a Matrix user
|
|
- Multi-user: Log in to multiple Matrix users at the same time
|
|
|
|
## Feature support
|
|
|
|
✅ - Implemented
|
|
🟨 - Partially implemented, see notes
|
|
❌ - Not implemented yet
|
|
⬜ - Not applicable
|
|
|
|
<small>(IRCv3)</small> denotes IRC features that might not be available in all clients
|
|
|
|
| Name | M->I | I->M | Notes |
|
|
| ---- | :--: | :--: | ----- |
|
|
| text, notice, emote messages | ✅ | ✅ ||
|
|
| image, file, audio, video messages | 🟨 | ⬜ | Show up as links on IRC |
|
|
| Channel joins | ✅ | ❌ ||
|
|
| Channel parts | ✅ | ✅ ||
|
|
| Channel kicks | ✅ | ✅ ||
|
|
| Channel bans | 🟨 | ❌ | Single-user bans show up on IRC as kicks, there's no banlist yet |
|
|
| Channel invites | ✅ | ✅ ||
|
|
| Channel topics | ✅ | ✅ ||
|
|
| Channel powers | ❌ | ❌ ||
|
|
| Channel lists/searching | ⬜ | ❌ ||
|
|
| Encrypted rooms | ❌ | ⬜ ||
|
|
| Rich text | ❌ | ❌ ||
|
|
| Presence | ❌ | ❌ ||
|
|
| Channel renaming <small>(IRCv3)</small> | 🟨 | ❌ | Only when the canonical alias changes |
|
|
| Message replies <small>(IRCv3)</small> | ✅ | ✅ | Clients without support will still receive the reply message, but it won't be marked as a reply |
|
|
| Message reactions <small>(IRCv3)</small> | 🟨 | 🟨 | Can't undo reactions yet |
|
|
| Extended invites <small>(IRCv3)</small> | ✅ | ✅ ||
|
|
| Chat history <small>(IRCv3)</small> | ⬜ | ❌ ||
|
|
| Multiline messages <small>(IRCv3)</small> | ❌ | ❌ ||
|
|
| Global display names <small>(IRCv3)</small> | ❌ | ❌ ||
|
|
| Per-room display names <small>(IRCv3)</small> | ❌ | ❌ ||
|
|
| Message editing <small>(IRCv3)</small> | ❌ | ❌ ||
|
|
| Message deletion <small>(IRCv3)</small> | ❌ | ❌ ||
|
|
|
|
## Running
|
|
Copy `config.example.json` to `config.json`, edit the values if needed, then `npm run build` and then `node reflection.js` to start it
|
|
|
|
## Authentication
|
|
Authentication is done via `SASL PLAIN`, the username is your mxid and the password is an access token from another session plus your server domain, separated by a `:` (so `access_token:matrix.org` if your server is matrix.org). Note this is the domain for `m.server`, not necessarily the homeserver domain. |