bjarneo / flux

# 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 | 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 or microphone | 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 |
| Approve sudo with the phone's fingerprint sensor | Fingerprint approval |
| Reach your phone away from home through Tailscale | Connect through Tailscale |
| See herdr coding agents on the phone or the Mac, read their output, and answer them | herdr agents |
| Update Flux on the computer and send the new app to the phone | Update |
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:
 [code] 
Clone this repository and setup:
 [code] 
The package includes the Qt app, CLI, daemon, shell plugin, approva