| Filename | Latest commit message | Latest commit date |
|---|---|---|
c42513e0db
The CLI paints progress as carriage-return frames ("\r path [###] 42%", no
newline until 100%). Worker.run read the child line-by-line, so it emitted
NOTHING for the whole job and the GUI looked frozen on any file bigger than one
block — reported as 'I can't compress, the app stucks'. The worker now reads
with read1() and splits on both \n and \r, parsing the percentage out of the
progress frames and driving the QProgressBar (indeterminate until the first %).
Also run the child with stdin=/dev/null (a prompt on inherited stdin would block
forever) and merge stderr into stdout so a filling second pipe can't deadlock.
|
||
| .. | ||
| assets | ||
| packaging | ||
| src | ||
| install.sh | ||
| LICENSE-GUI | ||
| README.md | ||
| requirements.txt | ||
| setup.py | ||
| zupt-gui | ||
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
Linux (recommended)
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.0.0 — Cristian Cezar Moisés (github)
License
AGPL-3.0-or-later