Opensolr Photos documentation

The open source Android app that turns your photo folders into a search engine, on an Opensolr Index of your own.

Opensolr Photos is a free, open-source, MIT-licensed Android app that turns the photo folders on your phone into a search engine. Every photo is read into words, kept with a search vector and its camera details in an Opensolr Index of your own, and found again by what is in it. This is the complete documentation for it.

HOW A PHOTO BECOMES SEARCHABLE On the phone the app Photo in a folder EXIF read here 640 px copy made image_clip api.opensolr.com CLIP reads the copy Returns 12 labels Copy not stored batch_embed api.opensolr.com Labels to a vector 1024 numbers Plans with vectors Your index Solr, direct POST /update Labels and vector Date, camera, place Search the app Words, meaning Filters Opens in gallery Paid for once per photo Labels and vectors are cached on the phone. An emptied or recreated index is refilled without a single AI request. The copy carries nothing else It is re-encoded from pixels: no EXIF block, no GPS, no camera data travels with it. EXIF goes only into your own index, as fields.

Figure 1 — how a photo becomes searchable: read on the phone, labelled and embedded by Opensolr, stored in your own index, found by search.

New here? Two pages and you will know whether you want it.

What Opensolr Photos is says what it does and what it deliberately does not do. Privacy says exactly what leaves your phone.

01 · The shortest path to searching your photos
  1. Check the requirements: Android 8.0 or newer and an Opensolr account, ideally on a plan with vector search.
  2. Install the signed APK from GitHub.
  3. Sign in with Opensolr in your browser and read what your plan covers.
  4. Choose your folders. DCIM is proposed.
  5. Let the first sync run, and search as soon as the first photos arrive.
02 · Beyond this documentation

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