OBS Lua Instant Replay VLC Instant Replay VLC v1.2 – Session Folders & Tags

Description​

This script extends the classic Instant Replay workflow by adding replay history, navigation hotkeys, and clean single-file VLC playback. Save a replay, browse previous clips, jump straight to the latest one, and optionally archive replays into a timestamped folder, all without stacking endless clips inside VLC.

Based on the original instant-replay.lua script by Jim and Exeldro. Extended and modified by DHGaming (softSinStudios)

---

Changelog​

v1.2​

• Added optional session folders for copied replays
  
  • Replays can be organized by stream name and session start time
  • Disabled by default to preserve existing workflows
• Added tag-based replay saving (up to 6 tags)
  
  • Each tag uses its own hotkey and filename prefix
  • Tag numbering is derived by scanning existing files, ensuring correct increments across restarts
• Improved path handling and file detection for increased reliability
• Maintained clean single-file VLC playback behavior
• No changes to default behavior when new features are not enabled

---

v1.1​

• Added user-defined stream name for copied replay filenames
• Improved replay file naming clarity without changing core workflow

---

v1.0​

• Initial release
• Instant Replay support using OBS Replay Buffer and a VLC source
• Replay history with navigation hotkeys
• Single-file VLC playlist to prevent playback of old clips

---

Requirements​

• OBS Studio: tested with 32.0.4 (64-bit)
• Replay Buffer enabled in OBS
• VLC (64-bit) installed and registered in OBS
• A VLC Video Source in your replay scene

Note: You must use the 64-bit version of VLC. Double-check your VLC build if you run into errors. It’s also recommended that OBS is not running when you install VLC 64-bit.

Click to expand...

---

How To Use​

1) Create your Instant Replay scene

1. Add a VLC Video Source
2. Name it something like: InstantReplayVLC
3. Leave the playlist empty
4. Enable:
   • Restart playback when source becomes active
   • Close file when inactive

---

2) Load the script​

1. Go to Tools → Scripts
2. Click +
3. Select instant-replay-vlc.lua

---

3) Configure the script​

In the script properties:

• VLC Video Source: choose your replay VLC source
• (Optional) Replay Copy Folder: choose a folder to archive replays
• (Optional) Use copied file instead of original
• Adjust timing if needed (defaults are usually fine)

Note: The default folder for replays will be the same folder you chose for Recording.

Click to expand...

---

4) Set hotkeys​

Go to:

Settings → Hotkeys → Filter → VLC

Bind:

• Save Replay → F8
• Previous Replay → F9
• Next Replay → F10
• Latest Replay → F11
• (Optional) Clear playlist + history → Shift+F12

IMPORTANT: Do not assign a hotkey to Replay Buffer → Save Replay in OBS.
This script already triggers the replay save, and binding the built-in action will cause duplicate clips.

These are simply the keybindings I use. Feel free to choose your own.

Click to expand...

---

5) Workflow​

1. Turn on Replay Buffer in OBS
2. Press F8 whenever something happens you want saved
3. Use F9 / F10 to move backward/forward through replays
4. Use F11 to jump to the newest replay
5. Switch to your Replay Scene and it plays immediately

The VLC source will always contain only one clip, so you never accidentally play through a mountain of old replays.