A beautiful desktop GUI client for Magic Wormhole built with Qt6 and C++.
🤖 AI-Assisted Development Note
This project was developed with significant assistance from AI tools (Claude by Anthropic and DeepSeek) to accelerate development and learn Qt6/C++ programming patterns. The development process was a collaboration between human direction and AI implementation.
| Feature | Description |
|---|---|
| 🚀 Send Files & Folders | Drag and drop onto the window or use the file picker dialog |
| 📥 Receive Files | Enter wormhole codes to receive files securely |
| 🎨 Modern Dark UI | Clean dark theme with smooth animations and transitions |
| ⚙️ Configurable Settings | Custom relay server URL, adjustable code length, default download path |
| 📋 One-Click Copy | Copy generated wormhole codes to clipboard instantly |
| 📊 Live Progress | Real-time transfer progress bars and status updates |
| 🔔 Desktop Notifications | System tray notifications for completed transfers |
| 📜 Transfer History | Keep track of recent transfers (optional) |
| Send View | Receive View | Settings |
|---|---|---|
 |
 |
 |
Wormhole Qt acts as a native GUI frontend for the official Magic Wormhole command-line tool. The application:
- Spawns the
wormholeCLI as a subprocess - Parses stdout/stderr in real-time to extract codes, progress, and status
- Displays a clean, user-friendly interface for the underlying protocol
All file transfers remain end-to-end encrypted using the same PAKE (Password-Authenticated Key Exchange) security as the original Magic Wormhole.
This project draws significant inspiration from iyox-Wormhole , a sleek and modern Magic Wormhole GUI client.
What inspired this project:
- Clean, intuitive UI layout - The tabbed interface with clear visual hierarchy
- Dark theme aesthetic - Modern, eye-friendly dark mode design
- Progress visualization - Clear transfer status and code display
- Settings organization - Logical grouping of configuration options
While iyox-Wormhole provided the initial design inspiration, Wormhole Qt is a complete Qt6/C++ rewrite that adds:
- Native Linux desktop integration
- CMake build system for easier compilation
- Simplified codebase for maintainability
- GPL v3 licensing for open-source compliance
Special thanks to the iyox-studios team for creating an excellent reference implementation! 🙏
- Qt6 development libraries (Core, Widgets, Network, Concurrent)
- CMake (≥ 3.16)
- C++ compiler with C++17 support
- Magic Wormhole CLI (Python package)
# Recommended: Install via pipx (isolated environment)
pipx install magic-wormhole
# Alternative: Install via pip
pip install magic-wormhole
# Verify installation
wormhole --version