Requirements

What the phone and the Opensolr account have to provide.

Three things: a phone new enough, an Opensolr account, and a few permissions. The plan decides how much of the experience you get.

Android 8.0 or newer

API level 26. The app is a regular APK, installed from GitHub.

An Opensolr account

The app signs in with it and creates the phone's index in it. Create one.

Room for one more index

Every phone uses one Opensolr Index. If the plan's index allowance is full, the app says so and links to the plans.

A connection

Sync and search talk to Opensolr. Scheduled syncs wait for a connection by themselves.

01 · What your plan changes
Vector search

Photos are embedded; search matches meaning and words.

Without it
Photos are still read into words; search matches those words.
AI requests per month

Each new photo uses 2 with vector search (read + embed), 1 without. A typed search by meaning uses 1. Photos already indexed never cost again. See plan limits.

Disk space, bandwidth

Hold and serve the photo descriptions. When either runs out, the index pauses until you upgrade or the month resets.

02 · Permissions the app asks for
Photos

READ_MEDIA_IMAGES (or storage access on Android 12 and older), to find and read the photos in your folders.

Required
Yes
Photo locations

ACCESS_MEDIA_LOCATION. Without it Android removes GPS data from photos before the app sees them, and photos are indexed without a place.

Required
No
Your location (approximate)

ACCESS_COARSE_LOCATION, read once when this phone's index is created, to put the index on the Opensolr environment nearest to you (Chicago for the Americas, Finland for everyone else). The position never leaves the phone; without it the phone's time zone decides.

Required
No
Notifications

Sync progress and plan alerts.

Required
No
Internet, network state

Talking to Opensolr.

Required
Yes
Foreground data sync

So Android does not stop a long sync half way.

Required
Yes

Opensolr Photos is open source and MIT licensed. Questions about your Opensolr account, index or plan go to opensolr.com/contact; questions about the app itself belong on GitHub.

Opensolr Photos Documentation