|
||
---|---|---|
src | ||
.gitignore | ||
COPYING | ||
Makefile.am | ||
README.md | ||
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:
- irssi headers
- glib-2 headers
- matrix-glib from https://codeberg.org/ticho/matrix-glib (the official repo on github is outdated)
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:
- Load the module in Irssi
/load matrix
- Add a network definition manually in your irssi configuration, in "chatnets" section. Something like:
matrix_foo = { type = "matrix"; };
- Start Irssi and load the "matrix" module.
- 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
- 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.