From de7c4b6c960196a5f1ab565750ca70d42bd5b7d8 Mon Sep 17 00:00:00 2001
From: Bartal Laearsson <bartal@flo.fo>
Date: Thu, 27 Aug 2026 11:09:50 +0100
Subject: [PATCH] add gif recorder to readme.md method

---
 tools/FILM-GIFS-FOR-README.md | 22 ++++++++++++++++++++++
 1 file changed, 22 insertions(+)
 create mode 100644 tools/FILM-GIFS-FOR-README.md

diff --git a/tools/FILM-GIFS-FOR-README.md b/tools/FILM-GIFS-FOR-README.md
new file mode 100644
index 0000000..e0b9f14
--- /dev/null
+++ b/tools/FILM-GIFS-FOR-README.md
@@ -0,0 +1,22 @@
+# Record GIFs for README.md files
+
+On Fedora I use [wf-recorder](https://github.com/ammen99/wf-recorder) for recording screen to mp4, and [ffmpeg](https://www.ffmpeg.org/about.html) for post processing to .gif.
+
+```bash
+wf-recorder -g "$(slurp)" \
+  -f <MP4-FILE-NAME>.mp4 \
+  -c libx264 \
+  -r 30 \
+  -p crf=18 \
+  -p preset=slow
+```
+
+like something like this
+```bash
+ ffmpeg -i hagfish.mp4 \
+  -vf "fps=15,scale=920:-1:flags=lanczos,split[s0][s1];[s0]palettegen=max_colors=256:stats_mode=diff[p];[s1][p]paletteuse=dither=sierra2_4a" \
+  -loop 0 \
+  hagfish.gif
+```
+
+keep the scale at 920, I think it looks good on Gitea and probably GitHub