devlog

name: devlog description: Create TikTok/X short-form devlog videos - guides through capturing moments, scripting voice lines, recording, assembly, preview in Remotion Studio, and rendering

Devlog Video Creation Workflow

Create short-form video content for TikTok/X from gameplay captures.

Prerequisites

• OBS Studio with replay buffer configured
• Remotion installed: cd devlog/remotion && npm install
• Session created: ./devlog/bin/new-session.sh
• (Optional) Whisper for auto-ordering: pip install openai-whisper

SFX & Music Library

Primary: Eagle MCP (37,101 audio files!)

Library: /Volumes/AssetsEagle/Sound and Music.library

Search by text query:

mcp__eagle-mcp__item_query({ query: "whoosh transition" })
mcp__eagle-mcp__item_query({ query: "glitch error" })
mcp__eagle-mcp__item_query({ query: "pop notification" })

Browse folders:

mcp__eagle-mcp__folder_get({ getAllHierarchy: true })

Get items from specific folder:

mcp__eagle-mcp__item_get({ folders: ["FOLDER_ID"] })

Key folders for devlog:

Search queries for devlog content:

Fallback: Local Motion Fx Folder

If Eagle MCP is unavailable, use local folder:

Source Path: /Users/joshuashin/Projects/TexturePackerRepo/assets/Motion Fx Index: See sfx-index.md in this skill folder for full categorization. CLI: ./devlog/bin/list-sfx.sh search <term>

Quick SFX picks by use case:

The Workflow

Phase 1: Capture (Always-On)

Ensure OBS replay buffer is running during development:

• Start buffer: Cmd+F9
• Save moment: Cmd+F10 (saves last 5 minutes)
• Clips save to: devlog/sessions/raw/

Phase 2: Script Voice Lines

When user describes a captured moment:

1. Understand the moment - Ask what happened, why it's interesting
2. Suggest 3-5 voice lines - Short bursts (5-10 seconds each)
   • Hook line first ("So I found a bug...")
   • Description/context
   • The turn/realization
   • Conclusion/payoff
3. Present via review skill - Always use /review to show voice lines
4. Iterate - Adjust based on feedback until approved

Example voice line structure:

line_01: "So I found a bug in my game..."     (hook)
line_02: "Look at this."                       (show)
line_03: "But honestly? It looks kinda cool."  (turn)
line_04: "I think I'm keeping it."             (payoff)

Phase 3: Record Voice Lines

Option A: Record Freely + Auto-Order (Recommended)

Just record all lines naturally, then let Claude match them to the script:

# 1. User records however they want (multiple files, any order)
#    Save to: devlog/sessions/YYYY-MM-DD/raw-voice/

# 2. Claude creates script file from approved voice lines
cat > /tmp/script.txt << 'EOF'
So I found a bug in my game...
Look at this glitch.
But honestly? It looks kinda cool.
I think I'm keeping it.
EOF

# 3. Auto-order (uses whisper if available, else Claude reviews manually)
./devlog/bin/order-audio.sh ./raw-voice/ /tmp/script.txt ./voice/

# 4. Review mapping, then apply:
python3 devlog/bin/apply-audio-mapping.py ./raw-voice/audio_mapping.json ./raw-voice/ ./voice/

# 5. Process:
./devlog/bin/process-voice.sh --all

Option B: Single Recording + Split

Record all lines in one take with pauses:

./devlog/bin/split-audio.sh recording.wav devlog/sessions/YYYY-MM-DD/voice/
./devlog/bin/process-voice.sh --all

Option C: Guided Prompts

./devlog/bin/record-voice-batch.sh /tmp/voice-lines.txt
./devlog/bin/process-voice.sh --all

Option D: Individual Recording

./devlog/bin/record-voice.sh line_01
./devlog/bin/record-voice.sh line_02
./devlog/bin/process-voice.sh --all

Phase 4: Assemble Video

Create the manifest mapping voice lines to video clips:

1. Check available clips: ls devlog/sessions/raw/
2. Get clip durations: ffprobe -v error -show_entries format=duration -of default=noprint_wrappers=1:nokey=1 <clip>
3. Suggest SFX from devlog/sfx/ based on content
4. Create manifest at devlog/sessions/YYYY-MM-DD/meta/<name>.json
5. Present manifest via review skill for approval

Manifest structure:

{
  "fps": 30,
  "segments": [
    {
      "voice": "../voice/line_01_processed.wav",
      "media": "../../raw/replay_001.mp4",
      "mediaStartTime": 0,
      "duration": 3.0,
      "subtitle": "So I found a bug...",
      "sfx": "/path/to/sfx.wav",
      "sfxVolume": 0.5,
      "sfxOffset": 0.3,
      "transition": "fade",
      "kenBurns": "zoom-in",
      "textAnimation": "pop"
    }
  ],
  "style": {
    "subtitlePosition": "bottom",
    "showSubtitles": true,
    "accentColor": "#6366f1"
  },
  "upload": {
    "caption": "Caption here\n\n#gamedev #indiedev",
    "platforms": ["tiktok", "x"]
  }
}

Transitions & Effects Reference

Media Transitions (transition field) - how segment enters:

Ken Burns (kenBurns field) - camera motion during segment:

Text Animation (textAnimation field) - subtitle style:

Recommended combos for variety:

• Hook: transition: "fade" + kenBurns: "zoom-in" + textAnimation: "pop"
• Reveal: transition: "zoom-in" + kenBurns: "zoom-out" + textAnimation: "slide-up"
• Comedy: transition: "slide-left" + kenBurns: "pan-right" + textAnimation: "wave"
• Punchline: transition: "blur" + kenBurns: "pan-left" + textAnimation: "pop"

Phase 5: Preview in Remotion Studio

Always preview before rendering:

./devlog/bin/preview.sh devlog/sessions/YYYY-MM-DD/meta/<name>.json

This opens Remotion Studio where user can:

• Preview the full video
• Adjust segment timings
• Check subtitle sync
• Verify SFX placement

When satisfied, close Studio (Ctrl+C) and proceed to render.

Phase 6: Render

After preview approval:

./devlog/bin/render.sh devlog/sessions/YYYY-MM-DD/meta/<name>.json

Output goes to: devlog/sessions/YYYY-MM-DD/out/<name>.mp4

Phase 7: Upload

./devlog/bin/upload-helper.sh devlog/sessions/YYYY-MM-DD/meta/<name>.json

This:

• Opens TikTok and X upload pages
• Copies caption to clipboard
• Opens video in Finder

Remind user to add TikTok trending sound!

Key Commands

Audio Selection Strategy

Step 1: Use Eagle MCP (preferred - 37K+ sounds)

mcp__eagle-mcp__item_query({ query: "search terms" })
→ Returns items with filePath field
→ Use filePath directly in manifest sfx field

Step 2: Auto-Selection by Content

When assembling manifest, search Eagle and pick first good match:

Fallback: If Eagle MCP unavailable, use local folder: /Users/joshuashin/Projects/TexturePackerRepo/assets/Motion Fx

Important Notes

• Always preview before render - Use preview.sh to open Remotion Studio
• Always use review skill to present voice lines and manifests
• Video files with spaces in names need re-encoding before Remotion
• Multiple clips can be combined - each segment can reference different media
• Caption copied to clipboard after render completes

Content Tips

• Hook in first 3 seconds
• Mention it's YOUR game early
• Tell stories, not features
• Target 30-60 seconds total
• Add SFX sparingly - enhance, don't overwhelm