[](https://crates.io/crates/matrix-commander)
[](https://crates.io/crates/matrix-commander)
<p>
<img
src="https://raw.githubusercontent.com/8go/matrix-commander-rs/master/logos/matrix-commander-rs.svg"
alt="MC logo" height="150">
# 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](https://github.com/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](https://github.com/8go/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](https://github.com/8go/matrix-commander-rs/).
Please help! :pray: Please contribute code to enhance this
[matrix-commander](https://crates.io/crates/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](help/manual.txt).