Unterschiede

Hier werden die Unterschiede zwischen zwei Versionen angezeigt.

--- guideos_browser_mail_backup [2026/01/31 15:05] – [Übersicht] ktt73
+++ guideos_browser_mail_backup [2026/02/01 18:15] (aktuell) – [Liezenz] ktt73
@@ Zeile 1: / Zeile 1: @@
+owser-mail-backup_dokuwiki_kompakt.txt
 ====== GuideOS Browser & Mail Backup-Tool ======
 ===== Übersicht =====
-Das **Browser & Mail Backup-Tool** ist ein Zenity-basiertes Bash-Skript zum Sichern und Wiederherstellen von Browser- und E-Mail-Profilen unter Linux. Das Tool unterstützt Firefox, Chromium, Vivaldi, LibreWolf, Google Chrome, Brave und Thunderbird und bietet optionale GnuPG-Verschlüsselung für maximale Datensicherheit [file:7].
+Das **Browser & Mail Backup-Tool** ist ein Zenity-basiertes Bash-Skript zum Sichern und Wiederherstellen von Browser- und E-Mail-Profilen unter Linux [file:7].
-^ Eigenschaft ^ Wert ^
-| **Autor** | evilware666 |
-| **Datum** | 2025-08-29 |
-| **Version** | 1.2 |
-| **Lizenz** | MIT (Open Source) |
-| **Benutzeroberfläche** | Zenity (GTK-Dialoge) |
-| **Projektseite** | [[https://guideos.de/|guideos.de]] |
-===== Funktionen =====
-  * Sicherung und Wiederherstellung von Browser-Profilen
+===== Zweck =====
-  * Unterstützung für 7 verschiedene Programme
-  * Optionale GPG-Verschlüsselung der Backups
+Das Tool ermöglicht das einfache Sichern und Wiederherstellen von Profil-Ordnern für verschiedene Browser und E-Mail-Clients. Backups können optional mit GnuPG verschlüsselt werden, um sensible Daten wie Passwörter, Cookies und Lesezeichen zu schützen.
-  * Grafische Benutzeroberfläche mit Zenity
-  * Automatische Übernahme des System-Themes (Cinnamon)
-  * Komprimierte Backups im TAR.GZ-Format
-  * Zeitstempel-basierte Dateinamen
-  * Warnungen vor Datenverlust
 ===== Unterstützte Programme =====
+{{ :browser-und-mail-backup.png?300|}}
+^ Programm ^ Profilverzeichnis ^
+| **Firefox** | ''~/.mozilla'' |
+| **Chromium** | ''~/.config/chromium'' |
+| **Vivaldi** | ''~/.config/vivaldi'' |
+| **LibreWolf** | ''~/.librewolf'' |
+| **Google Chrome** | ''~/.config/google-chrome'' |
+| **Brave** | ''~/.config/BraveSoftware'' |
+| **Thunderbird** | ''~/.thunderbird'' |
-^ Programm ^ Profilverzeichnis ^ Typ ^
+===== Bedienung =====
-| **Firefox** | ''~/.mozilla'' | Browser |
-| **Chromium** | ''~/.config/chromium'' | Browser |
-| **Vivaldi** | ''~/.config/vivaldi'' | Browser |
-| **LibreWolf** | ''~/.librewolf'' | Browser |
-| **Google Chrome** | ''~/.config/google-chrome'' | Browser |
-| **Brave** | ''~/.config/BraveSoftware'' | Browser |
-| **Thunderbird** | ''~/.thunderbird'' | E-Mail-Client |
-===== Installation =====
-==== Abhängigkeiten ====
-<code bash>
-# Für Debian/Ubuntu-basierte Systeme
-sudo apt install zenity tar gzip gnupg
-# Für Arch-basierte Systeme
-sudo pacman -S zenity tar gzip gnupg
-</code>
-==== Skript installieren ====
-<code bash>
-# Skript ausführbar machen
-chmod +x guideos-browser-mail-backup
-# Optional: In Systempfad verschieben
-sudo mv guideos-browser-mail-backup /usr/local/bin/
-</code>
-===== Verwendung =====
 ==== Programm starten ====
-<code bash>
-guideos-browser-mail-backup
-</code>
-Oder aus dem Anwendungsmenü von GuideOS starten.
+''guideos-browser-mail-backup''
-==== Willkommensbildschirm ====
+Oder aus dem Anwendungsmenü
-Beim Start erscheinen zwei Info-Dialoge:
-  - Begrüßung mit Funktionsbeschreibung
-  - **Wichtiger Hinweis**: Alle betreffenden Programme MÜSSEN geschlossen sein!
+==== Backup erstellen ====
-**⚠️ ACHTUNG ⚠️**
+  - **Aktion wählen**: "Sichern" auswählen
+  - **Verschlüsselung**: Optional "Ja" wählen für GPG-Verschlüsselung
+  - **Profil auswählen**: Gewünschten Browser/E-Mail-Client wählen
+  - **Zielordner**: Speicherort für das Backup auswählen
+  - **Passwort** (bei Verschlüsselung): Sicheres Passwort eingeben
+  - Backup wird erstellt als: ''<Programm>_backup_YYYY-MM-DD_HH-MM-SS.tar.gz'' (oder ''.tar.gz.gpg'' bei Verschlüsselung)
-Alle Browser und Thunderbird müssen vor der Sicherung oder Wiederherstellung vollständig geschlossen werden! Andernfalls kann es zu Datenverlust oder beschädigten Backups kommen.
+==== Backup wiederherstellen ====
-===== Workflow: Backup erstellen =====
+  - **Aktion wählen**: "Wiederherstellen" auswählen
+  - **Profil auswählen**: Programm wählen, dessen Backup wiederhergestellt werden soll
+  - **Warnung bestätigen**: Bestätigen, dass bestehende Daten überschrieben werden
+  - **Backup-Datei wählen**: Backup-Datei auswählen
+  - **Passwort** (bei Verschlüsselung): Passwort zur Entschlüsselung eingeben
+  - Profil wird wiederhergestellt
-==== Schritt 1: Aktion wählen ====
+===== Wichtige Hinweise =====
-Wähle **"Sichern"** aus dem Dialog.
+<WRAP round important 90%>
+  * **Alle betreffenden Programme MÜSSEN geschlossen sein** vor Sicherung oder Wiederherstellung
+  * Bei der Wiederherstellung werden **bestehende Profile überschrieben**
+  * Browser-Cache sollte nach Wiederherstellung geleert werden
+  * **Passwörter nicht vergessen** - verschlüsselte Backups sind ohne Passwort nicht wiederherstellbar
+  * Verschlüsselung wird **dringend empfohlen** bei externen Speicherorten (USB-Stick, Cloud)
+</WRAP>
-==== Schritt 2: Verschlüsselung wählen ====
-Entscheide ob das Backup verschlüsselt werden soll:
-  * **Ja**: Backup wird mit GPG symmetrisch verschlüsselt (Passwort erforderlich)
-  * **Nein**: Unverschlüsseltes TAR.GZ-Archiv
-==== Schritt 3: Profil auswählen ====
-Wähle das zu sichernde Programm aus der Liste:
-  * Firefox
-  * Chromium
-  * Vivaldi
-  * LibreWolf
-  * Google Chrome
-  * Brave
-  * Thunderbird
-==== Schritt 4: Zielordner wählen ====
-Wähle den Speicherort für das Backup über den Dateiauswahl-Dialog.
-==== Schritt 5: Verschlüsselungspasswort (optional) ====
-Falls Verschlüsselung gewählt wurde, Passwort eingeben.
-==== Schritt 6: Backup läuft ====
-Ein Fortschrittsdialog wird angezeigt. Das Tool erstellt:
-  * Dateiname-Format: ''<Programm>_backup_YYYY-MM-DD_HH-MM-SS.tar.gz''
-  * Bei Verschlüsselung: ''.tar.gz.gpg''
-==== Schritt 7: Abschluss ====
-Erfolgsmeldung mit vollständigem Backup-Pfad.
-===== Workflow: Backup wiederherstellen =====
-==== Schritt 1: Aktion wählen ====
-Wähle **"Wiederherstellen"** aus dem Dialog.
-==== Schritt 2: Profil auswählen ====
-Wähle das Programm, dessen Backup wiederhergestellt werden soll.
-==== Schritt 3: Warnung ====
-Dialog warnt vor Überschreiben bestehender Profil-Ordner.
-==== Schritt 4: Backup-Datei auswählen ====
-Wähle die Backup-Datei (''.tar.gz'' oder ''.tar.gz.gpg'').
-==== Schritt 5: Entschlüsselung (falls nötig) ====
-Bei verschlüsselten Backups Passwort eingeben.
-==== Schritt 6: Wiederherstellung ====
-Das Profil wird extrahiert und an den ursprünglichen Ort zurückkopiert.
-==== Schritt 7: Abschluss ====
-Erfolgsmeldung nach erfolgreicher Wiederherstellung.
-===== Technische Details =====
-==== Theme-Integration ====
-Das Skript übernimmt automatisch das Cinnamon-Desktop-Theme:
-<code bash>
-GTK_THEME=$(gsettings get org.cinnamon.desktop.interface gtk-theme | tr -d "'")
-export GTK_THEME
-</code>
-==== Backup-Erstellung ====
-Backup wird mit ''tar'' erstellt:
-<code bash>
-DATE=$(date +%Y-%m-%d_%H-%M-%S)
-BACKUP_NAME="$BACKUP_DIR/${PROFILE}_backup_${DATE}.tar.gz"
-tar -czf "$BACKUP_NAME" -C "$HOME" $PROFILES
-</code>
-**Optionen:**
-  * ''-c'': Erstellen eines neuen Archives
-  * ''-z'': Kompression mit gzip
-  * ''-f'': Dateiname angeben
-  * ''-C'': Arbeitsverzeichnis wechseln
-==== Verschlüsselung ====
-Backups werden mit GPG symmetrisch verschlüsselt:
-<code bash>
-echo "$PASSWORD" | gpg --batch --yes --passphrase-fd 0 -c "$BACKUP_NAME"
-</code>
-**Optionen:**
-  * ''--batch'': Nicht-interaktiver Modus
-  * ''--yes'': Automatisch mit "Ja" antworten
-  * ''--passphrase-fd 0'': Passwort von stdin lesen
-  * ''-c'': Symmetrische Verschlüsselung
-==== Entschlüsselung und Wiederherstellung ====
-<code bash>
-echo "$PASSWORD" | gpg --batch --yes --passphrase-fd 0 -d "$BACKUP_FILE" > "${BACKUP_FILE%.gpg}"
-tar -xzf "$BACKUP_FILE" -C "$HOME"
-</code>
-**Optionen:**
-  * ''-d'': Entschlüsseln
-  * ''-x'': Extrahieren
-===== Skript-Struktur =====
-==== Hauptfunktionen ====
-^ Funktion ^ Beschreibung ^
-| ''show_progress()'' | Zeigt Fortschrittsdialog während Backup/Wiederherstellung |
-| ''stop_progress()'' | Schließt Fortschrittsdialog |
-| Hauptschleife | Verarbeitet Benutzerauswahl und führt Aktionen aus |
-==== Variablen ====
-^ Variable ^ Zweck ^
-| ''ACTION'' | Speichert gewählte Aktion (Sichern/Wiederherstellen) |
-| ''USE_ENCRYPTION'' | Boolean für Verschlüsselung |
-| ''PROFILE_SELECTION'' | Gewähltes Programm |
-| ''BACKUP_DIR'' | Zielverzeichnis für Backup |
-| ''BACKUP_NAME'' | Vollständiger Pfad der Backup-Datei |
-| ''BACKUP_FILE'' | Pfad zur wiederherzustellenden Datei |
-| ''PROFILES'' | Zu sichernde Verzeichnisse |
-| ''DATE'' | Zeitstempel für Dateiname |
-| ''PROGRESS_PID'' | Prozess-ID des Fortschrittsdialogs |
-===== Praktische Beispiele =====
-==== Firefox-Profil sichern (verschlüsselt) ====
-  - Tool starten
-  - "Sichern" wählen
-  - Verschlüsselung: "Ja"
-  - Profil: "Firefox"
-  - Zielordner: ''~/Backups''
-  - Passwort eingeben (merken!)
-  - Ergebnis: ''~/Backups/Firefox_backup_2026-01-31_14-30-00.tar.gz.gpg''
-==== Thunderbird wiederherstellen (unverschlüsselt) ====
-  - Thunderbird schließen
-  - Tool starten
-  - "Wiederherstellen" wählen
-  - Profil: "Thunderbird"
-  - Warnung bestätigen
-  - Backup-Datei auswählen
-  - Wiederherstellung läuft
-  - Thunderbird starten → alte Daten sind zurück
-==== Mehrere Browser sichern ====
-Das Tool unterstützt nur ein Profil pro Durchlauf. Für mehrere Browser:
-<code bash>
-# Schleife über mehrere Browser
-for browser in Firefox Chromium Vivaldi; do
-  # Tool für jeden Browser separat aufrufen
-  guideos-browser-mail-backup
-done
-</code>
-**Oder**: Skript mehrfach manuell ausführen.
-===== Dateigrößen =====
-Typische Backup-Größen (abhängig von Nutzung):
-^ Programm ^ Durchschnittliche Größe ^
-| Firefox (wenig Nutzung) | 50-200 MB |
-| Firefox (intensive Nutzung) | 500 MB - 2 GB |
-| Chromium/Chrome | 100-500 MB |
-| Thunderbird (ohne E-Mails) | 10-50 MB |
-| Thunderbird (mit E-Mails) | 500 MB - 10 GB+ |
-**Tipp**: Große Thunderbird-Profile vor Backup aufräumen (alte E-Mails löschen, Papierkorb leeren).
-===== Sicherheitsaspekte =====
-==== Verschlüsselung empfohlen ====
-Browser-Profile enthalten sensible Daten:
-  * Gespeicherte Passwörter
-  * Cookies und Session-Tokens
-  * Lesezeichen
-  * Browserverlauf
-  * Autofill-Daten
-  * Gespeicherte Kreditkarten (bei Chrome/Chromium)
-**Empfehlung**: Immer Verschlüsselung verwenden bei externen Backups!
-==== Passwort-Sicherheit ====
-  * Starkes Passwort wählen (min. 12 Zeichen)
-  * Kombination aus Buchstaben, Zahlen, Sonderzeichen
-  * Passwort sicher aufbewahren (z.B. Passwort-Manager)
-  * Verschiedene Passwörter für verschiedene Backups
-==== Backup-Speicherorte ====
-^ Speicherort ^ Sicherheit ^ Empfehlung ^
-| Lokale Festplatte | Mittel | Zusätzlich verschlüsseln |
-| Externe Festplatte | Gut | Verschlüsselung + physisch sicher |
-| USB-Stick | Mittel | Nur verschlüsselt |
-| Cloud (Nextcloud, etc.) | Gut | Immer verschlüsseln |
-| NAS im Heimnetzwerk | Gut | Verschlüsselung empfohlen |
-===== Fehlersuche =====
-==== "Profil wurde nicht gefunden" ====
-**Ursache**: Das Programm ist nicht installiert oder wurde noch nie gestartet.
-**Lösung**:
-  * Programm installieren
-  * Programm mindestens einmal starten (Profil wird erstellt)
-  * Profil-Pfad prüfen: ''ls -la ~/.mozilla'' (für Firefox)
-==== "Fehler beim Sichern des Profils" ====
-**Mögliche Ursachen**:
-  * Programm läuft noch im Hintergrund
-  * Keine Schreibrechte im Zielordner
-  * Nicht genug Speicherplatz
-**Lösung**:
-<code bash>
-# Programme beenden
-pkill firefox
-pkill chromium
-pkill thunderbird
-# Schreibrechte prüfen
-ls -ld ~/Backups
-# Speicherplatz prüfen
-df -h
-</code>
-==== "Fehler bei der Verschlüsselung" ====
-**Ursache**: GPG nicht installiert oder Passwort-Eingabe abgebrochen.
-**Lösung**:
-<code bash>
-# GPG installieren
-sudo apt install gnupg
-# GPG testen
-gpg --version
-</code>
-==== "Fehler bei der Entschlüsselung" ====
-**Ursache**: Falsches Passwort eingegeben.
-**Lösung**:
-  * Korrektes Passwort erneut eingeben
-  * Bei vergessenen Passwort: Backup ist verloren (GPG-Verschlüsselung nicht knackbar)
-==== "Wiederherstellung überschreibt Daten" ====
-**Vorbeugung**:
-<code bash>
-# Aktuelles Profil vor Wiederherstellung sichern
-cp -r ~/.mozilla ~/.mozilla.backup-$(date +%Y%m%d)
-</code>
-===== Automatisierung =====
-==== Automatisches Backup via Cron ====
-Für automatisierte Backups müsste das Skript erweitert werden (aktuell GUI-basiert).
-Möglicher Workaround mit eigenem Skript:
-<code bash>
-#!/bin/bash
-# auto-backup.sh
-DATE=$(date +%Y-%m-%d_%H-%M-%S)
-BACKUP_DIR="$HOME/Backups"
-# Firefox sichern
-tar -czf "$BACKUP_DIR/Firefox_auto_$DATE.tar.gz" -C "$HOME" .mozilla
-# Verschlüsseln
-echo "DEIN_PASSWORT" | gpg --batch --yes --passphrase-fd 0 -c "$BACKUP_DIR/Firefox_auto_$DATE.tar.gz"
-rm "$BACKUP_DIR/Firefox_auto_$DATE.tar.gz"
-</code>
-Crontab-Eintrag:
-<code bash>
-# Täglich um 2 Uhr nachts
-2 * * * /home/user/auto-backup.sh
-</code>
-==== Backup vor System-Updates ====
-Für Arch Linux Hook:
-<code bash>
-# /etc/pacman.d/hooks/browser-backup.hook
-[Trigger]
-Operation = Upgrade
-Type = Package
-Target = firefox
-Target = chromium
-[Action]
-Description = Backup browser profiles before upgrade
-When = PreTransaction
-Exec = /usr/local/bin/auto-backup.sh
-</code>
-===== Erweiterte Nutzung =====
-==== Backup auf externem Server ====
-Backup erstellen und auf Remote-Server kopieren:
-<code bash>
-# Lokales Backup erstellen (mit Tool)
-guideos-browser-mail-backup
-# Auf Server kopieren
-scp ~/Backups/Firefox_backup_*.tar.gz.gpg user@server:/backups/
-</code>
-==== Backup-Rotation ====
-Alte Backups automatisch löschen:
-<code bash>
-# Nur die letzten 7 Backups behalten
-cd ~/Backups
-ls -t Firefox_backup_*.tar.gz.gpg | tail -n +8 | xargs rm -f
-</code>
-==== Mehrere Profile gleichzeitig ====
-Wrapper-Skript erstellen:
-<code bash>
-#!/bin/bash
-# multi-backup.sh
-BACKUP_DIR="$HOME/Backups"
-DATE=$(date +%Y-%m-%d_%H-%M-%S)
-for profile in .mozilla .config/chromium .thunderbird; do
-  if [ -d "$HOME/$profile" ]; then
-    NAME=$(basename $profile)
-    tar -czf "$BACKUP_DIR/${NAME}_$DATE.tar.gz" -C "$HOME" "$profile"
-  fi
-done
-</code>
-===== Best Practices =====
-  * **Regelmäßige Backups**: Mindestens wöchentlich, vor großen Updates täglich
-  * **3-2-1-Regel**: 3 Kopien, 2 verschiedene Medien, 1 Off-Site
-  * **Verschlüsselung**: Immer bei externen Speicherorten
-  * **Testwiederherstellung**: Gelegentlich Backup testweise wiederherstellen
-  * **Dokumentation**: Passwörter sicher dokumentieren
-  * **Versionierung**: Mehrere Backup-Generationen aufbewahren
-  * **Größe prüfen**: Ungewöhnlich große/kleine Backups überprüfen
-===== Integration in GuideOS =====
-==== Desktop-Datei ====
-Für die Integration ins Anwendungsmenü:
-<code>
-[Desktop Entry]
-Version=1.0
-Name=Browser & Mail Backup
-Comment=Sichern und Wiederherstellen von Browser- und Mail-Profilen
-Exec=guideos-browser-mail-backup
-Icon=system-backup
-Terminal=false
-Type=Application
-Categories=GuideOS;Utility;Archiving;
-StartupNotify=true
-</code>
-==== Tastenkombination ====
-Für schnellen Zugriff:
-<code bash>
-# In ~/.config/cinnamon/keybindings.json
-{
-  "command": "guideos-browser-mail-backup",
-  "binding": "<Super>b"
-}
-</code>
-===== Vergleich mit Alternativen =====
-^ Methode ^ Vorteile ^ Nachteile ^
-| **Dieses Tool** | Einfach, GUI, Verschlüsselung | Kein automatischer Modus |
-| Firefox Sync | Automatisch, Cloud | Nur Firefox, Datenschutz |
-| Profile direkt kopieren | Schnell, keine Tools | Fehleranfällig, keine Kompression |
-| Timeshift/Snapper | Systemweit, automatisch | Große Dateien, komplexer |
-| Duplicati/Borg | Professionell, inkrementell | Komplexe Konfiguration |
 ===== Lizenz =====
-Das Browser & Mail Backup-Tool ist unter der **MIT-Lizenz** veröffentlicht.
+| **Autor** | evilware666 |
+| **Lizenz** | MIT |