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 a tenth of a request, so ten photos cost one; the words, the search vector and the text printed in the photo are all inside that tenth. 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

ACCESS_COARSE_LOCATION, ACCESS_FINE_LOCATION and ACCESS_BACKGROUND_LOCATION, asked only if you turn on Locate new photos, so a new photo without a position of its own can take the phone's position, also when it is synced in the background. The app never asks for it otherwise.

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