Skip to main content
A browser extension for downloading Twitch VODs, recording live streams, and replaying chat. All processing happens locally in your browser with no server uploads required.

​
Features

​
VOD Downloads

  • Download full VODs - Save entire broadcasts in one click
  • Custom time ranges - Clip specific segments with precise start/end times
  • Unpublished VOD discovery - Find and download VODs that streamers haven’t made public yet
  • Multiple formats - Export as MP4, MKV, TS, or MP3 (audio only)
  • Quality selection - Choose from Source, 1080p, 720p, 480p, 360p, or Audio Only
  • Download queue - Queue multiple downloads and track progress

​
Live Stream Recording

  • Rolling buffer - Continuously buffers the last 10 minutes to 5 hours of a live stream
  • Create clips - Save specific moments from the buffer (up to 30 minutes)
  • Save full buffer - Download the entire buffer when the stream ends
  • Ad-free playback - Streams played through the extension bypass ad insertion

​
Chat Replay

  • Synchronized chat - View historical chat messages alongside VOD playback
  • Floating overlay - Draggable, resizable chat window that works in fullscreen
  • Customizable appearance - Adjust colors, opacity, font size, and message limits
  • Standalone mode - Use chat overlay with Twitch’s native player

​
Live Chat New in v2.0

  • Send messages - Chat in live streams directly from the overlay
  • Emote picker - Browse channel, global, and subscriber emotes with search
  • @Mention autocomplete - Type @ to autocomplete usernames from recent chat
  • Follow button - Follow channels directly from follower-only chat notices
  • Room state indicators - See slow mode, sub-only, follower-only, and emote-only restrictions

​
Mini Player

  • Picture-in-Picture - Continue watching in a floating window while browsing
  • Drag and resize - Position the player anywhere on screen
  • Persists across pages - Mini player stays open as you navigate Twitch
  • Audio visualizer - Visual feedback when playing audio-only streams

​
Installation

1

Visit Chrome Web Store

Go to the Battles Replay listing
2

Click Add to Chrome

Install the extension and grant required permissions
3

Start Using

Navigate to any Twitch channel or VOD page

​
How to Use

​
Downloading VODs

1

Open a Twitch channel

Navigate to any channel page or VOD on Twitch
2

Click the Battles button

Find the Battles button to the left of the search bar on Twitch
3

Browse and select a VOD

Use the search or browse the channel’s VOD library, including unpublished streams
4

Set your options

Choose quality, format, and optionally set a custom time range
5

Download

Click download and wait for processing to complete in your browser

​
Recording Live Streams

1

Open a live channel

Navigate to a channel that’s currently streaming
2

Open Battles Replay

The extension will detect the live stream automatically
3

Watch and buffer

The stream buffers continuously in the background (configurable duration)
4

Create clips or save buffer

Use the clip tool for specific moments, or save the entire buffer

​
Twitch Authentication New in v2.0

Connect your Twitch account to unlock interactive chat features:
1

Open Settings

Click the gear icon in the extension
2

Click Connect with Twitch

Authorize the extension to access your Twitch account
3

Start Chatting

Live chat features are now available

​
What’s Enabled

FeatureDescription
Send messagesChat in live streams from the overlay
Emote pickerAccess your subscribed emotes
Follow channelsFollow directly from follower-only notices
@MentionsAutocomplete usernames when typing @
OAuth tokens are stored securely in the extension’s sandboxed storage and never transmitted externally.

​
Authorization

API keys are not required for core functionality. Adding them enables enhanced features like badge images and additional metadata.
The Authorization section in Settings allows you to configure optional API keys:

​
Twitch User Access Token

An OAuth token for accessing the Twitch Helix API. This enables:
  • Full badge images in chat replay (instead of letter abbreviations)
  • Additional user metadata
You can either connect with Twitch (recommended) or manually provide a token with the appropriate scopes.

​
TeamBattles API Key

Uses your linked Twitch account for authenticated API requests to TeamBattles services.
Quick setup with presets: In Developer Settings, click Create API Key and select the Battles Replay preset. This automatically configures the correct permissions (Matches: Read, Twitch: Enabled) with one click.
To create an API key manually:
1

Go to Developer Settings

Navigate to Settings → Developer
2

Click Create API Key

Enter a label like “Battles Replay Extension”
3

Set Permissions

  • Matches → User Matches: Read
  • Connections → Twitch: Enabled
4

Copy Your Key

Copy the generated key immediately - it won’t be shown again
5

Paste in Extension

Open the extension settings and paste your API key in the Authorization section
Your keys are stored in the extension’s sandboxed storage and are never shared or transmitted externally.

​
Download Formats

Choose the output format based on your needs:
FormatBest ForNotes
MP4General useUniversal compatibility, works everywhere
MKVArchivingBetter metadata support, same quality as MP4
TSLarge filesNo processing needed, fastest download, plays in VLC
MP3Audio onlyExtracts and encodes audio track
For downloads over 1.2 GB, TS format is recommended. It uses minimal memory and creates a single file regardless of size.

​
Large Downloads

Downloads estimated over 1.2 GB trigger a special prompt with format options:
  • TS (recommended) - Single file, binary concatenation, minimal memory usage (~50 MB peak)
  • MP4/MKV - Split into multiple part files (configurable chunk size: 500 MB - 1.7 GB)
Downloads over 30 GB are blocked to prevent browser memory issues.

​
Configuring Chunk Size

In Settings, you can adjust the chunk size for large MP4/MKV downloads:
  • Range: 500 MB - 1700 MB
  • Default: 1000 MB (1 GB)
  • Warning: Values above 1200 MB may cause memory issues

​
Chat Replay

Chat replay displays historical chat messages synchronized with VOD playback.

​
Features

  • Draggable overlay - Position anywhere on screen
  • Resizable - Adjust width (280-600px) and height (200-800px)
  • Auto-scroll - Automatically scrolls to new messages
  • Fullscreen support - Chat overlay works in fullscreen mode

​
Customization Options

Access chat settings via the gear icon in the overlay header:
SettingDescriptionDefault
TimestampsShow VOD offset time per messageOff
BadgesDisplay user badgesOn
Fade when idleHide UI elements when not hoveringOff
Background colorOverlay background#18181B
Text colorMessage text color#FAFAFA
OpacityOverlay transparency90%
Font sizeMessage text size14px
Max messagesMaximum messages displayed200

​
Limitations

  • Chat replay is only available for published VODs (Twitch doesn’t retain chat for deleted/unpublished streams)
  • Sending messages only available for live streams (VOD chat is read-only)

​
Settings

Configure the extension behavior in the Settings tab:
SettingDescriptionDefault
Auto mini playerEnter PiP when closing modal while playingOff
Chunk sizePart size for large MP4/MKV downloads1000 MB
Buffer durationRolling buffer for live streams30 min
Auto-download bufferSave buffer when stream endsOff
Twitch player buttonInject chat button into native playerOn
Twitch connectionConnect your Twitch account for live chatNot connected

​
Privacy

No personal data collected. All video processing happens locally in your browser. Downloaded content is saved directly to your device. View Privacy Policy

​
Requirements

  • Chrome 121+ or Firefox 112+
  • Internet connection for streaming and downloading
  • Sufficient disk space for downloaded videos
  • For large downloads: adequate available RAM (TS format uses minimal memory)

​
Changelog

​
Added

  • Twitch OAuth Authentication - Connect with Twitch for authenticated features
  • Live Chat Sending - Send messages in live chat overlays with room state indicators
  • Emote Picker - Browse channel, global, and subscriber emotes with search
  • @Mention Autocomplete - Type @ to autocomplete usernames from recent chat
  • Follow Button - Follow channels directly from follower-only chat notices

​
Changed

  • Updated extension description to better reflect full feature set
  • Follower-only chat indicator now clearer and more compact

​
Fixed

  • Firefox OAuth authentication now works correctly
  • Badge API 401 errors when authenticated via OAuth

​
Added

  • Badge Images - Displays actual Twitch badge images when API credentials configured
  • Live Stream Recording - Rolling buffer (5-120 min), clips, buffer save, stream end detection
  • Native Chat Overlay - Live chat on native Twitch player for fullscreen/theater mode
  • Reply indicators and action message styling in live chat
  • Authorization settings for optional API keys

​
Fixed

  • Standalone and modal chat overlays no longer overlap
  • Channel and subscriber emotes now render in live chat
  • Live buffer save handles fMP4 segments correctly

​
Added

  • IndexedDB Segment Storage - Crash recovery with 48-hour auto-cleanup
  • Large File Support (up to 30 GB) - Format selection, chunked downloads
  • TS Format Option - Fast binary concatenation, minimal memory
  • Configurable Chunk Size - 500 MB to 1.7 GB

​
Changed

  • Segments persist to disk instead of RAM
  • Dramatically reduced memory usage

​
Added

  • Memory Usage Display - Global and per-download indicators with color coding

​
Changed

  • Reduced peak memory usage during merge by ~50%
  • Merge progress shows percentage

​
Added

  • Standalone Chat Overlay - Use with Twitch’s native player
  • Text color setting for chat overlay
  • Fullscreen support for standalone chat

​
Added

  • Chat Replay Overlay - Synchronized, draggable, resizable
  • Inline Chat Settings - Timestamps, badges, colors, opacity, font size
  • Pre-fetches messages 30 seconds ahead

​
Added

  • Picture-in-Picture Mini Player - Floating player that persists across navigation
  • Vertical volume slider
  • Settings tab with auto-PiP toggle
  • Volume persistence across sessions

​
Added

  • Firefox Browser Support (MV3)
  • Separate builds for Chrome and Firefox

​
Added

  • Support button linking to Ko-fi
  • Compact channel card with follower count and join date

​
Added

  • Audio Visualizer - 6 types: Bars, Wave, Mirrored, Mountain, Circular, Dots

​
Fixed

  • Audio Only quality now appears in dropdown
  • Modal close pauses playback
Initial release of Battles Replay.

​
Core Features

  • Channel search with smart input detection
  • VOD browsing with thumbnail grid and pagination
  • Unpublished VOD discovery via SullyGnome
  • HLS player with quality selection
  • Time range selection for partial downloads
  • Download queue with pause/resume/prioritize
  • FFmpeg.wasm for MP4 remuxing
  • Copy M3U8 URL for external players