|
|
@@ -9,6 +9,18 @@ A high-integrity backup and restore utility for GNOME environments. Unlike stand
|
|
|
* **Debug Logging:** Optional real-time logging to `~/GnomeSettingsVault.log`.
|
|
|
* **GPLv3 Licensed:** 100% Free and Open Source.
|
|
|
|
|
|
+## The "Why" this application exists
|
|
|
+
|
|
|
+Most GNOME backup solutions fail because they attempt to "hot-swap" configuration files while the GNOME Shell is actively reading them. This leads to broken icons, default "X" cursors, and frequent Shell segmentation faults (crashes).
|
|
|
+
|
|
|
+This application follows three strict architectural principles to ensure your desktop hopefully survives the restore:
|
|
|
+
|
|
|
+1. **The Extension Kill-Switch:** Before a single byte is moved, the app programmatically disables all user extensions. This prevents the Shell from executing scripts that are mid-replacement.
|
|
|
+2. **Shadow Extraction (Atomic Swaps):** We never extract directly into live directories like `~/.themes` or `~/.local/share/gnome-shell/extensions`. Components are extracted to hidden "shadow" folders first.
|
|
|
+3. **The Janitorial Sweep:** Once extraction is verified and synced to disk, the app performs an atomic directory rename. This reduces the "danger window" for the OS file monitor from minutes to milliseconds.
|
|
|
+
|
|
|
+Re-installing a Gnome-based workstation is a major pain. I know that - I've done it countless times. This application tries to resolve this issue. This tool is designed for those who want to migrate their perfectly tuned environment between machines—or versions—without the desktop environment throwing a tantrum.
|
|
|
+
|
|
|
## Prerequisites
|
|
|
* `gtkmm-3.0`
|
|
|
* `libarchive`
|
Nicole Portas