Repository navigation
macOS app
Find+.app is a menu-bar shell (Tauri 2) around the same daemon the CLI runs, with a WidgetKit widget for Notification Center.
Find+ never shows a Dock icon. It lives entirely in the menu bar (a small "F+" glyph) and opens its dashboard from there or from Applications/Spotlight.
The tray icon is the same "F+" glyph in both states; only its opacity changes:
| State | Icon | Meaning |
|---|---|---|
| Ok | Full opacity | Daemon reachable and polling normally. |
| Stale | Dimmed | Daemon reachable, but the last poll is older than twice the poll interval. |
| Error | Dimmed | Sign-in needed, a decryption error, or three or more failed polls in a row. |
| Locked | Dimmed | The app lock is on. No location data is shown until you unlock. |
| Down | Dimmed | Find+ is not running (also shown while it is still starting up). "Restart daemon" appears when it was running and stopped. |
Click the tray icon to open or focus the dashboard. Right-click for the menu, which shows the status line above (spelling out which of the dimmed states applies), the most recent fix (hidden while locked or down), the tracked device count, Poll Now, Lock, Open Dashboard, Settings, Open App and Quit Find+. "Start at login" is in the Settings window, not the menu.
When Google or Apple ends a sign-in, the icon dims and the top item of the menu becomes "Sign in to Google again...", "Unlock Google locations..." or "Sign in to Apple again...". Click it to start that sign-in. You also get one notification, "Find+ needs you", per loss, if you allowed notifications.
Opening Find+.app again from Applications or Spotlight while it is already running brings the dashboard forward instead of doing nothing; the first launch after installing still shows the setup wizard, same as before.
The app signs in to Google in a small Find+ window that shows Google's own page and closes by itself when you are in; the same window takes the unlock step. It keeps nothing and is separate from your browsers. Apple opens a sheet in the dashboard. The separate Find+ Chrome window older versions used is hidden in 1.2. Details: Sign in. If Google refuses the window, the card falls back to the Chrome helper or a pasted cookie.
Add the widget from System Settings -> Widgets -> Find+, or Notification
Center's Edit Widgets in earlier macOS versions. It shows tracked device
count, group presence, and the most recent fix, refreshed whenever the
daemon polls. Toggle the map preview on the large widget with
findplus widget show-map on or off; force an immediate refresh with
findplus widget refresh.
The headline age, the freshness dot and the large widget's map snapshot all describe the device with the newest fix, whatever it is called. A device whose last fix is older than the stale threshold is shown with no place and no map: a missing fix is not evidence of where a tag is.
The small widget shows status only. It carries no action buttons; at that size a mis-tap is too easy, and Poll Now and Lock are both one click away in the menu bar.
A second widget, "Find+ Places", shows who is at each saved place: its name, badges for whoever is currently inside (a device badge, or a group badge when every one of a group's members is there together), and how long ago that changed. A place with no one inside reads "Nobody here". Add it the same way as the status widget, then pick "Find+ Places" instead of "Find+". The small size shows up to two places; medium shows up to four and adds the last change time. Tapping the widget opens the dashboard's Places tab.
Locked and offline states behave exactly like the status widget: no place names or badges are shown, only the lock glyph or "Find+ is not running".
The app updates itself: it checks GitHub, downloads and verifies the new version, backs up your database and restarts into it while you are not using Find+. The menu bar shows Restart to update (vX) while it waits. See Updates for the details and the off switch.
To update by hand: Finder will not replace an app that is open. Use the update script instead. It
quits Find+ and its daemon, swaps in the latest release (checking the dmg's
sha256 first), and starts Find+ again. Your history and settings live in
~/.findplus and are not touched.
curl -fsSL https://github.com/acamarata/findplus/releases/latest/download/update-app.sh | bashupdate-app.sh --dmg FindPlus-<version>-aarch64.dmg installs a dmg you already
downloaded. Homebrew users run brew upgrade findplus.
The sha256 check catches a corrupted download. It does not authenticate the release on its own; the script also refuses a new app signed by a different developer (Team ID) than the one you have installed.
The app shares the daemon's daily backup in ~/.findplus/backups/ (see
Backup and restore). Restoring needs the daemon stopped: quit Find+ from the
menu bar first, then run findplus db restore <file> and open the app again. Backups are
unencrypted copies of the database.
Find+ is distributed outside the Mac App Store. Release builds are signed with a Developer ID and notarised by Apple, so they open normally.
A build made locally without signing credentials carries -UNSIGNED in its
filename and is never attached to a release. For one of those, right-click
Find+.app and choose Open the first time; later launches open normally.
To check a build yourself, assess it as an executable, not as an installer:
spctl -a -vv --type exec /Applications/Find+.app--type install is for installer packages and reports rejected on an app
bundle whatever its signature.
The Python daemon is bundled inside Find+.app as a PyInstaller sidecar
(Contents/Resources/), started and supervised by the Tauri shell. It is
the same daemon the CLI installs; the app never runs a second copy.
- Gallery shows three sizes (systemSmall, systemMedium, systemLarge)
- systemSmall shows no action buttons
- The headline device is the newest fix, not the first name alphabetically
- Locked state shows lock glyph and 'Locked', no device data
- Poll Now intent triggers a poll (check daemon log)
- Open Find+ intent opens the dashboard
- Dark mode: all text and dots adapt, no hardcoded light colors
- Gallery shows "Find+ Places" as a separate gallery entry, two sizes (systemSmall, systemMedium)
- A place with someone inside shows their device/group badge(s)
- A place with no one inside reads "Nobody here"
- A fully-present group shows its own badge, not one badge per member
- Locked state shows lock glyph and 'Locked', no place data
- Tapping the widget opens the dashboard on the Places tab
- Dark mode: all text and badges adapt, no hardcoded light colors