https://github.com/trex099/velocity-bridge
Copy on iPhone. Paste on Linux and vice versa copy on linux paste on iphone No cloud, no macOS required.
https://github.com/trex099/velocity-bridge
arch clipboard clipboard-manager fastapi fedora gnome ios iphone linux python wayland
Last synced: 3 months ago
JSON representation
Copy on iPhone. Paste on Linux and vice versa copy on linux paste on iphone No cloud, no macOS required.
- Host: GitHub
- URL: https://github.com/trex099/velocity-bridge
- Owner: Trex099
- License: gpl-3.0
- Created: 2025-12-07T15:53:08.000Z (6 months ago)
- Default Branch: main
- Last Pushed: 2026-01-10T12:28:22.000Z (5 months ago)
- Last Synced: 2026-01-11T03:48:31.063Z (5 months ago)
- Topics: arch, clipboard, clipboard-manager, fastapi, fedora, gnome, ios, iphone, linux, python, wayland
- Language: Python
- Homepage: https://trex099.github.io/Velocity-Bridge/
- Size: 210 MB
- Stars: 53
- Watchers: 0
- Forks: 1
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- Contributing: CONTRIBUTING.md
- License: LICENSE
Awesome Lists containing this project
README
# Velocity Bridge
[](https://github.com/Trex099/Velocity-Bridge/releases/latest)
[](LICENSE)
[](https://aur.archlinux.org/packages/velocity-bridge)
[](https://copr.fedorainfracloud.org/coprs/trex099/velocity-bridge/)
Velocity Bridge provides seamless **Universal Clipboard** integration between iOS and Linux. This utility enables bidirectional synchronization of text and image data over a local network, serving as a privacy-focused, open-source alternative to AirDrop.
## Core Functionality
- **Bidirectional Synchronization**: Transfer text and image data from iOS to Linux and from Linux to iOS.
- **Image Support**: Images copied to the Linux clipboard are automatically transmitted to iOS, and vice versa.
- **Data Privacy**: All transmissions occur within the local network; no data is ever uploaded to external servers.
- **Native performance**: Developed with Tauri to ensure a minimal resource footprint and native OS integration.
## Key Features
- **System Tray Integration**: Background execution with persistent connectivity.
- **In-App Updater**: Automated update detection and one-click installation with cryptographic verification.
- **Advanced Autostart**: Integrated startup management via the official autostart plugin.
- **Clipboard History**: Searchable history of recent clipboard entries with clear-all functionality.
## Screenshots
## Installation
### Automated Installation
Run the following command in your terminal:
```bash
curl -fsSL https://raw.githubusercontent.com/Trex099/Velocity-Bridge/main/install.sh | bash
```
### Manual Installation by Distribution
**Fedora / RHEL**:
```bash
sudo dnf copr enable trex099/velocity-bridge
sudo dnf install velocity-bridge libappindicator-gtk3
```
**Arch Linux**:
```bash
yay -S velocity-bridge
```
**NixOS**:
```bash
# Execute directly
nix run github:Trex099/Velocity-Bridge
# Install to profile
nix profile install github:Trex099/Velocity-Bridge
```
### Headless Installation
For environments without a graphical user interface, a background service implementation is available. This configuration includes dependency validation and systemd service integration.
To install the headless service, execute:
```bash
curl -fsSL https://raw.githubusercontent.com/Trex099/Velocity-Bridge/main/service/install.sh | bash
```
Management of the background service is achieved via systemd:
```bash
systemctl --user status velocity
journalctl --user -u velocity -f
```
Alternative Formats
Pre-compiled binaries are available via the [releases page](https://github.com/Trex099/Velocity-Bridge/releases/latest):
- AppImage
- .deb (Debian, Ubuntu, Mint, Pop!_OS)
- .rpm (Fedora, openSUSE)
## iOS Configuration
Velocity Bridge utilizes iOS Shortcuts to interface with the clipboard. To configure:
1. **Shortcuts Setup**: Install the required shortcuts by scanning the QR codes in the application's **iOS Setup** tab.
2. **Connectivity**: Navigate to the **Settings** tab in the desktop application and copy the **Full Sync URL**.
3. **Authentication**: Paste the URL into the Shortcut configuration. This string contains both the local IP address and the secure authentication token.
**Optimization**: Map these shortcuts to the **Back Tap** feature (Settings > Accessibility > Touch > Back Tap) on iOS to instantly transfer your clipboard without opening any app.
## Technical Architecture
```
[ iOS Device ] <─── HTTP/REST ───> [ Linux Host (Tauri/Rust) ]
│
[ Systems Interface ]
(wl-copy / xclip / xsel)
```
## Troubleshooting
### Connectivity Failures
Ensure the host firewall permits ingress traffic on TCP port 8080:
```bash
sudo firewall-cmd --add-port=8080/tcp --permanent
sudo firewall-cmd --reload
```
### Clipboard Inconsistency
Verify that the appropriate clipboard manager for your display server is installed:
- **Wayland**: `wl-clipboard`
- **X11**: `xclip` or `xsel`
### Execution Errors
Run the application via the terminal to capture diagnostic logs:
```bash
velocity-bridge
```
## Uninstallation
### Standard Installation
```bash
rm ~/.local/bin/velocity-bridge
rm ~/.local/share/applications/velocity-bridge.desktop
rm ~/.local/share/icons/hicolor/256x256/apps/velocity-bridge.png
```
### Package Managers
- **DNF**: `sudo dnf remove velocity-bridge`
- **AUR**: `yay -R velocity-bridge`
- **APT**: `sudo apt remove velocity-bridge`
---
Licensed under the GPL-3.0 License.
Issues and feature requests should be submitted via the [official issue tracker](https://github.com/Trex099/Velocity-Bridge/issues).