|Jez Cope 007c81015d
mxadm: a simple CLI to automate Matrix room admin tasks
mxadm is a simple command-line tool
to do some basic Matrix room admin tasks,
especially things which don't currently have a UI in Element,
or which are possible but require a fair bit of effort
(e.g. using Element's devtools).
It should be considered unstable: the command-line arguments will evolve as the tool itself evolves, but the functionality should roughly the same.
Not yet packaged for any OS as far as I'm aware.
You can install it with Rust's
$ cargo install mxadm
The only documentation is currently via the tool itself:
$ mxadm help
Jez Cope <email@example.com>
A simple CLI interface to basic Matrix room admin tasks
-h, --help Prints help information
-V, --version Prints version information
alias alias subcommands
help Prints this message or the help of the given subcommand(s)
login authenticates and saves the session details
logout ends the current session
room room subcommands
status displays current session status
Development & contributions
This is a hobby project of mine, developed for my own use case, but I would be delighted if someone else wanted to use it! If you find bugs or want to request new features please feel free to create a new issue (it's running gitea and you can sign in with GitHub or Twitter) but bear in mind that it will probably take me some time to get around to responding or doing something about it! If you want something changing and have the skills, a pull request/patch will probably be quicker, but there will still be delays before I can review and merge it.
I'm also pretty new to Rust, so my code may not be the best; constructive code review very welcome!
- Login and store session info
- Log out
- Show login status
- Tombstone room
- Add room alias
- Remove room alias
- Set canonical room alias
- Optionally create alias in one command
- Remove canonical room alias
- List rooms
- Filter room list in various ways (esp. Spaces!)
- Handle multiple accounts on different homeservers
- Upgrade room
- Make it easier to script workflows like "configure ACL permissions -> invite mjolnir -> op mjolnir" in multiple rooms
Copyright (C) 2021 Jez Cope
This program is free software: you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation, either version 3 of the License, or (at your option) any later version.
This program is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details.
You should have received a copy of the GNU General Public License along with this program. If not, see https://www.gnu.org/licenses/.