An early attempt at an irssi Matrix module. Very early alpha state.
 
 
 
 
Go to file
Andrej Kacian d3255acd1c Fix instructions in README 2023-09-09 22:11:50 +02:00
src Add GPL2 header commend to all .c files 2023-05-07 02:23:48 +02:00
.gitignore
COPYING
Makefile.am
README.md Fix instructions in README 2023-09-09 22:11:50 +02:00
autogen.sh
configure.ac

README.md

Matrix client module for Irssi

This is still an early work in progress. The module so far can:

  • define a Matrix connection (with some manual Irssi config editing)
  • connect to a Matrix server
  • authenticate using either a password or an existing access token
  • recognize joined rooms and create channel windows in Irssi for each
  • poll for new events
  • show some basic room events like joins, leaves and text messages
  • send basic text messages to rooms
  • ...and that's it

Installation

Requires:

To build, use the usual autotools steps:

  • ./autogen.sh
  • ./configure
  • make && sudo make install

Usage

Due to how networks and servers work in Irssi, the way to define a Matrix connection is a bit peculiar:

  1. Load the module in Irssi
/load matrix
  1. Add a network definition manually in your irssi configuration, in "chatnets" section. Something like:
matrix_foo = { type = "matrix"; };
  1. Start Irssi and load the "matrix" module.
  2. Create a server in the added network, using your Matrix ID as server address.
/server add -network matrix_foo @foo:example.org 0 secretpassword

...or, if you want to use access token from an existing Matrix login session...

/server add -network matrix_foo -access_token mysecrettoken @foo:example.org
  1. Connect to the network, or to the server
/connect matrix_foo

...or...

/connect @foo:example.org

Contact

I am "Ticho" on #irssi channel on Libera IRC network, or "@ticho:cyberdi.sk" on Matrix.