Skip to content

README.md

Latest commit

 

History

History
136 lines (99 loc) · 4.65 KB

README.md

File metadata and controls

136 lines (99 loc) · 4.65 KB
Raw

TB-TaXync

Eine Thunderbird WebExtension zum Synchronisieren von E-Mail-Tags/Beschriftungen zwischen mehreren Computern und Thunderbird-Installationen.

Version License Thunderbird

🎯 Was macht TB-TaXync?

TB-TaXync synchronisiert deine Thunderbird-Tags (Beschriftungen/Keywords) zwischen mehreren Computern. So haben alle deine E-Mail-Tags überall den gleichen Stand:

  • 📤 Exportiert deine Tags in eine JSON-Datei
  • 💾 Speichert die Datei an einem zentralen Ort (lokal, SMB, Cloud, etc.)
  • 📥 Importiert die Tags auf anderen Computern automatisch

✨ Features

  • ✅ Manuelle & Automatische Synchronisierung: Wähle zwischen manuell oder zeitgesteuert
  • ✅ Echtzeit-Sync: Optional bei jeder Tag-Änderung synchronisieren
  • ✅ Flexible Sync-Tools: Syncthing (⭐ empfohlen), Dropbox, SMB, NFS, SSH/SFTP
  • ✅ Deutsche Benutzeroberfläche: Vollständig auf Deutsch
  • ✅ Debug-Logs: Detaillierte Logs mit Fehlerbehandlung
  • ✅ Fallback-Support: Nutzt Browser-Storage wenn Dateisystem nicht verfügbar
  • ✅ Moderne APIs: Thunderbird 128+ Manifest v3
  • ✅ Konfliktauflösung: "Neuere wins" Strategie

📋 Anforderungen

  • Thunderbird 128.0 ESR oder höher (erforderlich für Manifest v3)
  • Syncthing, Dropbox, SMB/NFS oder anderes Sync-Tool (optional aber empfohlen)

🚀 Schnellstart

Installation

  • Thunderbird 128+ erforderlich
  • XPI-Datei laden: thunderbird-sync-labels.xpi
  • Tools → Add-ons and Themes → Zahnrad-Icon ⚙️ → Debug Add-ons
  • Load Temporary Add-on → manifest.json auswählen

Konfiguration

  1. Extension-Icon klicken → "Einstellungen öffnen"
  2. Tab "📖 Übersicht" lesen
  3. Tab "⚙️ Einstellungen":
    • Pfad zur Sync-Datei eingeben (z.B. ~/Sync/thunderbird-tags.json)
    • Optional: Automatische Synchronisierung aktivieren
    • Optional: "Bei Änderungen synchronisieren" aktivieren
  4. "Einstellungen speichern" klicken

Erste Synchronisierung

  • Klick "Sync testen" um Konfiguration zu prüfen
  • Klick im Popup "Jetzt synchronisieren"
  • Logs im Tab "📋 Logs" überprüfen

🔧 Sync-Tools (empfohlen nach Reihenfolge)

Tool Beschreibung Setup
⭐ Syncthing Dezentral, privat, keine Server einfach
Dropbox / Google Drive Cloud-basiert sehr einfach
SMB / NAS Netzwerk-Freigaben mittel
NFS Linux Netzwerk-FS mittel
SSH/SFTP Server-Zugriff komplex

🏗️ Projektstruktur

tb-taxync/
├── manifest.json              # Manifest v3 Konfiguration
├── background.js              # Hintergrund-Service
├── popup.html/js              # Schnell-Sync UI
├── settings.html/js           # Konfiguration & Logs
├── backends/
│   ├── filesystem-backend.js  # Datei-Speicher
│   └── storage-backend.js     # Browser-Storage Fallback
├── sync/
│   ├── sync-engine.js         # Sync-Logik
│   ├── tag-manager.js         # Thunderbird-Integration
│   ├── error-handler.js       # Logging & Fehlerbehandlung
│   └── path-discovery.js      # Pfad-Erkennung
└── icons/                     # Extension-Icons

💻 Entwicklung

Dateien ändern und testen

# 1. Datei bearbeiten (z.B. settings.html)
# 2. XPI bauen
zip -r thunderbird-sync-labels.xpi \
  manifest.json background.js popup.html popup.js \
  settings.html settings.js \
  backends/*.js sync/*.js icons/*.png experiments/**/*

# 3. In Thunderbird neu laden
# Tools → Developer Tools → Browser Console

Debug-Tipps

  1. Browser Console öffnen: Tools → Developer Tools → Browser Console (Ctrl+Shift+J)
  2. Filter nach Logs: Suche nach [Filesystem], [SyncEngine], [TagManager]
  3. Extension-Logs: Tab "📋 Logs" in den Einstellungen öffnen

📚 Ressourcen

🐛 Bekannte Limitationen

  • Keine direkte Tag-Erstellung via WebExtension API (nur Import/Export)
  • Konfliktauflösung: "Neuere wins" (kein 3-Way-Merge)
  • Benötigt Experiment APIs in Thunderbird 128+

🤝 Beitragen

Contributions willkommen!

  1. Fork & Clone
  2. Feature-Branch: git checkout -b feature/xyz
  3. Commit: git commit -m "Add feature xyz"
  4. Push & Pull Request erstellen

📄 Lizenz

MIT License - siehe LICENSE

👤 Autor

Entwickelt mit Claude Code