gitwtfhub

wtf is unity-video-playtest?

enoch3712/unity-video-playtest — explained in plain English

Analysis updated 2026-05-18

0ShellAudience · developerComplexity · 3/5Setup · moderate

TL;DR

An AI agent skill that records Unity playtests as video and reports timestamped animation and motion bugs.

Mindmap

mindmap
  root((repo))
    What it does
      Records Unity playtests
      Extracts frames or plays video
      Reports timestamped bugs
    Tech stack
      Shell scripts
      ffmpeg
      Unity Recorder
    Use cases
      Catch animation glitches
      Debug camera issues
      Review combat timing
    Audience
      Unity developers
      AI agent users
    Hosts supported
      Codex
      Claude Code
      Cursor

Code map

Detail Auto

An interactive map of this repo's files and how they connect — its source is parsed live in your browser. Click Visualize to build it.

filefunction / class

Why would anyone build with this?

REASON 1

Record a Unity scene and have an AI agent flag animation glitches with timestamps.

REASON 2

Debug why a camera snaps or judders during gameplay.

REASON 3

Check whether UI feedback and transitions are firing on time.

REASON 4

Review combat sequencing and particle timing issues in a Unity game.

What's in the stack?

ShellffmpegUnity

How it stacks up

enoch3712/unity-video-playtest123satyajeet123/bitnet-serveradeilsonrbrito/cross-model-consult
Stars000
LanguageShellShellShell
Setup difficultymoderateeasymoderate
Complexity3/52/53/5
Audiencedeveloperdeveloperdeveloper

Figures from each repo's GitHub metadata at analysis time.

How do you spin it up?

Difficulty · moderate Time to first run · 30min

Requires ffmpeg installed plus a compatible agent host (Codex, Claude Code, or Cursor).

Wtf does this do

This project is an installable Agent Skill that helps AI coding assistants review animation and motion problems in Unity games. It works with Codex, Claude Code, and Cursor. Instead of relying only on screenshots, which can miss fast motion problems, it records an actual playtest as video and turns that recording into evidence an AI agent can inspect. When you ask the agent to use this skill, it records a specific Unity scene for a set number of seconds, such as watching a character's walk cycle. The skill then checks whether the host AI tool can watch video directly. If it can, it plays the MP4 recording. If it cannot, the skill extracts frames instead, producing a contact sheet image plus a dense set of individual frames around the moment something looks wrong, at a rate of 12 to 30 frames per second. There is also an optional path for tools that already support a generic video watching skill. The output includes the recorded video file, a metadata file, the contact sheet image, a CSV of frame timestamps, and the individual extracted frames. A bundled script called inspect_video.sh can generate an overview of the recording or zoom into a specific time window at a chosen frame rate. The agent then reports findings with exact timestamps, for example noting that a character's sprite snapped forward by a specific number of pixels at a specific moment, and whether the Unity Console logged any related error. The README lists the kinds of problems this is meant to catch: frozen or misordered animation frames, sprite snapping, camera glitches, delayed UI feedback, mistimed particle effects, incorrect draw order during motion, and combat sequencing issues. It captures footage using the project's own camera recorder when available, falling back to Unity's built in Recorder, and finally to a macOS screen capture option if neither is available. The skill requires ffmpeg to be installed. This tool would suit Unity developers who use AI coding agents and want those agents to catch motion and timing bugs that plain screenshots would miss.

Yoink these prompts

Prompt 1
Use unity-video-playtest to record my AnimationShowcase scene for 15 seconds and report any glitches.
Prompt 2
Record this Unity fight scene and find out why the camera snaps during the enemy turn.
Prompt 3
Help me install this skill for Claude Code and set up ffmpeg for it.
Prompt 4
Explain how the frame-extraction fallback works when my agent can't watch video directly.

Frequently asked questions

wtf is unity-video-playtest?

An AI agent skill that records Unity playtests as video and reports timestamped animation and motion bugs.

What language is unity-video-playtest written in?

Mainly Shell. The stack also includes Shell, ffmpeg, Unity.

How hard is unity-video-playtest to set up?

Setup difficulty is rated moderate, with roughly 30min to a first successful run.

Who is unity-video-playtest for?

Mainly developer.

View the repo → Decode another repo

This repo across BitVibe Labs

Don't trust strangers blindly. Verify against the repo.