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.
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 |
|---|---|
| Design system | Android app visual language, theming, components, and navigation |
| 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.