folder-archiver

$ man folder-archiver

Usage

Start with a config file, run a dry-run, then create archives locally or upload after the local archive succeeds.

first setup
cp config.example.env config.env
chmod +x archive-folder.sh
./archive-folder.sh ~/Projects/my-project --dry-run
desktop gui
./launch-gui.sh
# or
python3 archive-folder-gui.py

Core commands

  1. Archive the configured default folder with ./archive-folder.sh.
  2. Archive a specific folder with ./archive-folder.sh ~/Documents/ClientWork.
  3. Preview a run with --dry-run before writing files.
  4. Archive child folders separately with --each-folder.
  5. Add one-off exclusions with repeated --exclude arguments.
  6. Upload after local archive success with --upload.

Output shape

Archives are grouped by date, then by timestamp and source folder slug. A run contains the tarball, README_ARCHIVE.md, manifest.sha256, and archive.log.

Restore check

Run sha256sum -c manifest.sha256 before extracting, then restore with tar -xzf archive.tar.gz -C ~/Restores.