Mac menu bar

Install

1. Download RealTime-macos.dmg (Apple Silicon only).
2. Open the disk image and drag RealTime into Applications (or leave it in the disk image).
3. Open RealTime. If macOS blocks it, go to System Settings → Privacy & Security and click Open Anyway.
4. It lives in the menu bar. There is no Dock icon unless you turn that on in Preferences.
5. Click Log in. Your browser opens RealTime; after you sign in there, the week appears.

Sign in

1. Open the menu bar app. The week is locked until you sign in.
2. Click Log in. Your browser opens RealTime.
3. Sign in there if you are not already. The menu bar waits, then picks up the session and shows the week.

You cannot use the menu bar app signed out. Sign out from the settings gear if you need to switch accounts. Preferences → General is launch at login, Dock, idle minutes, updates, and the still-running reminder. The Account row is your avatar and name, and opens web settings.

What it does

• Lives in the menu bar — no Dock icon unless you turn that on in Preferences
• The menu-bar icon starts and stops the timer: idle vs elapsed while running. Right-click for Start / Stop
• Harvest-style week: hours-per-day header, that day's entries, play starts a matching timer, + and settings in the footer. No favorites, no money.
• Start/stop the one running timer per person, with a project & task picker scoped to what you're assigned to
• A timer-left-running hint once a timer has run past 10 hours — same stop resolutions as the web app
• A Harvest-shaped idle popover after 10 minutes idle (configurable in Preferences → General). Sleep, quit, and shutdown do not silently keep billing idle
• Still-running reminder after a duration you set (default 10 hours) — menu bar + email, never auto-stops
• Checks for updates on start and every few hours. A banner offers Update now or Next start. Preferences → Updates shows the installed version.
• Settings: log out, attach/detach from the menu bar, and links into the web app. Time tracking opens the existing week timesheet

Members still never see money in the menu bar app — it only ever calls time/timer/project/task endpoints, the same as the web app. There is no rate or invoice API call anywhere in it.

Build from source (optional)

You only need this if you want to change the app. Everyone else should download the DMG above.

# Rust + Xcode command line tools + pnpm
git clone https://github.com/la-agency/realtime.git
cd realtime
pnpm install
pnpm --filter @realtime/macos build

Output: apps/macos/src-tauri/target/release/bundle/macos/RealTime.app (a .dmg lands in the same folder).