Skip to content

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

Shell
git 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

Shell
scripts/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

Shell
scripts/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

Shell
cargo 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:

Shell
pnpm installpnpm devpnpm checkpnpm check:docspnpm build

The website uses svedocs and SvelteKit with static output. Its bilingual public content lives under apps/website/content/.