cyberes
/
matrix-room-exporter
1
0
Fork 0
Code Issues Pull Requests Packages Projects Releases Wiki Activity
Export a Matrix a room.
12 Commits 1 Branch 0 Tags 65 KiB
Python 100%
Go to file
Cyberes d205622b10 fix missing config vars 2024-04-04 00:28:51 -06:00
exporter few more adjustments 2024-04-04 00:15:34 -06:00
.gitignore add files 2024-04-03 22:57:54 -06:00
LICENSE Initial commit 2024-04-03 19:41:36 -06:00
README.md update readme 2024-04-04 00:21:05 -06:00
config.yml.sample add files 2024-04-03 22:57:54 -06:00
main.py fix missing config vars 2024-04-04 00:28:51 -06:00
matrix-room-exporter.service logging and more info and service 2024-04-03 23:07:42 -06:00
requirements.txt add files 2024-04-03 22:57:54 -06:00

README.md

matrix-room-exporter

Export a Matrix a room.

A quick-n-dirty bot that exports a Matrix room and uploads the archive to a Cloudflare R2 bucket for the room to download.

Install

  1. pip install -r requirements.txt
  2. cp config.yml.sample config.yml
  3. Create a Cloudflare R2 bucket.
  4. Enable public access.
  5. Create an access key.
  6. Configure config.yml with your R2 credentials.
  7. Set up an object lifecycle rule to auto-delete old exports from your bucket. 24 hours is a good choice.
  8. Set up a matrix-org/pantalaimon for encrypted sync.
  9. Create a new Matrix user and configure it in config.yml.
  10. Start the bot with python3 main.py

Use

  1. Invite the new bot to the room you want to export.
  2. Send the message !export to start the export process.

The bot will upload the exported room to your R2 bucket and share the link with the room.

Remember, if your room is encrypted and new members can't see old history prior to their joining then the bot won't be able to export anything earlier than when it joined.able to export anything earlier than when it joined.