# Search

Source: https://frameleaf.app/docs/using/search/

Type what you remember. Frameleaf's smart search understands the content of photos and videos, so "dog on the beach" or "sunrise over a lake" finds them without any tags. Narrow any search with filters, type filters straight into the search box, or ask a question in everyday words.

Your server keeps the search index and reads every search you type. Smart search runs on your machine learning worker, or on Frameleaf Cloud if an administrator chooses it for a server without a capable GPU. See [Private by design](#private-by-design).

## Open search

- Click the search box at the top of the page.
- Press **Ctrl K** (**⌘ K** on a Mac) from anywhere.
- Press **/** when you're not typing in a field.

The search panel opens over the page. As you type, it shows suggestions, matching people, places and pages, and a live count of matches.

[![Smart search for lake showing matching photos, refinement controls and the dates of matching items.](https://frameleaf.app/shots/docs/search-library.jpg)](https://frameleaf.app/shots/docs/search-library.jpg)

*Start with a word you remember, then refine the matches without leaving the search panel. Select the image to enlarge it.*

| Key | Does |
| --- | --- |
| **↑** and **↓** | Move through suggestions and results |
| **Enter** | Open the highlighted item |
| **Tab** | Complete the highlighted suggestion |
| **Ctrl Enter** (**⌘ Enter** on a Mac) | Show all results |
| **Esc** | Close the panel |

Start with **>** to switch to the command palette and jump to a page, a setting, a person or a place instead of searching.

## Search modes

The mode menu at the left of the search box chooses what your words are matched against:

| Mode | Searches |
| --- | --- |
| **Smart search** | The content of photos and videos, by meaning. The default. |
| **All text** | File names, descriptions, text in photos and folder paths, all at once |
| **Filename** | Full or partial file names, or the extension |
| **Description** | Descriptions, including [AI descriptions](https://frameleaf.app/docs/using/ai-descriptions/) |
| **Text in photos** | Words read from signs, receipts, documents and screenshots |
| **Full path** | Full or partial folder names from the original path |
| **Spoken words** | Words said in your videos, once you turn on [spoken words](https://frameleaf.app/docs/using/spoken-words/) |

The text modes match anywhere in the field, and ignore capitals and accents, so `cafe` finds `Café`. For example, in **Full path**, searching for `Projects`, `3D`, `Printing` or `2026` all find a photo stored at `/John/Projects/3D_Printing/2026-07-01/IMG_0001.jpg`.

**Text in photos** is more forgiving: it matches words that are close to what you typed, which helps when the text recognition misread a letter.

## Smart search

Smart search compares your words with what's actually in each photo and video, using the smart search model your administrator chose. No tags or captions needed: `birthday cake with candles`, `snow in the mountains` or `red car at night` all work.

Results are ranked by how well they match. Frameleaf also gives a boost to photos whose description or recognised text contains your words, so a receipt that says "Whole Foods" rises when you search for it, even if it looks like any other receipt.

A few tips:

- Describe what you'd see, not what it means to you: `girl blowing out candles` rather than `Emma's 5th`.
- Add a filter for the part a picture can't show, such as a person, a place or a date. See [Search syntax](https://frameleaf.app/docs/using/search-syntax/).
- Smart search ranks matches rather than filtering them, so a long list of results gets less relevant towards the end.

### Find similar photos

Open a photo and choose **Find similar** from the viewer's menu to search for photos that look like it. The search panel shows the photo as **Similar to a photo**, and you can add filters on top.

### Video moments

A smart search also shows **Moments in your videos** above the results, with how many videos matched, such as **3 videos**. Each video gets one tile: a frame from its first matching moment with the time, such as 0:12, how many moments match, and when and where it was taken. Moments within a few seconds of each other count as one. Select a tile to play the video from that moment.

Moments come from frames that match your words by meaning, and from moments you've added whose title or transcript contains them. Only your own videos are searched. When nothing in your videos looks like what you typed, the strip doesn't appear. See [Video moments](https://frameleaf.app/docs/using/ai-descriptions/#video-moments).

If only your videos match, the page keeps the strip and says so under it, for example: "No photos match “campfire song”. The video above mentions it."

## Ask about your photos

Open the **Search** page with nothing typed to see **Ask about your photos**. Type a question in everyday words, or pick one of the examples:

- `favorite videos since 2020`
- `photos from last summer`
- `receipts from last year`
- `screenshots from last month`

Frameleaf turns the question into search filters, runs it, and shows **What Frameleaf searched for** so you can see how it read your question and refine it.

### Frameleaf Assistant beta

Frameleaf Assistant answers a question typed into search with the matching photos and videos, and a line under each one saying why it matched. It's part of search on the web, it's on unless your administrator turned it off, and it carries a **Beta** label while it's being improved.

1. Open the **Search** page.
2. Under **How to search**, choose **Frameleaf Assistant**.
3. Type a question in **Ask about your photos**, such as "Emma by the lake last summer", and press Enter.

While it works you see **Looking through your library…**. Then the page shows **Matching photos**.

**Why this matched.** Each result says what connected it to your question: who is in it, where and when it was taken, words from its description, words written in the photo, or something said in a video. Select a result to open it.

**Where it was answered.** A line above the results says how the question was read:

- **Answered on this server.** Frameleaf Assistant read the question on your own server.
- **Answered with simple search.** The assistant wasn't available, so Frameleaf matched the words, names, places and dates in your question. The table below shows what simple search understands.

Your question and your photos stay on your own hardware either way.

**If nothing matches**, the page says **Nothing in your library matches**. Try asking another way, such as a place, a year or who is in the photos, or choose **Try classic search**.

**Tell us how it went.** Under the results, **Did this find what you were looking for?** takes a yes or a no.

**Locked photos.** The assistant never sees Locked photos. Open Locked to look there yourself.

**Go back to classic search.** Choose **Classic search** in the search header to return to filters and search by text or meaning. Frameleaf remembers your choice. You can also set it in your preferences with **Use classic search**, and switch back on the search page at any time.

**For administrators.** In **Settings**, then **Search & intelligence**, then **Visual search**, the **Frameleaf Assistant** section has:

- **Use Frameleaf Assistant in search** (on). Off: everyone gets classic search, and the search page says the assistant is turned off on this server.
- **Most assistant answers shown** (100), from 1 to 500.
- **Read questions with a language model** (off). When a planner model is installed on this server or a computer at home, it reads each question first. Without one, simple search rules answer.

To ask about your library from Claude or ChatGPT instead, see [Connect AI assistants](https://frameleaf.app/docs/using/connect-ai-agents/).

### What Ask understands

| You write | Ask uses |
| --- | --- |
| `today`, `yesterday`, `this week`, `last week`, `this month`, `last month`, `this year`, `last year` | That date range |
| A year, such as `2024` | That whole year |
| `last summer` | June to August of last year |
| A month, such as `April` or `April 2024` | That month (this year if you leave the year out) |
| `since 2020`, `after 2020`, `before 2020` | An open-ended date range |
| `since April 2024`, `before April 2024` | An open-ended range from the start of that month |
| `favorite`, `favorites`, `starred` | Favourites only |
| `video`, `videos`, `movie` | Videos only |
| `photo`, `photos`, `picture`, `image` | Photos only |
| `in`, `near`, `around` or `at`, then a place | That city |
| `with` or `of`, then names | Those people or pets |
| `receipt`, `invoice` | Text in photos that looks like a receipt |
| `screenshot` | Files with "Screenshot" in the name |
| `document`, `paperwork`, `form` | Text in photos that looks like a document |
| `ID`, `passport`, `license`, `medical`, `legal` | Text in photos matching your words |

Everything else in the question goes to smart search.

### People, pets and places in a question

Names after **with** or **of** are matched against the people and pets you've named. Separate several names with **and**, **&** or commas: `photos of Alice and Sam at the lake`. An exact name wins, a person before a pet; otherwise Frameleaf picks the closest name. Hidden people never match, and neither do Locked ones until you unlock.

If a name doesn't match anyone, the search still runs and Frameleaf tells you the person match is approximate.

For places, use a real city name. Phrases such as "my hometown" or "the beach" aren't treated as places: Frameleaf tells you and searches without a location.

Receipts, documents and screenshots are found using the text in them and file names, so these questions skip smart search.

:::note
Ask returns up to 100 matches by default. If Ask is turned off on your server, the Search page says so. Administrators control both in **Settings**, then **Search & intelligence**, then **Visual search**, under **Ask about your photos**.
:::

## Filters

While you type, the side of the search panel suggests quick refinements with their counts: **People**, **Media**, **Places**, **Cameras** and **Star rating**. Click one to add it to your search.

Click **Advanced** in the search panel, or **Filter** in the toolbar above your search results or above the Library grid, to open the full filter panel. Every choice shows how many items match it in the current search.

| Section | Filters |
| --- | --- |
| **People** | People recognised in your photos. Choose whether results include **All of** them, **Any of** them, or **Exclude** them. |
| **Pets** | Your named pets, once you have one |
| **Media type** | **All**, **Photos** or **Videos** |
| **Shot type** | Slo-mo, time-lapse, panoramas, 360° photos, bursts, portraits, selfies, screenshots, screen recordings and long exposures. See [Photo and video types](https://frameleaf.app/docs/using/photo-and-video-types/). |
| **Capture date** | **From** and **Through** dates |
| **Places** | Country, state and city |
| **Rating & favorites** | Star rating, such as **Exactly 3 stars** or **3 stars or more**, **Rejected**, **Unrated**, **No rating metadata**, and favourites |
| **Tags** | Your [tags](https://frameleaf.app/docs/using/tags/), including tags read from your files |
| **Albums** | One or more albums |
| **Camera & lens** | Camera brand, camera model and lens model |
| **Text & descriptions** | Photos with **No description** or where description **Generation failed** |
| **Sensitivity review** | Results of sensitive-content detection: **Reviewed**, **Needs review**, **Overridden**, **Flagged as sensitive**, **Check failed**, **Not checked** |
| **Library status** | **Not in any album**, **Untagged**, visibility, **Has people**, **In an album**, **Has tags**, **Motion** and **Offline** |

**Reset filters** clears them all. Filters you set in the panel and filters you type in the search box are the same thing: picking a person in the panel replaces a typed `person:` filter for the same field, so the two never disagree.

The **Text & descriptions** and **Sensitivity review** sections come into play when your administrator turns on [AI descriptions](https://frameleaf.app/docs/using/ai-descriptions/) or [sensitive-content detection](https://frameleaf.app/docs/using/private-content/).

### Matches by date

While you search, the panel shows **When**, a bar chart of matches by day, month or year, depending on how far apart they are. Click a bar to narrow the search to that period: Frameleaf adds date filters for it, which you can remove like any other. The chart is in the main search panel, not under **Advanced**.

## Where you search from

Start a search from inside an album, a pet's page or a shared space, and the search panel offers that collection and **Entire library**, each with its count. Pick one, then show results.

## Results

The results page is titled with what you searched for, such as **Results for “lake”**, with **Clear search** beside it to drop the words and keep your filters. A search made only of filters is titled **Library**. Your filters show as chips under the title. Click a chip's cross to remove it, or **Clear all**. From the toolbar you can sort, switch between grid and list, start a slideshow, and see results on a map. On a wide screen the layout tabs sit in the toolbar too.

Search links keep your whole search, so you can bookmark it or come back with the browser's Back button.

### Best matches

Smart search ranks every photo, so the later results get less and less like what you typed. To help, the results open with **Best matches**, the photos that come close to your words, and the rest follow under **More results**, with how many looser matches there are. You can select across both. The page shows one list instead when the matches are all much alike, for a text search, for **Find similar**, and in a small library.

### When nothing matches

When no photo or video matches, the page says **No matching photos or videos**, with a suggestion: **Try fewer words.**, or **Try fewer words, or clear the filters.** when you also have filters. **Clear search and filters** starts again.

### When smart search is off

If smart search is turned off on your server, or isn't ready, a search by meaning is matched by text instead: file names, descriptions, text in photos and folder paths. That happens, for example, when you open a saved search or a link made while smart search was on. A line above the results says "Matched by file name, description and other text only. Finding photos by what is in them is off or still getting ready.", and an administrator also sees **Open Visual search**, which opens its settings. A chip such as **All text: lake** shows what was searched; removing it is the same as **Clear search**. Text matching doesn't look at place names: use the **Places** filter for those.

## Recent and saved searches

The search panel remembers your last five searches under **Recent**.

To keep a search, choose **Save search** and pick what to make:

| Option | What you get |
| --- | --- |
| **Smart album** | An album that keeps updating as new photos match. See [Albums](https://frameleaf.app/docs/using/albums/#smart-albums). |
| **Album snapshot** | An ordinary album with exactly the items that match now. You see the count before it's made. |
| **Saved search** | The search itself, to run again from search and the sidebar |

To have a search's matches added to an album or tagged for you, choose **Automate this search**. See [Workflows](https://frameleaf.app/docs/admin/workflows/).

You can keep up to 50 saved searches, each with a name of up to 100 characters. Saving with a name you already used replaces that search.

Searches by people, tags, media type, dates and smart search can become a smart album. If your search also has an exclusion, a place, a camera or a rating, Frameleaf lets you know, so the album always matches exactly what you expect.

A snapshot of a smart search saves the top ranked matches, because smart search ranks rather than filters.

Saved and recent searches store references to people, pets and tags, never their names. A saved search that names something Locked stays out of the list until you unlock.

## Private by design

Your server keeps its own search index and searches it locally. Smart search processes images and search text on the machine learning worker your administrator configured, which normally runs alongside Frameleaf. If your administrator chooses a remote worker, that data travels to it, so use a worker on your own network to keep processing at home. Linking Cloud leaves your worker as it is. An administrator can choose Frameleaf Cloud to prepare smart search: the Cloud reads a metadata-stripped preview of each photo with the same model your server uses, and your server keeps the result. What you search for is always read on your server and never leaves it. See [Search and faces on Frameleaf Cloud](https://frameleaf.app/docs/admin/workers/#search-and-faces-on-frameleaf-cloud). [Locked](https://frameleaf.app/docs/using/private-content/) items appear in your results, counts and suggestions only after you unlock your session.

## For administrators

Search is set up in **Settings**, then **Search & intelligence**. The page opens with one switch, **Search and recognition**, for every feature below it; turning it off keeps what has already been read. Each feature then has a page of its own:

| Page | Setting | Default |
| --- | --- | --- |
| **Visual search** | **Search by describing a photo** | On |
| **Visual search** | **Search quality**, the smart search model | `ViT-B-16-SigLIP-384__webli` |
| **Visual search** | **Answer questions about your photos** | On |
| **Visual search** | **Most answers shown**, under **Advanced: how many answers** | 100 (1 to 1,000) |
| **Visual search** | **Use Frameleaf Assistant in search** | On |
| **Text, documents & receipts** | **Read text in photos** | On |
| **Text, documents & receipts** | **Languages to read** | Chinese, Japanese and English |

To search in another language, or to get better results on stronger hardware, see [Choose a smart search model](https://frameleaf.app/docs/using/search-models/). Changing the model there offers **Save and start now** or **Save and start tonight**, and reads every photo again for you.

The text settings, including the languages text can be read in, are explained in [Documents and text in photos](https://frameleaf.app/docs/using/documents/#for-administrators). After you change how text is read, choose **Do it all again** on **Reading text in photos** in **Settings**, then **Computers & background work**, then **Background work** to read the photos you already have.

While search is still reading a library, the **Search & intelligence** page says how many photos are waiting, and **See what's waiting** opens the list.
