A command line client for the matrix protocol written in Python 3, largely inspired by Weechat and Poezio.

bobbyblues 91485386c9 Updated readme file. 1 year ago
config 2e4a33f3a5 Added shiny rooms when talked to. 1 year ago
gui 2e4a33f3a5 Added shiny rooms when talked to. 1 year ago
poezio 6be26fa9c0 Added input and basic commands (exit and set-theme). 1 year ago
.gitignore 277ea12734 initial commit 1 year ago
LICENSE.txt 6db490fa41 Creation of skeleton for Stokes. 1 year ago
README.md 91485386c9 Updated readme file. 1 year ago
matrixhelper.py 7b3b72b093 Can now display messages properly. Receives messages. Fixed usernames in people rooms. Error while navigating earlier messages. 1 year ago
stokes.py 91485386c9 Updated readme file. 1 year ago

README.md

Stokes

A command line client for the matrix protocol written in Python 3, largely inspired by Weechat and Poezio.

This client is still work in progress.

How to install

Clone the project, and copy the configuration file to your config directory

mkdir $XDG_CONFIG_HOME/stokes
cp -R Stokes/config/* $XDG_CONFIG_HOME/stokes

If $XDG_CONFIG_HOME is not set, use ~/.config/ instead.

Then edit the config.json file to add your login information. Finally, launch the stokes.py file.

How to use

Here are some available shortcuts:

  • F2/F3: change the rooms list width
  • F4: Hide or show the rooms list
  • F5 or Ctrl+P: Go to previous room
  • F6 or Ctrl+N: Go to next room

Here are some available commands (that you can type as if you were sending a message):

  • /exit: exits Stokes
  • /set-theme X: changes the theme for X where X is the name of a theme file in your config directory.

License

Unless stated otherwise, all files are subject to the zlib license as described in the LICENSE.txt file.

Files in the poezio directory are — or were at some point — part of the poezio (https://poez.io) project and are subject to their own license. See the poezio/POEZIO.txt file for more information.