Troubleshooting

The situations that actually happen, and what to do about each.

The situations that actually happen, grouped by where you see them.

01 · Signing in
The browser shows “Return to Opensolr Photos” instead of going back to the app

Tap Open Opensolr Photos. This happens when Android has not verified the app link yet, right after installing, or with a debug build.

“This sign-in was not started here or it took too long”

The sign-in must finish within 15 minutes, on the phone that started it. Tap Sign in with Opensolr again.

“Your Opensolr sign-in stopped working”

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.

02 · Setting up the index
“Your Opensolr plan cannot hold another index”

Every phone uses one index. Delete an index you no longer use in the control panel, or upgrade, then tap Try again.

“An index named photos_…__dense already exists in another Opensolr account”

This phone's index belongs to a different account. Sign in with that account, or delete the index from it first.

“The index configuration did not take effect”

The index took longer than usual to reload. Wait a minute and tap Try again, or Re-Sync on the Sync screen.

03 · Syncing
Photos are missing from search

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.

I pressed a button while a sync was running

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.

“N indexed photos are not on this phone any more. Nothing was removed from the index.”

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.

Paused: AI requests used up

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.

Paused: disk space or bandwidth

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.

“Index recreated”

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.

Some photos are counted as skipped

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.

A sync finished at once

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.

The first run after installing says “Reading your index once”

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.

“Waiting for the charger”

The battery went below 20% while photos were being read. The sync continues on its own when the phone is charging.

04 · Tags and selecting
I saved tags but the index does not show them yet

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.

“Replace” wiped the tags a photo already had

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.

Where did the Select button and Check all go?

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.

I ticked a heading and got more photos than were on screen

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.

05 · Searching
Search matches words only

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.

No location filter, and no Show on map or Photos nearby in the row under a photo

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.

“This photo is no longer on your phone”

It was deleted or moved. The next Re-Sync removes it from the phone's copy of the index and from the index itself.

“Finding similar photos needs your index reset for this version of the app”

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.

The results look out of date

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.

My filters look empty, or a filter I set seems lost

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.

A photo I edited no longer shows up in the same search

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.

The phone has no network

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

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