# Your first film

Markdown version of <https://sam-dumont.github.io/immich-memories/docs/get-started/first-film/>.

Use an Immich album with **20–50 photos and short videos**, and make a **30-second film**.
A small album keeps the first preparation short. The steps are the same on Basic, GPU and Full.

## Before you start

Finish the model download and checks in your [installation guide](https://sam-dumont.github.io/immich-memories/docs/get-started/quick-start.md), then open
Immich Memories in your browser. Start here if you have already completed those steps.
There is no need to prepare your whole library or configure home and people before an album film.

## 1. Choose an album

In Immich, use an existing small album or create one from 20–50 photos and videos.
In Immich Memories:

1. Open **Memory** and choose **Album** under **Memory type**.
2. Select your album. Its picture count appears in the dropdown.
3. Open **Length and pictures** and set **Length in minutes** to **0.5**.

The bundled music is ready to use. Leave upload off for this first film so you can download it.

## 2. Make the cut

Press **Cut**. The app prepares the pictures and chooses the shots. The first cut takes longer;
later films reuse the preparation. A shorter film still prepares every picture in scope, which
is why this first one uses a small album.

When the cut finishes, its run opens. You can also find it under **Runs**.

## 3. Review the shots

The contact sheet shows the shots in playback order. Open one to see it larger, watch its video
interval and read why it was selected. Fewer shots than source pictures is normal: bursts and
similar pictures often become one shot.

![A finished cut of July 2025: its one-line story, the numbered contact sheet with each shot's date, timecode and reason, and the first shot open on the right](https://sam-dumont.github.io/immich-memories/img/screenshots/memory-story.png)

### Make a change

Use **Remove from this cut**, **Start here** / **End here** to trim, or **Use this picture instead**
to swap a shot. Press **Save revision**. To add a missing picture, open **Pool**, select it and
press **Preview with these choices**.

![One shot opened from the cut: its picture, Remove from this cut, Keep the original, its screen time, why it was picked, and the other pictures of its moment](https://sam-dumont.github.io/immich-memories/img/screenshots/first-film-edit.png)

[Editing a cut](https://sam-dumont.github.io/immich-memories/docs/how-it-chooses/overrule-it.md) covers the other controls, including choices that
apply to future films.

## 4. Render and watch

Below the contact sheet, find **Render**. Choose your cut or saved revision under **What to render**,
then press **Render**. Leave **Upload the film to Immich** off.

When the film is ready, the run shows a player and **Download film** underneath it.
Watch it with sound, then download the MP4.

![The run page once the film is ready: the player, Download film, and the render options for another version](https://sam-dumont.github.io/immich-memories/img/screenshots/memory-export.png)

Films stay in your configured output storage: `./output` with the release Compose file,
a Docker volume with the stack-editor setup, or `~/Videos/Memories` on a native install.
A successful upload to Immich removes the local copy; leave upload off to keep it here.

## While it works

The progress panel lists the phases of preparation, cut and render, with an estimate of the time
left once it has something to measure (a first run may not). Reloading the browser does not cancel
work. Return to **Memory** for an active cut or **Runs** for a saved cut or render.

![A cut in progress: Prepare pictures running with its estimate, Select pictures pending, 57 of 1131 pictures read, the first previews, and Cancel](https://sam-dumont.github.io/immich-memories/img/screenshots/first-film-progress.png)

Use **Cancel** to stop a job. For a failure or interrupted run, see
[film progress and recovery](https://sam-dumont.github.io/immich-memories/docs/run/film-progress.md); prepared pictures stay cached.

One bad source doesn't sink the film. A picture whose preview Immich no longer has, or a clip
that won't decode, drops out and the run's warnings name it; a Live Photo whose motion fails
plays as its still. On Full, a reader that stops answering leaves the cut to the rules.

## Your next film

Choose **Monthly Highlights**, a year and a month. A larger period needs more preparation.
Set [home and people](https://sam-dumont.github.io/immich-memories/docs/get-started/who-is-who.md) for trips and family films, or follow
[After install](https://sam-dumont.github.io/immich-memories/docs/get-started/after-install.md) for backups and automatic films.

### Using the CLI

[CLI generation](https://sam-dumont.github.io/immich-memories/docs/make/cli/generate.md) covers albums, saved cuts and rendering.

### Portrait or landscape

The app follows the orientation of the selected pictures. To choose it yourself, use the
[format settings](https://sam-dumont.github.io/immich-memories/docs/make/titles-maps-music.md).
