Renamo
Renamo

Advanced

Developer setup

Build, run, debug, and release the macOS app locally

Renamo is a native macOS app generated with XcodeGen.

Repository

The app code lives in:

~/code/renamo-mac

Before starting a worktree session, sync with origin/main.

Generate and run

Use the included script:

./script/build_and_run.sh

The script:

  • Stops any running Renamo process
  • Runs xcodegen generate
  • Builds the Debug configuration
  • Opens the built app

Modes:

./script/build_and_run.sh run
./script/build_and_run.sh --debug
./script/build_and_run.sh --logs
./script/build_and_run.sh --telemetry
./script/build_and_run.sh --verify

Dependencies

The project uses:

  • Native macOS UI frameworks
  • PDFKit and Vision
  • Local model packages for document extraction
  • PostHog for analytics
  • Sparkle for app updates
  • A local InlineTokenField package for filename templates

Release tooling

The release script is:

./release.sh

Useful commands:

./release.sh preflight
./release.sh version
./release.sh bump patch
./release.sh release

Releases publish DMGs and appcast.xml to the renamo-updates R2 bucket behind https://download.renamo.app.