MacCarUnlock

A lightweight menu bar macOS app that plays car lock/unlock sounds when your Mac locks and unlocks.

Features

• Plays lock/unlock sounds
• Choose custom sounds via the menu
• Volume control
• Optional "Bypass System Mute" mode (prefers built-in output when available)
• Unlock indicator mode: Off / Single / Double (with optional unlock flash delay)
• Start at Login toggle (from the menu)
• No network access

Requirements

• macOS 10.12 (Sierra) or later
• Xcode Command Line Tools

Install

Recommended (DMG)

• Download the latest release DMG from GitHub Releases.
• Open the DMG and drag MacCarUnlock.app into /Applications.
• Launch it once; it runs as a menu bar app (no Dock icon).

Build + Package From Source

swift build -c release --arch arm64 --arch x86_64
Scripts/package_app.sh
Scripts/build_dmg.sh

Local Test Builds (Ad-hoc Signing)

For local testing, you can ad-hoc sign the app bundle and DMG:

MACCARUNLOCK_ADHOC_SIGN=1 Scripts/package_app.sh
MACCARUNLOCK_ADHOC_SIGN=1 Scripts/build_dmg.sh

Note: ad-hoc signing is not notarization. On macOS you may still need to allow the app via System Settings (Privacy & Security) or remove quarantine attributes.

Outputs:

• dist/MacCarUnlock.app
• dist/MacCarUnlock.dmg

Configuration

MacCarUnlock stores config under ~/Library/Application Support/MacCarUnlock/config.json.

See docs/CONFIGURATION.md for the full schema.

Contributing

See CONTRIBUTING.md.

License

MIT - see LICENSE.