Skip to content

macOS app

github-actions[bot] edited this page Oct 3, 2026 · 10 revisions

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.

Menu-bar icon states

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.

Signing in

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.

Widget

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.

Places widget

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".

Updating

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 | bash

update-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.

Backups and restore

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.

Gatekeeper

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.

Sidecar architecture

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.

Widget manual checklist

  • 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

Places widget manual checklist

  • 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

Home

Clone this wiki locally