x3-backup/README.md

x3-Backup

GTK3 Backup/Snapshot-Tool mit rsync Backend.

Erstellt platzsparende Snapshots via Hardlink-Delta, durchstoebern und wiederherstellen von Einzeldateien oder ganzen Systemen.

Features

• rsync Snapshots — Hardlink-Delta fuer platzsparende inkrementelle Backups
• Snapshot Sidebar — Alle Snapshots chronologisch sortiert
• File Browser — Dateien/Ordner durchsuchen mit Berechtigungen (rwx)
• Restore — Einzeldateien oder ganze Verzeichnisse wiederherstellen
• System Tray — Icon im Panel mit Status und Kontextmenue
• Live Log — Echtzeit-Ausgabe waehrend Backup/Restore
• History Log — Komplettes Log durchsuchbar
• Cronjob — Geplante Backups direkt aus dem Programm
• System Backup — Komplettes Root-Filesystem sichern
• System Restore — Aus Live-ISO wiederherstellen
• CLI Modus — --backup, --system-backup fuer Cron/Automation

Installation

autoreconf -fi
./configure
make -j$(nproc)
sudo make install

Oder lokal bauen und starten:

autoreconf -fi && ./configure && make -j$(nproc)
./src/x3-backup

Deinstallation

sudo ./uninstall.sh

Layout

+------------------------------------------------------------------+
| x3-Backup                                          [─] [□] [×]  |
+------------------------------------------------------------------+
| File | Backup | System | Help                                    |
+------------------------------------------------------------------+
| [New Backup] [Restore] [Delete] | [Settings]     [========] 0%  |
+------------------------------------------------------------------+
|            |                                                      |
| Snapshots  |  [↑] [/home/user/documents]                          |
|            |  Select a snapshot to browse                         |
| ┌────────┐ |  ┌──────────────────────────────────────────────────┐|
| │2026-09 │ |  │ Name            │ Size   │ Permissions │ Modified │|
| │07 16:30│ |  ├─────────────────┼────────┼─────────────┼──────────┤|
| │         │ |  │ Documents       │ -      │ drwxr-xr-x  │          │|
| ├────────┤ |  │ Pictures        │ -      │ drwxr-xr-x  │          │|
| │2026-09 │ |  │ .bashrc         │ 3.4 KB │ -rw-r--r--  │          │|
| │06 02:00│ |  │ .ssh            │ -      │ drwx------  │          │|
| │         │ |  │ notes.txt       │ 12 KB  │ -rw-r--r--  │          │|
| ├────────┤ |  │ config.json     │ 1.2 KB │ -rw-r--r--  │          │|
| │2026-09 │ |  └──────────────────────────────────────────────────┘|
| │05 02:00│ |                                                      |
| └────────┘ |  ┌──────────────────────────────────────────────────┐|
|            |  │ Live Log:                                         │|
|            |  │ [cmd] rsync -aAX --info=progress2 --delete ...    │|
|            |  │ [info] Syncing: /home/user/Documents/project/     │|
|            |  │ [done] Snapshot created: 2026-09-07_16-30-00      │|
|            |  │                                                   │|
|            |  │ [Clear]                                           │|
|            |  └──────────────────────────────────────────────────┘|
+------------------------------------------------------------------+
| x3-Backup - Idle                                    Status Message|
+------------------------------------------------------------------+

Dateisystem-Struktur

Konfiguration

~/.config/x3-backup/
├── settings.json          # Einstellungen
├── x3-backup.log          # Log-Datei

Backup-Destination

/mnt/backups/                    # oder konfigurierter Pfad
├── snapshots/
│   ├── 2026-09-07_16-30-00/     # Snapshot 1 (Hardlinks)
│   │   ├── home/
│   │   │   └── user/
│   │   │       ├── documents/
│   │   │       ├── .bashrc
│   │   │       └── ...
│   │   ├── etc/
│   │   └── ...
│   ├── 2026-09-06_02-00-00/     # Snapshot 2 (nur Aenderungen)
│   │   └── ...
│   └── 2026-09-05_02-00-00/     # Snapshot 3 (aehnlich)
│       └── ...
└── metadata/
    ├── 2026-09-07_16-30-00.json # Metadaten
    ├── 2026-09-06_02-00-00.json
    └── 2026-09-05_02-00-00.json

Hardlink-Prinzip

Snapshot 1 (voll):         Snapshot 2 (delta):
  fileA (100KB) ──inode1     fileA (100KB) ──inode1  (identisch, Hardlink)
  fileB (50KB)  ──inode2     fileB (75KB)  ──inode3  (geaendert, neue Datei)
  fileC (200KB) ──inode3     fileC (200KB) ──inode3  (identisch, Hardlink)
                              fileD (30KB)  ──inode4  (neu)

Platzbedarf: voll + delta (statt 2x voll)

Config (settings.json)

{
  "backup_dest": "/mnt/backups",
  "source_path": "/",
  "exclude_patterns": [
    "/mnt",
    "/proc",
    "/sys",
    "/dev",
    "/run",
    "/tmp",
    "/lost+found"
  ],
  "preserve_permissions": true,
  "preserve_acls": true,
  "preserve_xattrs": true,
  "delete_removed": true,
  "retention_days": 30,
  "retention_count": 10,
  "cron_enabled": false,
  "cron_schedule": "0 2 * * *",
  "cron_label": "x3-backup-auto"
}

CLI Nutzung

# Backup jetzt erstellen und beenden
x3-backup --backup

# System-Backup (von Live-ISO)
x3-backup --system-backup

# Log auf STDOUT ausgeben
x3-backup --backup --log

# Hilfe
x3-backup --help

Cronjob Beispiel

# Taeglich um 2:00 Uhr
0 2 * * * /usr/local/bin/x3-backup --backup &

# Alle 6 Stunden
0 */6 * * * /usr/local/bin/x3-backup --backup &

# Woechentlich Sonntag 3:00 Uhr
0 3 * * 0 /usr/local/bin/x3-backup --backup &

Log Format

[2026-09-07 16:30:00] [INFO] x3-backup: === x3-backup started ===
[2026-09-07 16:30:00] [INFO] x3-backup: Log file: ~/.config/x3-backup/x3-backup.log
[2026-09-07 16:30:01] [INFO] x3-backup: rsync cmd: rsync -aAX --info=progress2 ...
[2026-09-07 16:30:15] [INFO] x3-backup: [done] Snapshot created: 2026-09-07_16-30-00

Rechte und Wiederherstellung

Aktion	Benoetigte Rechte
Backup erstellen	Normaler User (nur lesend auf Quelle)
Datei wiederherstellen	sudo (fuer Root-Berechtigungen)
System wiederherstellen	sudo
Cronjob installieren	Normaler User (crontab -e)

Abhaengigkeiten

• GTK+ 3.0 (>= 3.24)
• json-glib-1.0
• rsync
• crontab (optional)

Architektur

┌─────────────┐    ┌──────────────┐    ┌──────────────┐
│  MainWindow  │───▶│SnapshotManager│───▶│ RsyncManager │
│  (GTK UI)    │    │  (Snapshots)  │    │  (rsync)     │
└──────┬──────┘    └──────────────┘    └──────────────┘
       │
       ├── SystemTray (Tray-Icon)
       ├── SettingsDialog (Einstellungen)
       └── Config (JSON)