The situations that actually happen, grouped by where you see them.
Tap Open Opensolr Photos. This happens when Android has not verified the app link yet, right after installing, or with a debug build.
The sign-in must finish within 15 minutes, on the phone that started it. Tap Sign in with Opensolr again.
The phone was signed out in Account › Devices, its key was refused, or the account is not active. Sign in again; your index is untouched.
Every phone uses one index. Delete an index you no longer use in the control panel, or upgrade, then tap Try again.
This phone's index belongs to a different account. Sign in with that account, or delete the index from it first.
The index took longer than usual to reload. Wait a minute and tap Try again, or Re-Sync on the Sync screen.
Open the Sync screen. If a sync is running, they are on their way. Otherwise check the photo's folder is ticked under Folders being indexed, then tap Re-Sync. If the index holds fewer photos than the phone knows, the Sync screen says so; Reset fills the index back from the phone's copy. See Re-read, Documents and Reset.
Only one sync runs at a time, and no button is refused as busy: the running sync is stopped first, then what you asked for runs. Stop halts every sync and face job until you press a button again.
More than half of the indexed photos went missing at once. That is almost always a phone that cannot see them (a storage card not mounted, a permission taken away), not photos you deleted, so nothing is removed. If you did delete them, tap Remove the N missing photos from the index on the Sync screen.
Only the reading of the pictures waits for next month's allowance or an upgrade. New photos are still indexed by date, camera, place, file name and your own words, and found by those words straight away. They are read when there is allowance again. What was read out of a photo before is kept, as long as it is the same file.
The index is over a limit of the plan and Opensolr closes it until it is back under. Upgrade, or wait for the monthly bandwidth reset.
The index had disappeared from your account and a new one was made. The same sync fills it back from the phone's copy: no photo is read again, and your tags, people and wording come back with it. There is nothing to do.
They could not be opened or decoded on the phone, usually damaged files or unusual formats. The red mark above the photo grid lists them, each with its file name and the reason. They are not tried again until the file changes or you pick them for Re-sync.
Expected when nothing changed. A sync compares your folders with the phone's own copy of the index, on the phone; no document is read out of the index, and only a few small checks go out.
At install, and again after a reinstall, the phone reads its copy of the index once. It is then kept in step by every write, so this wait happens only that one time. If the read fails, keep the phone on the network: the next sync reads it again.
The battery went below 20% while photos were being read. The sync continues on its own when the phone is charging.
Saving writes on the phone and is finished there. The sync that starts straight after carries the change up, 50 photos per call and with no pictures attached, because only the words changed; it uses the photos_words endpoint. If syncing is paused or the phone is offline, the change stays pending on the phone and goes up with the next sync. Nothing is lost in the meantime: search and browsing on the phone already use the new words.
That is what it does. In the tagging sheet for several photos, My tags (Albums) has an Add / Replace switch. Add puts the words on top of whatever each photo already carries. Replace makes the words the whole of that field on every ticked photo. The sheet says so under the switch, and lists what the ticked photos already carry, with counts.
They are gone. Press and hold a photo to start selecting, then tap to tick the rest. Selection ends by itself when you clear the last tick.
A tick on a group heading takes the whole group — the whole year, the whole month, the whole day — not only the photos loaded on screen. In a text search, Best matches and Also similar have no group tick, because the line between them moves as more results arrive.
The plan does not include vector search, this month's AI requests are used up, or the AI switch is off. When it is the plan or the allowance, the AI switch is greyed out, and the Me screen says which: Search by meaning: Not included, or the AI requests bar. See without photo recognition.
The photo has no GPS data, or photo-location access was not allowed when it was indexed. Allow it in Android settings; photos indexed from then on carry their place.
It was deleted or moved. The next Re-Sync removes it from the phone's copy of the index and from the index itself.
The index is still on an older configuration, so it carries no keys for similar photos yet. Open the photos screen and approve the reset. See a new index configuration.
Browsing, Stats and the tag suggestions come from the phone's copy of the index and are current the moment you change something. Answers from your index are reused for a short while, as set in the search cache; saving tags, deleting photos and every finished sync empty it. Pull the grid down to reload from the index and start a sync; a sync that is running is stopped and started again.
Every filter group is folded by default and keeps how you left it between visits, so a group can look empty when it is only closed. The badge on the heading counts how many of that group's own filters are on. Camera make was removed on purpose: the model already reads as “Nikon Z6”. A group with more than 50 values shows a small search field instead of its values: tap it for the most frequent ones, or type to find the rest.
An edit saved as a copy is a new photo to the app, read from scratch, without the tags, people or wording of the original. A crop or a filter can also change what the photo is read as. Search for what the edited photo shows, or tag it again.
Browsing, folding groups, tag and name suggestions and the “already on these photos” list all work offline, from the phone's copy. Typed searches and refreshing the filter lists need the index, and tags you save wait on the phone until the next sync can carry them up.
Still stuck? Account and plan questions go to opensolr.com/contact; problems with the app itself belong on GitHub issues.
Help
- Troubleshooting
- Phones you no longer use