Vortex links a Linux desktop and an Android phone over the local network. Clipboard, mouse and keyboard, files, audio, notifications, and screen share move directly between the two devices, encrypted end to end. There is no cloud account and no relay server.
Note
The documentation and codebase guides for this project were written and maintained with the assistance of AI agents.
Warning
Beta Software: Vortex is currently under active development. Features, protocol definitions, and platform integrations are actively being tested and refined.
| Document | Description |
|---|---|
| Installation guide | Nix flake, Direnv, and platform prerequisites |
| Pairing and security | BLE discovery, Noise handshake, and 3-emoji SAS check |
| Document | Description |
|---|---|
| Architecture overview | Core daemon (vortex-l3d), Tauri GUI, Android app, and inject helper |
| Wire and encryption protocols | Protobuf contracts, ChaCha20-Poly1305 framing, and BLE / Wi-Fi transports |
| Document | Description |
|---|---|
| Universal control | Wayland libei / InputCapture portal, edge crossing, and Android /dev/uinput injection |
| Screen mirroring and casting | H.264 GStreamer decoding pipeline and Wayland screencasting |
| Universal clipboard | Clipboard sync with password manager filtering |
| Smart audio handoff | MPRIS media pause, Bluetooth audio tracking, and call priority |
| Instant file sharing | Local Wi-Fi Direct drops, folder packaging, and file manager integration |
| Document | Description |
|---|---|
| Environment and tooling | Nix shell, Lefthook pre-commit checks, and formatting standards |
| Security and compliance | Local-first threat model, Noise XX crypto, and sandbox privileges |
| Troubleshooting guide | Diagnostics, BlueZ/BLE reconnection, ADB permissions, and Wayland display fixes |
This project is licensed under the GNU General Public License v3.0.