Skip to main content

titles

Title screens are the intro cards, month dividers, and ending screens that get inserted into your generated videos. The titles command group lets you preview styles and manage fonts.

titles test

Generate a standalone title screen to preview how it looks before committing to a full video generation.

immich-memories titles test [OPTIONS]
FlagShortTypeDefaultDescription
--year-yintcurrent yearYear to display
--birthday-ageintAge for birthday title (e.g., 1 for "1st Year")
--person-pstringPerson name for subtitle
--month-mintMonth number 1-12 (for month divider)
--typechoicetitletitle, month, or ending
--orientation-ochoicelandscapelandscape, portrait, square
--resolution-rchoice1080p720p, 1080p, 4k
--locale-lchoiceenen or fr
--style-schoicerandommodern_warm, elegant_minimal, vintage_charm, playful_bright, soft_romantic, random
--output-Opath./title_screen_preview.mp4Output file
--download-fontsflagDownload fonts before generating
--no-animated-backgroundflagUse static gradient instead of animation

Examples:

# Simple year title
immich-memories titles test --year 2024

# Birthday title for a person
immich-memories titles test --birthday-age 2 --person "Emma" --year 2024

# Month divider
immich-memories titles test --month 6 --year 2024 --type month

# Portrait for social media
immich-memories titles test --year 2024 --orientation portrait

# French locale with vintage style
immich-memories titles test --year 2024 --locale fr --style vintage_charm

titles fonts

Manage the fonts used for title screens. Fonts are OFL-licensed from Google Fonts and cached locally in ~/.immich-memories/fonts/.

# List available fonts and their status
immich-memories titles fonts

# Download all fonts
immich-memories titles fonts --download

# Clear the font cache
immich-memories titles fonts --clear

If you haven't downloaded fonts yet, title generation will still work: it'll just use whatever's available on your system. But the downloaded fonts look better.