| Filename | Latest commit message | Latest commit date |
|---|---|---|
544a2cd647
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
Major release. Highlights: - Codec: vendored VaptVupt codec moves to canonical 2.60.4 security release. Fixes a high-severity OOB heap write in the AVX2 decode fast path (reachable on a valid stream sized to exactly content_size, both tail variants). Brings CBMC-formally-verified BCJ filters with automatic ELF/PE/Mach-O detection. Compressed output stays byte-identical (ratio gate Δ 0.00%); wire format unchanged at v1.6. - New --pq-box sealed-box recipient mode (vendored libpqvaptvupt 0.6.0): ML-KEM-768 + X25519 combined via HKDF-SHA256 with domain separation, AES-256-CTR + HMAC-SHA256 EtM. Legacy --pq and --pq-sdk stay readable. - F-16: discloses and fixes a pre-existing data-loss defect in the <= 3.8.0 in-tree BCJ encoder. Full back-compat matrix decodes byte-exact under 4.0.0; every readable pre-4.0 archive remains readable. Repository hygiene: - Sync full 4.0.0 source tree (codec, crypto, SDK, GUI, packaging, tests). - Remove internal scratch files (PROMPT.md, FORMAL_AUDIT_PROMPT.md) and superseded version-specific docs (INTEGRATION_PROTOCOL_2.60.4.md, docs/FINDINGS-2.x.md) and a stray test binary. - Refresh README download/install section to real 4.0.0 release assets; bump version badge to 4.0.0. - Add .gitignore for build outputs (keeps vendored prebuilt libraries). |
||
| .. | ||
| assets | ||
| packaging | ||
| src | ||
| install.sh | ||
| LICENSE-GUI | ||
| README.md | ||
| requirements.txt | ||
| setup.py | ||
| zupt-gui | ||
Zupt GUI — Cross-Platform Post-Quantum Backup
Desktop application for zupt backup compression with ML-KEM-768 + X25519 post-quantum hybrid encryption.
Works on GNU/Linux, BSD, macOS, and Windows.
Install
Linux (recommended)
tar xzf zupt-gui.tar.gz && cd zupt-gui
./zupt-gui # auto-creates venv, installs PySide6
./install.sh --user # adds right-click menu integration
After install, right-click any file in Nemo/Nautilus to see "Compress with Zupt". Double-click any .zupt file to open it in the GUI.
Windows
Option A — Installer (recommended):
Download ZuptGUI-2.1.6-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 zupt.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 zupt-gui-1.0.0-x86_64.AppImage
./zupt-gui-1.0.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 Zupt
- Right-click .zupt file: Extract with Zupt
- Double-click .zupt: opens in Zupt GUI
Windows (after installer)
- Right-click any file: Compress with Zupt
- Right-click any folder: Compress with Zupt
- Double-click .zupt: opens in Zupt GUI
- Right-click .zupt: Verify Integrity
Architecture
Zupt GUI (PySide6, Python)
|
|-- subprocess.Popen() with streaming stderr
|
v
zupt CLI (Pure C11 binary)
ML-KEM-768 + X25519 + AES-256-CTR
VaptVupt / LZHP / Store codecs
Block deduplication, full-disk backup
The GUI calls the zupt 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/zupt-gui.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
- zupt v2.2.3 — Cristian Cezar Moisés (github)
License
AGPL-3.0-or-later