matrix-commander-rs

simple but convenient CLI-based Matrix client app for sending, receiving, and much more

News

For the reason of transparency and the reason of appreciation I would like to announce that as of June 2026 there is a new maintainer on the project: @Benjamin-Loison. He has full permissions including publishing new releases. Welcome ❤️ and thanks.

Help create this Rust program

This Rust project is currently bare essentials. A more feature-rich Python package matrix-commander exists. See matrix-commander. The vision is to have a compatible program in Rust. This project depends on you. The project will only advance if you provide some code. Have a look at the repo matrix-commander-rs. Please help! :pray: Please contribute code to enhance this matrix-commander crate. Safe!

:heart: :clap: :pray:

What works so far

• Login with password
• Login with access token (restore login)
• Encryption
• Manual and Emoji verification
• Sending one or multiple text message to one or multiple rooms
• Sending one or multiple text message to one or multiple rooms
• Listening for new and incoming messages on one or multiple rooms
• Getting and printing old messages
• Listing devices
• Creating, leaving and forgetting rooms
• Kicking, banning, etc. on rooms
• Getting, setting and removing user avatar
• Getting room info
• Logout and removal of device
• Things like argument parsing, logging, output in JSON format, etc.
• Creating a brand new client, sending a message and destroying the client all in a single command. This send-and-forget command is: matrix-commander-rs --login password --user-login @john:some.homeserver.org --homeserver https://some.homeserver.org --password secret --device matrix-commander-rs --room-default \!someRoomId:some.homeserver.org --message Hello --logout me.

What you can do

• Give a :star: on GitHub. The more stars on GitHub, the more people will see the project. Do it now, thanks. :clap:
• Talk about it to your friends, post it in chatrooms, Hacker News, etc. This will give exposure and help find people willing to provide code, contributions, and PRs.
• Write code yourself. :rocket: Features that you might want to code:
  • implement login via SSO
  • add --proxy (see Python documentation)
  • add --nossl (see Python documentation)
  • add --event (see Python documentation and JSON config file in Python repo)
  • add --download-media (see Python documentation)
  • add other features found in the Python version to the Rust version
  • ...

Contributors :clap:

• These are the first contributors: https://github.com/sasa-tomic, https://github.com/jknedlik, https://github.com/dwattttt, https://github.com/Benjamin-Loison, ...
• Who will be next?
• Add your name here.

Manual

See help/manual.txt.