zupt/gui
Repository files (latest commit first)
Filename Latest commit message Latest commit date
Cristian Cezar Moisés 7c062bc92c
Some checks failed
CI / build-and-test (clang) (push) Has been cancelled
CI / build-and-test (gcc) (push) Has been cancelled
CI / strict-warnings (clang, -Wall -Wextra -Wpedantic -Wshadow -Wcast-align -Wstrict-prototypes -Wmissing-prototypes -Wnull-dereference -O2 -std=c11 -Werror) (push) Has been cancelled
CI / strict-warnings (gcc, -Wall -Wextra -Wpedantic -Wshadow -Wcast-align -Wstrict-prototypes -Wmissing-prototypes -Wnull-dereference -Wformat-security -Wlogical-op -Wjump-misses-init -Wdouble-promotion -O2 -std=c11 -Werror) (push) Has been cancelled
CI / sanitizers (push) Has been cancelled
CI / pie-hardening (push) Has been cancelled
CI / cross-aarch64 (push) Has been cancelled
CI / dist-reproducibility (push) Has been cancelled
CI / packaging-syntax (push) Has been cancelled
CI / release (push) Has been cancelled
cross-platform / windows (push) Has been cancelled
cross-platform / macos (push) Has been cancelled
cross-platform / portable (push) Has been cancelled
v5.1.0: docs, comparison tables, packaging version bump
README 'What's new in 5.1.0' + a new 'Compression comparison' section with
measured ratio/throughput tables vs zstd/gzip/lz4 and a 5.0.0->5.1.0 delta
table; fix the stale codec-internals section (2.60.4 -> 2.65.0, and the
now-wrong 'wrapper forces format_v2' paragraph). CHANGELOG 5.1.0 entry.
Bump Version: in the rpm/opensuse specs (+changelog), the homebrew formula
url/version, the guix package version, and the gui README to 5.1.0.
2026-07-11 22:53:44 -03:00
..
assets Release: v2.1.6 - Added VaptVupt 2.40 2026-04-22 03:46:59 -03:00
packaging v2.2.2 2026-05-01 09:58:47 -03:00
src gui: parse CLI progress frames so compress no longer looks stuck 2026-07-11 22:53:44 -03:00
install.sh v2.2.2 2026-05-01 09:58:47 -03:00
LICENSE-GUI v4.0.0: codec 2.60.4 security release, --pq-box sealed-box mode, F-16 fix 2026-06-10 18:48:58 -03:00
README.md v5.1.0: docs, comparison tables, packaging version bump 2026-07-11 22:53:44 -03:00
requirements.txt Release: v2.1.6 - Added VaptVupt 2.40 2026-04-22 03:46:59 -03:00
setup.py v2.2.2 2026-05-01 09:58:47 -03:00
zupt-gui v2.2.2 2026-05-01 09:58:47 -03:00

VaptVupt GUI

Desktop application for vaptvupt backup compression with ML-KEM-768 + X25519 post-quantum hybrid encryption.

Works on GNU/Linux, BSD, macOS, and Windows.

Install

tar xzf vaptvupt-gui.tar.gz && cd vaptvupt-gui
./vaptvupt-gui                      # auto-creates venv, installs PySide6
./install.sh --user              # adds right-click menu integration

Windows

Option A — Installer (recommended):

Download VaptVuptGUI-1.3.0-Setup.exe and run it. Installs to Program Files, adds Start Menu shortcut, desktop shortcut, right-click context menus, and .zupt file association. Includes uninstaller.

Option B — Build from source:

cd packaging\windows
build-windows.bat

Requires Python 3.9+, NSIS 3.x, and a compiled vaptvupt.exe.

Option C — Run directly:

pip install PySide6
python src\zupt_gui.py

macOS / BSD

pip3 install PySide6
python3 src/zupt_gui.py

AppImage (universal Linux)

chmod +x VaptVupt-GUI-1.3.0-x86_64.AppImage
./VaptVupt-GUI-1.3.0-x86_64.AppImage

Flatpak

flatpak-builder --install build packaging/flatpak/dev.zupt.gui.yml
flatpak run dev.zupt.gui

Features

Tab Function
Keys Generate ML-KEM-768 + X25519 hybrid keypairs
Compress All codecs, levels 1-9, dedup, solid, password, PQ keys
Extract Decrypt and extract .zupt archives
Verify Check block checksums, view archive metadata
Disk Full-disk backup and restore
About Version, cryptographic stack, credits

All tabs support drag-and-drop. Drop a .zupt file anywhere on the window to extract it. Drop any other file to compress it.

System Integration

Linux (Nemo / Cinnamon)

After ./install.sh --user:

  • Right-click any file: Compress with VaptVupt
  • Right-click .zupt file: Extract with VaptVupt
  • Double-click .zupt: opens in VaptVupt GUI

Windows (after installer)

  • Right-click any file: Compress with VaptVupt
  • Right-click any folder: Compress with VaptVupt
  • Double-click .zupt: opens in VaptVupt GUI
  • Right-click .zupt: Verify Integrity

Architecture

VaptVupt GUI (PySide6, Python)
    |
    |-- subprocess.Popen() with streaming stderr
    |
    v
vaptvupt CLI (Pure C11 binary)
    ML-KEM-768 + X25519 + AES-256-CTR
    VaptVupt / LZHP / Store codecs
    Block deduplication, full-disk backup

The GUI calls the vaptvupt CLI binary — all cryptography runs in native C, not Python.

Packaging

Platform Format Tool
Any pip pip install .
Debian/Ubuntu/Mint .deb packaging/deb/control
Fedora/RHEL .rpm rpmbuild -ba packaging/rpm/vaptvupt.spec
Universal Linux .AppImage packaging/appimage/build-appimage.sh
Sandboxed Linux .flatpak packaging/flatpak/dev.zupt.gui.yml
Windows .exe installer packaging/windows/build-windows.bat
Windows NSIS .exe packaging/windows/zupt-installer.nsi

Credits

  • vaptvupt v5.1.0 — Cristian Cezar Moisés (github)

License

AGPL-3.0-or-later