OBS Lua Instant Replay VLC 1.4

This update focuses on reliability. The controls and basic workflow haven’t changed.

The script now waits for OBS to confirm a replay has been saved before processing it. File copying has also been reworked so it no longer loads the entire video into memory. If a copy fails, the script reports the problem and falls back to the original replay.

I’ve also tightened up handling for repeated Save presses, missing files, and clearing history while a replay is still processing. Previous and Next no longer reload the same clip when you reach either end of your history.

There’s a new Check Setup button and clearer status messages to help catch configuration problems before you go live.

Your existing hotkeys and settings are retained when updating the script in place. Close OBS, back up the old script, and replace it using the same filename and location. Don’t load both versions.

** Next update will include playback history import and handling **

Thanks to everyone who’s downloaded and used it: 2,486 downloads since January!

V1.3​

• Reverted to the v1.0 codebase as the stable release foundation
• Removed optional session folders for copied replays
• Removed stream-name and session-based replay organization
• Removed tag-based replay saving and related hotkeys
• Removed v1.2 file scanning and numbering logic
• Returned the script to the simpler and more reliable v1.0 replay workflow
• Removed replay history cap
  • Replay history is no longer limited by an internal maximum
  • Replays remain available for the full OBS session unless manually cleared
• Removed the Max Replays Kept in Historysetting
  • Simplified the script UI
  • Returned replay retention control to the end user
• Preserved core replay behavior
  • Instant Replay support using OBS Replay Buffer and a VLC source
  • Replay history with navigation hotkeys
  • Single-file VLC playlist behavior for direct replay loading

Why this rollback happened​

v1.2 introduced additional replay management features, but those additions also increased complexity in the script and moved it away from the core behavior that mattered most. The v1.0 foundation proved to be the more reliable base for actual live-session use, especially for keeping replay handling simple, predictable, and easy to manage.


This rollback was done to restore stability, reduce unnecessary moving parts, and keep the script focused on its primary job: saving replays, loading them cleanly into VLC, and allowing straightforward session-based replay navigation without artificial limits.

Instant Replay VLC v1.2 Update

This update adds optional session folders and tag-based replay saving.

You can now bind hotkeys to save replays with a specific tag. Each tag maintains its own incrementing number based on existing files, so numbering remains correct across restarts.

Session folders are optional and disabled by default. When enabled, copied replays are organized into per-session folders using the stream name and session start time.

Default behavior is unchanged. If you don’t use the new features, the script works exactly like v1.1.


Update Video

Added a user-defined stream name field for replay filename naming.​

Stream Name:
Enter the stream name used in replay filenames.

Filename format:
YYYY-MM-DD--HH-MM-SS-StreamName.mp4

Notes:
- Avoid special characters: \ / : * ? " < > |
- For best compatibility, avoid spaces; use - or _ instead.

Example:
2026-01-18-12-43-37-my-stream.mp4