Build from source
Run Removent locally with Rust, Xcode, and the native development scripts.
Prerequisites
Use an Apple silicon Mac with macOS 13 or later, a stable Rust toolchain (1.89+), and full Xcode 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/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 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 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 website/content/.