Spaghetti Lab - Replay Analyzer
Learn about Spaghetti Lab, the replay analysis tool with desktop and web versions for .spag and .spagz files, notes, and drawing annotations.
## Analyze and Annotate Your Fighting Game Replays
Spaghetti Lab is the dedicated replay analysis tool built by Spaghetti Showdown. Available as both a desktop application and a web-based analyzer, Spaghetti Lab lets you open replay files, add detailed notes and drawings, and share your analysis with coaches, training partners, or the broader community.
### Desktop App vs Web Analyzer
Spaghetti Lab comes in two versions:
**Desktop Application:**
- Available for Windows and macOS
- Runs natively for the best performance
- Can open local video files directly from your hard drive
- Supports larger file sizes without browser memory limitations
- Includes advanced frame-by-frame analysis tools
**Web Analyzer:**
- Runs entirely in your browser — no installation required
- Access it from the Tools section on Spaghetti Showdown
- Supports YouTube and Twitch video embedding
- Perfect for quick reviews and sharing via URL
- Integrated directly with the coaching and replay review systems
Both versions use the same **.spag** and **.spagz** file formats, so annotations created in one can be opened in the other seamlessly.
### Opening .spag and .spagz Files
Spaghetti Lab uses two proprietary file formats:
- **.spag** — A replay data file that stores match information, inputs, and metadata. These files are typically exported from supported games or recorded through the platform.
- **.spagz** — An annotation file that layers notes, drawings, and timestamps on top of a video or .spag file. This is the format produced when you annotate a replay.
To open a file, click **Open File** in Spaghetti Lab and select your .spag or .spagz file. The desktop app also supports drag-and-drop — simply drag the file into the application window.
### Adding Notes
The notes system lets you attach detailed commentary to specific moments in the replay:
- **Click on the timeline** at any point to create a new note
- **Write your analysis** — describe what happened, what could have been done differently, and what to practice
- **Tag your notes** with categories like Punish Opportunity, Spacing Error, Good Decision to organize your analysis
- **Link notes together** to show cause-and-effect sequences
Notes are displayed alongside the video and can be navigated with keyboard shortcuts for efficient review.
### Drawing on Frames
Pause at any frame and use the drawing tools to illustrate your points:
- **Freehand drawing** for quick sketches and markups
- **Arrow tool** for indicating movement direction, attack trajectories, or spacing adjustments
- **Shape tools** for highlighting areas of the screen — hitboxes, safe zones, or positioning references
- **Text overlay** for labeling elements directly on the frame
- **Color picker** with preset colors for consistent annotation styles
Drawings are saved with their timestamps, so they appear and disappear at the correct moments during playback.
### Sharing Your Analysis
Once your analysis is complete, you can share it in several ways:
- **Export as .spagz** to share the full interactive annotation
- **Generate a shareable link** (web version) that anyone can view in their browser
- **Attach to a coaching review** if you are analyzing a student replay
- **Download as PDF** for a static summary of your notes and key frames
Spaghetti Lab turns casual replay watching into a structured, productive study session.
📸 Screenshot placeholder
The Spaghetti Lab desktop application main screen
📸 Screenshot placeholder
Opening a .spagz annotation file in Spaghetti Lab