https://github.com/shymega/matrix-migrate
CLI to migrate your matrix account from one to the other
https://github.com/shymega/matrix-migrate
Last synced: 5 months ago
JSON representation
CLI to migrate your matrix account from one to the other
- Host: GitHub
- URL: https://github.com/shymega/matrix-migrate
- Owner: shymega
- Created: 2024-08-25T19:35:21.000Z (almost 2 years ago)
- Default Branch: main
- Last Pushed: 2024-08-28T08:08:09.000Z (almost 2 years ago)
- Last Synced: 2025-09-28T23:33:01.643Z (9 months ago)
- Homepage:
- Size: 86.9 KB
- Stars: 0
- Watchers: 0
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: Readme.md
Awesome Lists containing this project
README
# matrix migrate
CLI to migrate one matrix account to a new one. Similar to [the EMS migrator][ems tool] but:
1. is a nice little CLI tool, based on `matrix-rust-sdk`
2. allows for restarts (refreshes at the beginning)
3. it runs the operations async and is thus a lot faster
_Note_:
It currently only migrates the rooms listing and power_levels, no user settings or profile data.
## Install and use
You need a recent [Rust] installation. Then you can either clone the repository
and use `cargo run` or use cargo-install:
```
cargo install https://matrix.org/acterglobal/matrix-migrate
```
and then can run it by just doing
```
matrix-migrate
```
### Usage note
It requires both the user and password for the user `from` and `to` either as
command line parameters, or preferably as environment variables (`FROM_USER=`,
`FROM_PASSWORD`). It uses matrix discovery but if that doesn't work for you
you can provide custom homeservers, too.
It will start with a full-sync of the room state, so depending on the size of
your matrix account(s), this may take a moment.
## Changelog
**Unreleased**
- Add support for matching up `power_levels`, needs latest matrix-rust-sdk-git
[ems tool]: https://ems.element.io/tools/matrix-migration