Repository navigation
Install
curl -fsSL https://raw.githubusercontent.com/acamarata/findplus/main/install.sh | bashInstalls Find+ into ~/.local/share/findplus/ and links findplus into
~/.local/bin/. Requires Python 3.12, 3.13 or 3.14. Pass --yes to skip the
confirmation prompt, or --uninstall to remove it (see Uninstall
for what that keeps and what it removes).
~/.local/bin is not on the default PATH on macOS, and on Debian and Ubuntu
~/.profile adds it only if the directory already existed when you logged in.
If it is not on yours, the installer says so and prints the line to add; until
you add it, ~/.local/bin/findplus works by full path.
On Debian and Ubuntu the venv module ships separately from python3. If it
is missing the installer names the exact package to install
(sudo apt install python3.12-venv) rather than the Python version.
Re-running the installer upgrades an existing install. If its virtualenv was broken by an OS upgrade or a removed Python, re-running rebuilds it.
Find+ is not published to PyPI. Install the wheel from the latest release
instead. Download the findplus-<version>-py3-none-any.whl from the
Releases page (for example, v1.3.0):
pipx install https://github.com/acamarata/findplus/releases/download/v1.3.0/findplus-1.3.0-py3-none-any.whlOr install from the latest release directly:
gh release download --repo acamarata/findplus --pattern '*.whl' && pipx install findplus-*.whlpip install with the same URL works inside an existing virtualenv.
brew install acamarata/tap/findplusbrew upgrade findplus picks up each new release once the tap formula is updated.
Download FindPlus-<version>-aarch64.dmg from the
Releases page. Open the
dmg and drag Find+ to Applications. The app bundles the daemon, so no
separate CLI install is required.
The app is built for Apple Silicon only. On an Intel Mac, install with Homebrew or the curl installer above and open the dashboard in your browser at http://127.0.0.1:8647.
You only need the Find+ Chrome helper if Google refuses the Find+ sign-in
window, or if you use the dashboard in a browser tab instead of the app (a tab
cannot open the window). It is the same for every install route (curl, pipx,
Homebrew, dmg). Add it once: on the sign-in card, open More ways to sign in
and Show the steps, copy the folder path, then in Chrome go to
chrome://extensions, turn on Developer mode, click Load unpacked and choose
that folder. Find+ opens nothing for you. See Sign in
and Chrome helper privacy for what it reads.
The app updates itself while you are not using it (see Updates). To update right away,
use Restart to update in the menu bar, or run this while Find+ is open; it quits the app,
swaps it and starts it again. Your history, settings and ~/.findplus/backups/ are not touched.
curl -fsSL https://github.com/acamarata/findplus/releases/latest/download/update-app.sh | bashupdate-app.sh checks the dmg against the sha256 published on the same release.
That detects a corrupted download only. It also refuses a new app signed by a
different developer (Team ID) than the installed one.
Everything lives in ~/.findplus/: the database, secrets, logs and a daily backup folder,
~/.findplus/backups/. Backups are unencrypted copies of the database (with the app-lock PIN hash,
never sign-in tokens). Upgrading never touches them. See Backup and
restore.
Run findplus setup for a guided walkthrough (or findplus auth then
findplus start for the two-command path), then continue with
First run.
To remove Find+ later, see Uninstall.