README.md 1.1 KB

GnomeSettingsVault

A high-integrity backup and restore utility for GNOME environments. Unlike standard backup tools, GnomeSettingsVault uses Atomic Swap logic and Live-Extension Disabling to ensure that themes, icons, and shell extensions are restored without crashing the GNOME Shell.

Features

  • Atomic Restore: Extracts to shadow directories before swapping to minimize filesystem locks.
  • Safe Extension Handling: Automatically toggles extensions off during restore to prevent Shell segmentation faults.
  • Dconf Integration: Full backup of GNOME's configuration database.
  • Debug Logging: Optional real-time logging to ~/GnomeSettingsVault.log.
  • GPLv3 Licensed: 100% Free and Open Source.

Prerequisites

  • gtkmm-3.0
  • libarchive
  • dconf-cli

Usage

  1. Compile using the provided Makefile.
  2. Run ./gnome-vault.
  3. After a restore, a Logout is highly recommended to flush the GNOME cache and apply all UI changes correctly.

Contributing

As GNOME moves toward versions 49 and 50, please report any path changes or extension API breakages via Issues.