From 352ba163cad9917e7505c4518085ce25e17fae08 Mon Sep 17 00:00:00 2001
From: hbrain <hbrain@piagent.local>
Date: Mon, 25 May 2026 00:50:41 +0000
Subject: [PATCH] Update README for current behavior

---
 README.md | 20 ++++++++++++++++----
 1 file changed, 16 insertions(+), 4 deletions(-)

diff --git a/README.md b/README.md
index d29f2a2..14fbaa9 100644
--- a/README.md
+++ b/README.md
@@ -23,7 +23,7 @@ sudo apt install ffmpeg
 The default title/stamp styling uses these fonts:
 
 - Bebas Neue for the opening title, date, and location
-- Inter for the bottom-left and bottom-right stamps
+- Inter for the bottom-left/bottom-right stamps and per-file captions
 
 Both fonts support common Danish and Croatian characters such as `æ ø å Æ Ø Å č ć ž š đ Č Ć Ž Š Đ`.
 
@@ -130,11 +130,19 @@ python3 movmaker.py input \
   --image-duration 6 \
   --fade 3 \
   --audio-fade 10 \
+  --audio-fade-in 2 \
+  --video-fade 1.5 \
   --first-transition-at 12 \
   --resolution 1920x1080 \
   --fps 30
 ```
 
+Fast preview render:
+
+```bash
+python3 movmaker.py input --preview
+```
+
 ## Current behavior
 
 - scans one flat input directory
@@ -144,9 +152,13 @@ python3 movmaker.py input \
 - includes video clips inline
 - crossfades between media items over 3 seconds by default
 - loops/trims music to match the video
-- fades music in at the beginning and out at the end over 10 seconds by default
-- overlays the opening title for the first 6 seconds: large bold title, then smaller non-bold date/location on one line
-- adds persistent bottom-left title/date/place and bottom-right `marijo@novosel.dk` stamps
+- fades music in over 2 seconds and out over 10 seconds by default
+- fades video in/out over 1.5 seconds by default
+- overlays the opening title for the first 6 seconds: large title, then date/location on one line
+- displays optional per-file captions at bottom center; use `|` to split caption lines
+- adds persistent bottom-left title/date/place and bottom-right `@bubulescu` stamps
+- writes safe ASCII text in rendered overlays and metadata, so special letters become readable equivalents like `Č` -> `C`, `å` -> `a`, `ø` -> `o`
+- embeds MP4 metadata: title, date, location, artist, comment, and creation_time
 - writes an MP4 file named like `YYYYMMDD_title.mp4` by default
 - takes `YYYYMMDD` from the first picture/video metadata, falling back to file modification date
 - uses local `ffmpeg/ffmpeg` and `ffmpeg/ffprobe` when present, otherwise system tools