Files
matrix-chat-export/README.md
Patrick Asmus 4dae5477ce
Some checks failed
Build & Push Docker Image / build-and-push (push) Failing after 5s
Add application, Dockerfile, CI workflow and documentation
- FastAPI-based Matrix chat export tool with E2E support
- Dockerfile with Python 3.12-slim base image
- Docker Compose with dedicated network configuration
- Gitea Actions workflow for automated image builds
- README with setup instructions and feature overview
- MIT license

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
2026-07-03 08:04:27 +02:00

2.7 KiB

Techniverse Community

Matrix Chat Export

Web-basiertes Tool zum Exportieren von Matrix-Chaträumen inkl. Medien und E2E-Verschlüsselung

🏰 Website · 📰 Community · 🐘 Mastodon · 💬 Support


Funktionen

  • Matrix-Chaträume exportieren — vollständiger Nachrichtenverlauf als HTML-Datei
  • Medien-Download — Bilder, Videos, Audio, Dateien und Sticker werden mitgespeichert
  • E2E-Verschlüsselung — Import von Megolm-Schlüsseln zum Entschlüsseln verschlüsselter Nachrichten
  • Inkrementeller Export — bei erneutem Export werden nur neue Nachrichten geladen
  • ZIP-Download — fertigen Export als ZIP-Archiv herunterladen
  • Zwei Login-Methoden — Anmeldung per Access Token oder Benutzername/Passwort
  • Session-Wiederherstellung — bestehende Sitzungen werden automatisch wiederhergestellt

Voraussetzungen

  • Docker & Docker Compose

Installation

git clone https://git.techniverse.net/scriptos/matrix-chat-export.git
cd matrix-chat-export
docker compose up -d

Die Anwendung ist anschließend unter http://<host>:8092 erreichbar.

Konfiguration

Variable Beschreibung Standard
TZ Zeitzone Europe/Berlin
LOG_LEVEL Log-Level (DEBUG, INFO, WARNING, ERROR) INFO

Volumes

Pfad (Container) Beschreibung
/app/exports Gespeicherte Chat-Exports
/app/store Session-Daten und importierte Schlüssel

Verwendung

  1. Anwendung im Browser öffnen
  2. Mit dem Matrix-Homeserver verbinden (Token oder Passwort)
  3. Optional: E2E-Schlüssel importieren (für verschlüsselte Räume)
  4. Raum auswählen und Export starten
  5. Export als HTML ansehen oder als ZIP herunterladen

Hinweis: Es wird kein Admin-Token benötigt. Ein normaler Benutzer-Access-Token ist ausreichend. Die Anwendung greift ausschließlich auf Räume zu, in denen der Benutzer Mitglied ist.

Technologie

  • Backend: Python 3.12, FastAPI, matrix-nio
  • Container: Docker mit Python-Slim Base Image



© Patrick Asmus · Techniverse Network · Lizenz