Skip to main content

Monthly, Person, Season & On This Day

Four memory types that share a similar structure: pick a time range, optionally filter by person, generate. They differ in scope and scoring emphasis.

Monthly Highlights

Best moments from a single month. Good for regular check-ins or when one month had a lot going on.

immich-memories generate --memory-type monthly_highlights --month 7 --year 2025

Default duration: 60 seconds. The title screen shows the month and year (e.g., "July 2025"). No monthly dividers since it's already a single month.

Best for: months with 10+ videos. If you shot a lot in one month (vacation, birthday party, holiday), this gives you a tight one-minute highlight.

Monthly Highlights presetMonthly Highlights preset

Person Spotlight

A year focused on one person. Filters clips to only those containing the named person (requires face recognition enabled in Immich). Scoring weights faces higher than usual (60% face weight vs the default 30%).

immich-memories generate --memory-type person_spotlight --person "Alice" --year 2025

Narrow to a single month with --month:

immich-memories generate --memory-type person_spotlight --person "Alice" --year 2025 --month 7

Use birthday-based year (auto-detects from Immich):

immich-memories generate --memory-type person_spotlight --person "Alice" --year 2025 --birthday

Default duration: 120 seconds (full year), ~60 seconds (single month). Duration auto-scales with date range. You can also override the date range entirely with --start/--end.

Best for: parent-child compilations, partner videos, or any relationship where you want to see just that person's moments. Needs Immich face recognition to be set up and the person tagged.

Person Spotlight presetPerson Spotlight preset

Multi-Person

Moments featuring multiple people together. By default, requires co-occurrence: clips must contain all named people in the same frame.

immich-memories generate --memory-type multi_person --person "Alice" --person "Bob" --year 2025

Default duration: 300 seconds. Title screen shows "Alice & Bob" as the subtitle.

Best for: couples, families, friend groups. The co-occurrence filter means you'll get clips where they're actually together, not separate appearances.

Season

Highlights from a specific season (spring, summer, fall, winter). Scoring emphasizes motion slightly more (35% motion weight) to favor outdoor activities.

immich-memories generate --memory-type season --season summer --year 2025

Default duration: 135 seconds (~45 seconds per month of the season). The hemisphere flag controls which calendar months map to which season:

# Southern hemisphere: summer = December-February
immich-memories generate --memory-type season --season summer --year 2025 --hemisphere south

Best for: when the best content clusters in a season rather than spread across the year. Summer vacations, winter holidays, fall foliage trips.

On This Day

Looks back across all previous years for content near today's date. Creates ±1 day date ranges for each previous year.

immich-memories generate --memory-type on_this_day

Limit to the last 3 years with --years-back:

immich-memories generate --memory-type on_this_day --years-back 3

Default duration: 45 seconds. No --year needed: it automatically looks back from today's date. By default, it searches all years with data (up to 30 years back).

Best for: daily nostalgia, "what were we doing last year" moments. Works best if you've been shooting video for 3+ years. Can be combined with the scheduler for an automatic daily memory.