| 1234567891011121314151617181920212223242526272829303132333435363738394041424344454647484950515253545556575859606162636465666768697071727374757677787980 |
- #!/usr/bin/env bash
- # scrollcraft: encode a clip for scrubbing, not for playback.
- #
- # A normal web encode puts a keyframe every 2-5 seconds. Scrubbing seeks to an
- # arbitrary time, and the decoder must walk from the previous keyframe to get
- # there, so a sparse-GOP file feels like mud under the wheel while playing back
- # perfectly. Dense keyframes cost file size and buy responsiveness. That trade
- # is the entire point of this script.
- #
- # ./encode.sh in.mp4 out.mp4 desktop master (1080p, -g 8, crf 20)
- # ./encode.sh in.mp4 out-m.mp4 mobile phone variant (720p, -g 4, crf 24)
- #
- # CRF override, for the grain-heavy worlds assets.md warns about (marine snow,
- # bioluminescence, smoke, film grain). A dense GOP doubles the cost of grain, so
- # a world like that wants 22-23 rather than the default 20:
- #
- # ./encode.sh in.mp4 out.mp4 desktop 23 fourth positional argument
- # SCROLLCRAFT_CRF=23 ./encode.sh in.mp4 out.mp4 or the env var
- #
- # The positional argument wins over the env var; with neither, the defaults
- # below are unchanged.
- #
- # Audio is stripped: these clips are scrubbed, never played, and a muted track
- # is dead weight plus an autoplay-policy hazard.
- set -euo pipefail
- # Resolve a FULL ffmpeg build. Several toolchains (Remotion, some Electron apps)
- # put a stripped ffmpeg on PATH that carries maybe 50 filters and silently lacks
- # scale/fps/tile. It fails with "No option name near ..." on any filter chain,
- # which reads like a syntax error in your command rather than a missing filter.
- # Count the filters and go looking for a real build if the count is low.
- pick_ffmpeg() {
- local cand
- for cand in \
- "${SCROLLCRAFT_FFMPEG:-}" \
- "$(command -v ffmpeg 2>/dev/null || true)" \
- "${HOME:-/nonexistent}"/AppData/Local/Microsoft/WinGet/Packages/Gyan.FFmpeg_*/ffmpeg-*-full_build/bin/ffmpeg.exe \
- /usr/local/bin/ffmpeg /opt/homebrew/bin/ffmpeg /usr/bin/ffmpeg /snap/bin/ffmpeg
- do
- [ -n "$cand" ] && [ -x "$cand" ] || continue
- if [ "$("$cand" -hide_banner -filters 2>/dev/null | wc -l)" -gt 200 ]; then
- echo "$cand"; return 0
- fi
- done
- echo "ERROR: no full ffmpeg build found. Set SCROLLCRAFT_FFMPEG to one." >&2
- return 1
- }
- FFMPEG="$(pick_ffmpeg)"
- FFPROBE="$(dirname "$FFMPEG")/ffprobe"
- [ -x "$FFPROBE" ] || FFPROBE="$(command -v ffprobe)"
- IN="${1:?usage: encode.sh <in> <out> [mobile|desktop] [crf]}"
- OUT="${2:?usage: encode.sh <in> <out> [mobile|desktop] [crf]}"
- MODE="${3:-desktop}"
- if [ "$MODE" = "mobile" ]; then
- SCALE="scale=-2:720"; GOP=4; CRF=24
- else
- SCALE="scale=-2:1080"; GOP=8; CRF=20
- fi
- # Positional beats env var beats the mode default.
- CRF="${4:-${SCROLLCRAFT_CRF:-$CRF}}"
- case "$CRF" in
- ''|*[!0-9]*) echo "ERROR: crf must be an integer, got '$CRF'" >&2; exit 1 ;;
- esac
- mkdir -p "$(dirname "$OUT")"
- "$FFMPEG" -y -hide_banner -loglevel error -i "$IN" \
- -an \
- -vf "${SCALE}:flags=lanczos,format=yuv420p" \
- -c:v libx264 -profile:v high -preset slow -crf "$CRF" \
- -g "$GOP" -keyint_min "$GOP" -sc_threshold 0 \
- -movflags +faststart \
- "$OUT"
- SIZE=$(du -h "$OUT" | cut -f1)
- DUR=$("$FFPROBE" -v error -show_entries format=duration -of csv=p=0 "$OUT")
- echo "$OUT ${SIZE} ${DUR}s gop=${GOP} crf=${CRF}"
|