@@ -1039,6 +1039,51 @@ cargo update
10391039- ** rustfmt** : Code formatter: ` cargo fmt `
10401040- ** cargo-expand** : View macro expansions: ` cargo expand `
10411041
1042+ ## Video Demo
1043+
1044+ Convert screen recording (mp4) to AVIF for README using SVT-AV1 (fast, good quality):
1045+
1046+ ``` bash
1047+ ffmpeg -i input.mp4 -c:v libsvtav1 -vf scale=-1:720 -crf 30 demo.avif
1048+ ```
1049+
1050+ - ` libsvtav1 ` is 10-50x faster than ` libaom-av1 `
1051+ - ` -crf 30 ` balances quality/size (lower = better quality, larger file)
1052+ - Scale to 720p height for reasonable file size
1053+
1054+ ### Video Frame Extraction for Debugging
1055+
1056+ Extract frames from screen recordings (MP4/MOV) for debugging UI issues:
1057+
1058+ ``` bash
1059+ # High-quality PNG frames at source resolution
1060+ ffmpeg -i video.mp4 -vf " fps=15" /tmp/frames/frame_%03d.png
1061+
1062+ # With downscaling for large videos (720p height, maintain aspect)
1063+ ffmpeg -i video.mp4 -vf " fps=15,scale=-1:720" /tmp/frames/frame_%03d.png
1064+
1065+ # Extract specific time range (2s to 5s)
1066+ ffmpeg -i video.mp4 -ss 2 -to 5 -vf " fps=15" /tmp/frames/frame_%03d.png
1067+
1068+ # Maximum quality (lossless PNG, no frame skip)
1069+ ffmpeg -i video.mp4 -vf " fps=30" -compression_level 0 /tmp/frames/frame_%03d.png
1070+
1071+ # JPEG for smaller files (quality 2 = high, 31 = low)
1072+ ffmpeg -i video.mp4 -vf " fps=15" -qscale:v 2 /tmp/frames/frame_%03d.jpg
1073+ ```
1074+
1075+ ** Parameters:**
1076+ - ` fps=15 ` - Extract 15 frames per second (adjust based on video framerate)
1077+ - ` scale=-1:720 ` - Scale to 720p height, auto-calculate width
1078+ - ` -compression_level 0 ` - Fastest PNG encoding (larger files)
1079+ - ` -qscale:v 2 ` - JPEG quality (2=best, 31=worst)
1080+
1081+ ** Use cases:**
1082+ - Debugging spinner/loading issues
1083+ - Capturing exact UI state during animations
1084+ - Documenting visual bugs for reports
1085+
1086+
10421087<!-- BACKLOG.MD MCP GUIDELINES START -->
10431088
10441089<CRITICAL_INSTRUCTION>
@@ -1067,65 +1112,3 @@ You MUST read the overview resource to understand the complete workflow. The inf
10671112</CRITICAL_INSTRUCTION>
10681113
10691114<!-- BACKLOG.MD MCP GUIDELINES END -->
1070-
1071- <!-- MANTIC SEARCH GUIDELINES START -->
1072-
1073- <CRITICAL_INSTRUCTION>
1074-
1075- ## SEARCH CAPABILITY (MANTIC v1.0.21)
1076-
1077- This project uses Mantic for intelligent code search. Use it before resorting to grep/find commands.
1078-
1079- ** Basic Search:**
1080- ``` bash
1081- npx mantic.sh " your query here"
1082- ```
1083-
1084- ** Advanced Features:**
1085-
1086- ** Zero-Query Mode (Context Detection):**
1087- ``` bash
1088- npx mantic.sh " " # Shows modified files, suggestions, impact
1089- ```
1090-
1091- ** Context Carryover (Session Mode):**
1092- ``` bash
1093- npx mantic.sh " query" --session " session-name"
1094- ```
1095-
1096- ** Output Formats:**
1097- ``` bash
1098- npx mantic.sh " query" --json # Full metadata
1099- npx mantic.sh " query" --files # Paths only
1100- npx mantic.sh " query" --markdown # Pretty output
1101- ```
1102-
1103- ** Impact Analysis:**
1104- ``` bash
1105- npx mantic.sh " query" --impact # Shows blast radius
1106- ```
1107-
1108- ** File Type Filters:**
1109- ``` bash
1110- npx mantic.sh " query" --code # Code files only
1111- npx mantic.sh " query" --test # Test files only
1112- npx mantic.sh " query" --config # Config files only
1113- ```
1114-
1115- ### Search Quality (v1.0.21)
1116-
1117- - CamelCase detection: "ScriptController" finds script_controller.h
1118- - Exact filename matching: "download_manager.cc" returns exact file first
1119- - Path sequence: "blink renderer core dom" matches directory structure
1120- - Word boundaries: "script" won't match "javascript"
1121- - Directory boosting: "gpu" prioritizes files in gpu/ directories
1122-
1123- ### Best Practices
1124-
1125- ** DO NOT use grep/find blindly. Use Mantic first.**
1126-
1127- Mantic provides brain-inspired scoring that prioritizes business logic over boilerplate, making it more effective for finding relevant code than traditional text search tools.
1128-
1129- </CRITICAL_INSTRUCTION>
1130-
1131- <!-- MANTIC SEARCH GUIDELINES END -->
0 commit comments