https://github.com/poljar/weechat-matrix-rs

Rust rewrite of the python weechat-matrix script.
https://github.com/poljar/weechat-matrix-rs

matrix-org rust weechat

Last synced: about 1 year ago
JSON representation

Rust rewrite of the python weechat-matrix script.

• Host: GitHub
• URL: https://github.com/poljar/weechat-matrix-rs
• Owner: poljar
• License: other
• Created: 2019-11-04T19:01:21.000Z (over 6 years ago)
• Default Branch: main
• Last Pushed: 2025-03-18T19:24:14.000Z (about 1 year ago)
• Last Synced: 2025-04-06T11:12:24.118Z (about 1 year ago)
• Topics: matrix-org, rust, weechat
• Language: Rust
• Size: 840 KB
• Stars: 365
• Watchers: 23
• Forks: 30
• Open Issues: 43
• Metadata Files:
  • Readme: README.md
  • License: LICENSE

Awesome Lists containing this project

README

          
[![build-test-release](https://github.com/poljar/weechat-matrix-rs/actions/workflows/release.yml/badge.svg?event=push)](https://github.com/poljar/weechat-matrix-rs/actions/workflows/release.yml)

[![#weechat-matrix](https://img.shields.io/badge/matrix-%23weechat--matrix:termina.org.uk-blue.svg?style=flat-square)](https://matrix.to/#/!twcBhHVdZlQWuuxBhN:termina.org.uk?via=termina.org.uk&via=matrix.org)

[![license](https://img.shields.io/badge/license-ISC-blue.svg?style=flat-square)](https://github.com/poljar/weechat-matrix-rs/blob/master/LICENSE)

# What is weechat-matrix?

[Weechat](https://weechat.org/) is an extensible chat client.

[Matrix](https://matrix.org/blog/home) is an open network for secure,

decentralized communication.

weechat-matrix-rs is a Rust plugin for Weechat that lets Weechat communicate

over the Matrix protocol. This is a Rust rewrite of the

[weechat-matrix](https://github.com/poljar/weechat-matrix) Python script.

# Project status

This project is a work in progress and doesn't do much yet. It can connect

to a Matrix server and send messages.

If you are interested in helping out take a look at the issue tracker.

# Build

After Rust is installed the plugin can be compiled with:

    cargo build

On Linux this creates a `libmatrix.so` file in the `target/debug/` folder, this

file needs to be renamed to `matrix.so` and copied to your Weechat plugin

directory. A plugin directory can be created in your `$WEECHAT_HOME` folder, by

default `.weechat/plugins/`.

Alternatively, `make install` will build and install the plugin in your

`$WEECHAT_HOME` as well.

# Configuration

Configuration is completed primarily through the Weechat interface. First start Weechat, and then issue the following commands _(replace the placeholders in brackets [] with your own details)_:

1. Add a server _(make sure the url includes the scheme e.g. 'https://matrix.org')_:

       /matrix server add [server-name] [server-url]

2. Set your username and password:

       /set matrix-rust.server.[server-name].username [username]

       /set matrix-rust.server.[server-name].password [password]

3. Now try to connect:

       /matrix connect [server-name]

4. Automatically connect to the server:

       /set matrix-rust.server.[server-name].autoconnect on

5. If everything works, save the configuration:

       /save

# Helpful Commands

`/help matrix` will print information about the `/matrix` command.

`/matrix help [command]` will print information for subcommands, such as `/matrix help server`