Flux
Connect your Omarchy desktop to an Android phone, an iPhone, or a Mac over your local network, or through Tailscale when you are away.
Share files, clipboard text, and clipboard images, read phone notifications, control media, and use your phone as a camera or microphone.
Flux includes a CLI, a background daemon, a native Qt window, an Omarchy shell plugin, a native Android app, a native iOS app, and a native macOS app.
fluxd listens on 1 TCP port from 12100 to 12108 and on UDP port 12100, and it also opens the connections to the devices itself.
So Flux works with the default Omarchy firewall, which blocks inbound traffic, and needs no new inbound rule.
See security for what a paired device can do and which settings limit it.
https://github.com/user-attachments/assets/4b8445fe-6734-4100-b200-92f57e1b353a
Website · Install locally · Set up Android · Set up iOS · Set up macOS · Read the docs · Use with agents
What you can do
| Task | Guide |
|---|
| Send files, clipboard text and images, and links between devices | Everyday use |
| Queue files offline, send folder archives, and save clipboard snippets | Workflow controls |
| Set device access, notification rules, and local automation for device, call, notification, and agent events | Workflow controls |
| Read notifications, send SMS, control media, and run desktop commands from your phone | CLI reference |
| Sync Do Not Disturb and pause media during calls | Phone integration |
| Scan text, send photos, and use the phone as a webcam, a microphone, or a speaker of the computer | Camera and streams |
| Show the phone screen in a desktop window | Screen mirror |
| Use the phone or the Mac as a touchpad and keyboard | Touchpad and keyboard |
| Show and control the computer screen on the phone or the Mac | Remote desktop |
| Use an Android phone or tablet as a second monitor | Extend the screen |
| Approve sudo with the phone's fingerprint sensor | Fingerprint approval |
| Log in with SSH and sign Git commits with a key on the Android phone | SSH key on the phone |
Flux for Android requires Android 10 or later.
Flux for Android is the supported phone app.
Flux for iOS requires iOS 17 or later.
It connects an iPhone in the place of the Android phone and offers the features that iOS allows.
Install it with Xcode. See Flux for iOS for the feature list and the limits of iOS.
Flux for macOS requires macOS 14 or later.
It connects a Mac in the place of a phone and offers the features that macOS allows.
See Flux for macOS for the feature list.
Flux for Windows requires Windows 10 version 2004 or later.
It connects a Windows computer in the place of a phone, as the Mac app does. It is new and has a part of the Mac features.
See Flux for Windows for the feature list.
Clone and install
On Omarchy or Arch Linux, install the build tools:
sudo pacman -Syu --needed base-devel git go cmake ninja
Clone this repository and setup:
git clone https://github.com/bjarneo/flux.git
cd flux/dist/arch
makepkg -si
flux-cli setup
flux-cli doctor
flux-cli open
The package includes the Qt app, CLI, daemon, shell plugin, approval helper, desktop entry, icons, and system files.
Run flux-cli setup as your desktop user after installation.
The short name flux also works when no other program, such as fluxcd, uses that name.
The install guide covers dependencies, source builds, user-only installation, updates, and removal.
Flux checks for a new release once a day. To install it, run flux-cli update.
Connect your phone
- Install Flux for Android.
- Connect the phone and desktop to the same local network.
- Open the desktop window with
flux-cli open.
- Select + Pair new device.
- Compare the 16-character verification key on both screens, for example
5EE6 825F 974E D59A.
- Accept the matching request on the phone.
- Select Confirm in the Flux window or in the notification on the desktop. The desktop pins the phone only after this step.
Each step waits at most 30 seconds.
Compare all 16 characters.
Earlier Flux apps show only 8 characters, so update Flux on each phone, iPhone, and Mac before you pair.
You can also start the pair request from a terminal:
flux-cli pair "Pixel 8"
After the phone accepts, flux-cli pair asks whether the phone shows the same key.
Type y to confirm.
To connect an iPhone, install the app with Xcode and follow Pair an iPhone.
To connect a Mac, build the app and follow Pair a Mac.
To connect a Windows computer, build the app and follow Pair a Windows computer.
This is the beginning of the README. Read the rest at the original. Read the full README ↗
