# Why a film is shorter

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

The target length is a budget, not a promise. A month with three photographed days might make twenty seconds of film. Adding the fridge and the ceiling would make it longer. It would not make it better. When the pool says a picture was left out, it names the rule: another frame carries its moment, it repeats a picture already in the cut, its place had its share, or the film's seconds ran out.

The editor tries distinct shots before stopping. It removes repeats even when that leaves the film short. Your title and ending cards also use part of the target length.

**Diagram: A film is as long as its distinct shots can carry. It's never padded.** [(image)](https://sam-dumont.github.io/immich-memories/diagrams/decide-length.svg)

```text
┌─────────┐  ┌───────────┐  ┌─────────────┐  ┌───────────────────────────┐  ┌───────────────────────┐  ┌────────────────────────────────┐
│         │  │           │  │             │  │     15, 30, 60 or 90 s    │  │        shorter        │  │                                │
│How long?├─►│--duration?├─►│ that target │ ►│    portrait, unless you   │ ►│what the distinct shots│ ►│            no film             │
│         │  │           │  │             │ ││     pick another shape    │ ││   can hold, then on   │ ││      Nothing worth a film      │
└─────────┘  └─────┬─────┘  └─────────────┘ │└───────────────────────────┘ │└───────────────────────┘ │└────────────────────────────────┘
                   │                        │                              │                          │
                   │                        │                              │                          │
                   │               ┌────────┘              ┌───────────────┘            ┌─────────────┘
                   │               │                       │                            │
                   │               │                       │                            │
                   │        ┌──────┴──────┐  ┌─────────────┴─────────────┐  ┌───────────┴───────────┐  ┌────────────────────────────────┐
                   │        │             │  │                           │  │                       │  │                                │
                   │        │             │  │          Too few          │  │                       │  │            The film            │
                   └───────►│--short-form?├─►│      distinct shots?      ├─►│     Nothing worth     ├─►│auto target rounded down to 5 s;│
                            │             │  │month: 60 s; trip: 60–300 s│  │        a film?        │  │   ordinary titles: up to 20%   │
                            │             │  │   from photographed days  │  │                       │  │                                │
                            └─────────────┘  └───────────────────────────┘  └───────────────────────┘  └────────────────────────────────┘
```

Arrows:

- How long? → --duration?
- \--duration? → that target
- \--duration? → --short-form?
- \--short-form? → 15, 30, 60 or 90 s
- \--short-form? → Too few distinct shots?
- Too few distinct shots? → shorter
- Too few distinct shots? → Nothing worth a film?
- Nothing worth a film? → no film
- Nothing worth a film? → The film

You can change the target in the brief, or use the CLI:

```bash
immich-memories generate --year 2024 --month 6 --duration 60
```

For a longer result, choose a wider period or [add pictures in the review](https://sam-dumont.github.io/immich-memories/docs/how-it-chooses/overrule-it.md). A saved edit can grow the film to fit what you keep.

If the period has pictures but nothing suitable, the run can finish successfully with **Nothing worth a film** and produce no video. A film with one usable shot is still a film. **On this day** needs usable material from at least two years because its point is the comparison, unless `--years-back 1` asked for one. When it declines, it says how many of the years held pictures.

Default lengths are on [Film lengths](https://sam-dumont.github.io/immich-memories/docs/reference/film-types.md#how-long-a-film-runs). Shot holds, timing trims and filler rules are in the [length reference](https://sam-dumont.github.io/immich-memories/docs/reference/selection-internals/length-and-filler.md).
