Remote desktop for your Macs, with iPhone and iPad controllers.
Connect on your LAN or through a relay you run yourself. No hosted account required.
Website | Download | CLI guide | 简体中文
The macOS app, shown in Simplified Chinese. English is also available.
| Control a Mac | Native RVP sessions with keyboard, mouse, clipboard and audio, using QUIC and hardware HEVC/H.264 video. |
| Use your phone or tablet | The SwiftUI controller shares the desktop's Rust connection engine. Requires iOS/iPadOS 26+. |
| Reach existing servers | Connect to VNC, Apple Remote Desktop and RDP servers from the same app. |
| Keep a host available | A separate background service and menu bar app support hosting after the main window closes. |
| Connect across networks | Run a private Rust relay on a VPS, or deploy it to Cloudflare Containers. |
| Manage from a terminal | Query status, change settings, manage pairing and configure launch at login through the bundled CLI. |
Bonjour discovery can be enabled separately for Removent, VNC and RDP. It uses service advertisements without scanning subnets or ports. Add unadvertised hosts manually by address.
Windows and Linux: From 0.2.0, x86_64 portable archives and SHA-256 files are available in GitHub Releases. See requirements and setup. Windows builds are unsigned; Linux hosting requires X11 and glibc 2.39+. Updates are manual.
Mac app: macOS 26 or later on Apple Silicon.
Download the DMG from GitHub Releases. Open it and choose Removent → Install and Open, or drag the app into Applications.
You can also install from a terminal:
curl -fsSL https://raw.githubusercontent.com/backrunner/removent/main/scripts/install.sh | bashThe installer checks the release checksum, component signatures and Gatekeeper assessment before replacement, and retains the previous app for rollback. Finish remote sessions and quit the desktop and menu bar app before upgrading.
Install over SSH
Replace user@mac with your Mac's SSH destination:
ssh user@mac 'curl -fsSL https://raw.githubusercontent.com/backrunner/removent/main/scripts/install.sh | bash -s -- --app-dir "$HOME/Applications" --login'Installation starts the service and enables launch at user login by default, preserving
later explicit choices. --login explicitly enables it; --start starts without changing
login preferences. --no-login installs without starting and disables login startup. Hosting needs
a logged-in graphical session, and initial privacy grants require System Settings
on that Mac. See the SSH installation guide.
- Prepare the Mac you want to control. Open Removent and grant Screen Recording and Accessibility permissions, then enable sharing.
- Choose it on your other device. Select it from nearby devices, or choose Add connection and enter its address.
- Authenticate. Enter the credentials requested by the host: a system account, pairing code, access password or authenticator code, according to its Security settings.
A host can also generate a single-use, 12-digit connection code. Enter it in the controller's address field on the same LAN, or use it through the same private relay. Codes expire after five minutes.
For a host that stays available after closing the app, see background service setup.
The CLI ships inside the Mac app. Set a shell variable once:
REMOVENT_CLI="/Applications/Removent.app/Contents/MacOS/removent-cli"# Inline keyboard menu
"$REMOVENT_CLI"
# Service and pairing
"$REMOVENT_CLI" daemon status
"$REMOVENT_CLI" daemon start
"$REMOVENT_CLI" pairing generate # Requires pairing-code authentication and sharing enabled
# Discover, inspect and change settings
"$REMOVENT_CLI" settings list
"$REMOVENT_CLI" settings get discovery.vnc
"$REMOVENT_CLI" settings set device_name "Office Mac"
"$REMOVENT_CLI" settings set discovery.vnc true
"$REMOVENT_CLI" settings set video_quality high-quality
"$REMOVENT_CLI" settings reset video_quality
# Script-friendly output and diagnostics
"$REMOVENT_CLI" settings get --json
"$REMOVENT_CLI" daemon status --verboseTerminal commands display readable results; pipes preserve existing output formats.
Use --json for machine output or --human for readable redirected output.
Run without arguments to manage services, pairing and settings with the keyboard.
Settings commands cover appearance, discovery, hosting, authentication, VNC, media preferences and updates. They validate values before saving and report when changes take effect. Online hosts reload sharing settings; desktop preferences apply when you reopen the desktop app. Changing host settings may interrupt active remote sessions.
Passwords and OTP secrets are always hidden in query results. Write them through
--stdin, rather than including them in command arguments. See the
complete CLI guide for every setting, authentication setup,
JSON output and exit codes.
| Protocol | Use it for | Host requirements |
|---|---|---|
| Removent / RVP | Mac-to-Mac or mobile-to-Mac sessions, native media and private relay routing | Removent sharing enabled on the Mac |
| VNC / Apple Remote Desktop | Existing VNC servers or macOS Screen Sharing | A supported RFB authentication method |
| RDP | Windows and other RDP desktops | Remote Desktop enabled, with an allowed account |
The Mac can optionally provide a VNC listener; it is off by default. RDP support is controller-only. Compatibility protocols have different media and redirection capabilities. Read the connection reference for authentication methods, codec options and limitations.
Prebuilt relay binaries are available for Linux x86_64/ARM64 and macOS 13+ (Apple Silicon and Intel):
curl -fsSL https://raw.githubusercontent.com/backrunner/removent/main/scripts/install_relay.sh | shThe installer verifies the binary and opens a setup wizard. Linux uses systemd;
macOS uses a user LaunchAgent. Manage the service with removent-relay start,
stop, restart, status and logs.
Relay installation · Private relay configuration · Cloudflare deployment
Native connections use mutual TLS, pinned device identities and SPAKE2 pairing. Host Security settings select a system account, pairing codes, an access password, authenticator OTP or no authentication. With no authentication, anyone who can reach the host can connect. Credentials and pairing permissions stay on their devices.
Hosting normally runs in a logged-in macOS graphical session. FileVault preboot and the initial login window have separate requirements; see the macOS unlock investigation.
Saved-connection iCloud sync is optional and requires a provisioned build and CloudKit setup. See its architecture and validation status.
Use the current stable Rust toolchain and full Xcode with Swift and Metal tools.
git clone https://github.com/backrunner/removent.git
cd removent
scripts/dev.sh # Build and run the app, daemon and tray
scripts/dev.sh --no-build # Reuse debug binaries
scripts/build/package.sh # Package a local .app and zip in dist/Development uses userdata/dev; override it with REMOVENT_DATA_DIR. The dev
script stops its own processes on Ctrl+C. Local packaging uses ad-hoc signing
unless a signing identity is configured.
make check
make test
make website-check| Directory | Contents |
|---|---|
apps/ |
Desktop, daemon, CLI, tray, mobile controller, relay and website |
packages/ |
Shared settings, identity, transport, media, input and client engine |
infra/ |
Deployment and service templates |
docs/ |
Guides, architecture and validation records |
Computer Use MCP (development) · Repository layout · Design documents · Release guide