# How it chooses

Markdown version of <https://sam-dumont.github.io/immich-memories/docs/how-it-chooses/overview/>.

You choose a month, a trip, a person or an album. Immich Memories turns that pool into a chronological film: a few moments worth keeping, rather than every photo you took.

**Diagram: From your library to a finished film in five steps.** [(image)](https://sam-dumont.github.io/immich-memories/diagrams/seq-generate.svg)

```text
┌────────────────────────────────┐  ┌────────────────────┐  ┌──────────────────────────┐  ┌───────────────────────────┐
│             1 Read             │  │                    │  │                          │  │       Render worker       │
│   people, photos and videos    │  │ Captions + checks  │  │       Reader model       │  │     if you set one up;    │
│         in the period          │  │ GPU and Full tiers │  │Full tier reads the period│  │music can be made meanwhile│
└────────────────┬───────────────┘  └──────────┬─────────┘  └─────────────┬────────────┘  └─────────────┬─────────────┘
                 │                             │                          │                             │
                 │                             │                          │                             │
                 ├─────────────────────────────┘                          │                             │
                 │                                                        │                             │
                 ▼                                                        │                             │
┌────────────────────────────────┐                                        │                             │
│             2 Look             │                                        │                             │
│ previews, faces, pixel facts;  │                                        │                             │
│   drops screenshots, copies    │                                        │                             │
└────────────────┬───────────────┘                                        │                             │
                 │                                                        │                             │
                 │                                                        │                             │
                 ├────────────────────────────────────────────────────────┘                             │
                 │                                                                                      │
                 ▼                                                                                      │
┌────────────────────────────────┐                                                                      │
│            3 Choose            │                                                                      │
│      stories, best shots,      │                                                                      │
│  family-viewing check, length  │                                                                      │
└────────────────────────────────┘                                                                      │
                 │                                                                                      │
                 │                                                                                      │
                 ├─────────────────────────────┐                                                        │
                 │                             │                                                        │
                 ▼                             ▼                                                        │
┌────────────────────────────────┐  ┌────────────────────┐                                              │
│        4 Title + music         │  │                    │                                              │
│   your title or a template;    │  │Nothing worth a film│                                              │
│your track, generated or bundled│  │  no film, exit 0   │                                              │
└────────────────┬───────────────┘  └────────────────────┘                                              │
                 │                                                                                      │
                 │                                                                                      │
                 ├──────────────────────────────────────────────────────────────────────────────────────┘
                 │
                 ▼
┌────────────────────────────────┐
│            5 Render            │
│ FFmpeg joins clips and titles, │
│ then lays the music under them │
└────────────────┬───────────────┘
                 │
                 │
                 │
                 │
                 ▼
┌────────────────────────────────┐
│                                │
│           Your film            │
│     in your output folder      │
└────────────────┬───────────────┘
                 │
                 │
                 │
                 │
                 ▼
┌────────────────────────────────┐
│                                │
│        Back into Immich        │
│        if upload is on         │
└────────────────────────────────┘
```

Arrows:

- 1 Read → 2 Look
- 2 Look → 3 Choose
- 3 Choose → 4 Title + music
- 3 Choose → Nothing worth a film
- 4 Title + music → 5 Render
- 5 Render → Your film
- Your film → Back into Immich
- Captions + checks → 2 Look
- Reader model → 3 Choose
- Render worker → 5 Render

Thirty pictures of the same jump are one moment. A holiday with several stops has several stories. The editor gives those stories room, picks a frame from each moment, and removes repeats. It uses dates, places, faces, favourites and small local picture classifiers.

- **Your favourites matter.** A star in Immich wins over other frames of that moment. It still needs a place in the film.
- **People and motion help.** A clear frame of someone you know usually beats another empty room. Videos and useful Live Photo motion can play alongside stills.
- **Family matters.** Confirm who your close family is so someone photographed all month gets more than zero appearances.
- **A quiet month makes a shorter film.** The target length is a budget. It does not need to be filled with the ceiling.
- **You have the final edit.** Review the pool, add what matters and remove what does not. The film follows those choices.

Basic does this without a prose model. A GPU adds descriptions and an extra sharing check. With a text model too, the app can refine the draft. Those additions have costs and limitations: [Choose an upgrade](https://sam-dumont.github.io/immich-memories/docs/better/overview.md).

Read [how moments become stories](https://sam-dumont.github.io/immich-memories/docs/how-it-chooses/moments-and-stories.md), [how a shot wins](https://sam-dumont.github.io/immich-memories/docs/how-it-chooses/picking-shots.md), and [what a model changes](https://sam-dumont.github.io/immich-memories/docs/how-it-chooses/what-a-model-adds.md).

## Make it yours

[Review and adjust the cut](https://sam-dumont.github.io/immich-memories/docs/how-it-chooses/overrule-it.md), [choose who may see it](https://sam-dumont.github.io/immich-memories/docs/how-it-chooses/family-audience-duplicates.md), or [understand a shorter film](https://sam-dumont.github.io/immich-memories/docs/how-it-chooses/length-and-filler.md). Where the films still fall short is tracked in [the issue tracker](https://github.com/sam-dumont/immich-memories/issues).

For the exact grouping, scoring and timing rules, read [Selection internals](https://sam-dumont.github.io/immich-memories/docs/reference/selection-internals/overview.md). You do not need those to make a film.
