Install desktop Agent
The Agent runs on the machine you want to control. It captures one window, shows a tray QR, and accepts input from the phone.
One-line install
Linux (Ubuntu / X11) & macOS
curl -fsSL https://remux.eds-on.life/install.sh | bash
Installs to ~/.local/share/remux, links ~/.local/bin/remux-agent,
and on Linux adds a Remux Agent entry to the app menu (GNOME/KDE via .desktop).
macOS: prefer DMG → /Applications; enable Screen Recording and Accessibility.
Windows (PowerShell)
irm https://remux.eds-on.life/install.ps1 | iex
Or download a classic installer when published:
- Remux-Agent-Setup.exe (when available)
- Remux-Agent.msi (when available)
- Portable zip:
Remux-Agent-windows-x64.zipunder Downloads
Windows builds appear in Start Menu as Remux Agent after install.
What you get after install
- Tray icon while the agent is running (QR + token, Official Remux_NAT checkbox).
- App launcher icon: Linux app drawer / Windows Start Menu / macOS Applications.
- Not a background service by default — start from the menu or launcher when you need remote control.
Manual (Linux binary)
curl -fL -o remux-agent https://remux.eds-on.life/downloads/Remux-Agent-linux-x11
chmod +x remux-agent
# or use the repo helper:
# ./scripts/install-ubuntu-agent.sh ./Remux-Agent-linux-x11-vX.Y.Z
Permissions
- macOS: System Settings → Privacy → Screen Recording + Accessibility → Remux Agent.
- Linux X11: normal desktop session; Wayland is not the primary capture path yet.
- Windows: allow private-network firewall if using direct LAN connect.