Build from source
Run Removent locally with Rust, Xcode, and the native development scripts.
On this page
Prerequisites
Use an Apple silicon Mac with macOS 26 or later, a stable Rust toolchain (1.89+), and full Xcode 26 or newer with Swift and the Metal toolchain.
Clone and run
Shellgit clone https://github.com/backrunner/removent.gitcd removentscripts/dev.sh
This builds incrementally and starts the desktop app, daemon, and menu bar app. The first build compiles dependencies; later builds reuse them.
Development options
Shellscripts/dev.sh --no-buildscripts/dev.sh --no-trayscripts/dev.sh --build-onlyscripts/dev.sh --help
Development uses userdata/dev unless REMOVENT_DATA_DIR is set. The script skips scheduled update checks and stops its own processes on Control+C. Keep this data separate from your installed application.
Package locally
Shellscripts/build/package.sh
The script produces an app bundle and zip under dist/, ad-hoc signed for local development. Public releases require the signing and notarization workflow described in the repository's release guide.
Validate changes
Shellcargo test --workspacebash apps/tray/Tests/run_integration_test.sh
Automated checks do not replace testing screen capture, macOS permissions, or real connections on target hardware.
Work on this website
From apps/website/, use Node 24+ and pnpm:
Shellpnpm installpnpm devpnpm checkpnpm check:docspnpm build
The website uses svedocs and SvelteKit with static output. Its bilingual public content lives under apps/website/content/.