FolderBar

Quickly drag-and-drop files from an important folder right from your menu bar.

Preview

demo.mp4

Install

Download the latest release DMG:

https://github.com/jameskraus/FolderBar/releases/latest

Contributing

Run dev build

FolderBar runs as a packaged .app during development (Sparkle and signing behave differently outside a real bundle).

./Scripts/compile_and_run.sh

Signing dev build

Set a signing identity once in .env:

SIGNING_IDENTITY="Apple Development: Your Name (TEAMID)"

If SIGNING_IDENTITY is not set, packaging will fall back to ad-hoc signing.

Lint / Format / Test

brew install swiftformat swiftlint
make format
make lint
swift test

Git hooks

./Scripts/install_git_hooks.sh

This appends a call to the repo-managed hook into your local .git/hooks/pre-push (so existing hooks like bd keep working).

Release build

Both Scripts/compile_and_run.sh and Scripts/release.sh source .env automatically.

If someone tells you to release the app, do this:

1. Ensure you’re on main with a clean working tree.
2. Bump version.env (the release script reads VERSION= from here).
3. Run ./Scripts/release.sh.

Pre-req: create a .env file with release signing + notarization values, and set SPARKLE_PUBLIC_ED_KEY there too:

RELEASE_SIGNING_IDENTITY="Developer ID Application: Your Name (TEAMID)"
NOTARY_KEY_ID="ABC123XYZ"
NOTARY_ISSUER_ID="00000000-0000-0000-0000-000000000000"
NOTARY_KEY_PATH="/path/to/AuthKey_ABC123XYZ.p8"

This produces + publishes:

• build/FolderBar-<version>.zip
• build/FolderBar-<version>.dmg
• Git tag v<version>
• GitHub Release assets
• appcast.xml update committed to main

Agent notes

Agent-oriented docs (product goals/non-goals, project structure, release workflow) live in AGENTS.md.

Updates

Sparkle update/appcast/key details live in docs/UPDATES.md.