OBS Local Stream Marker

A marking tool to help livestream creators with their video production workflow

This script allows you to use a hotkey to create stream markers or bookmarks for streams and recordings made on OBS.

Project Details

• Language: Lua
• Supported Operating Systems: Windows, OS X, Linux
• Requires: OBS 29 and newer
• Download: https://obsproject.com/forum/resources/local-stream-marker.1457/
• Source: https://github.com/honganqi/OBS-Local-Stream-Marker

Description

Twitch has this function called Add Stream Marker where you can add bookmarks to your livestream for review later. With this script, you can have stream markers for any video made with OBS even if you’re not streaming! The stream markers will be saved in a CSV file (comma separated values). You can open this with a spreadsheet application like Microsoft Excel, Google Sheets and the like. You may also open it with text editors like Notepad.

Ten (10) columns will be made:

• Date and time when the stream/recording mark was made
• Date and time when the stream started (if streaming)
• Timestamp of the stream mark (if streaming)
• Timestamp of the stream end mark (if streaming)
• Full path to the file of the recording (if recording)
• Filename of the recording (if recording)
• Timestamp of the mark made on the recording (if recording)
• Timestamp of the end mark made on the recording (if recording)
• Timestamp of the mark made on the recording taking Automatic File Splitting into consideration (if recording)
• Timestamp of the end mark made on the recording taking Automatic File Splitting into consideration (if recording)

Usage

You can also read a tutorial here: OBS Local Stream Marker EASY 3-minute tutorial!

1. Download the ZIP file. You will only need local-stream-marker.lua. The others are just there for reading if you’re bored.
2. In OBS, go to Tools -> Scripts.
3. Add the local-stream-marker.lua script: In the Scripts tab, click on + sign and browse to where this file is.
4. In the Output Folder text box, specify the path where you want the output file (CSV) to be created. If this is not specified, the CSV file will be saved in the same folder as the script.
5. The Set Marker button you see in this window is just here if you want to test this function while you don’t have a hotkey set.
6. Enable Use custom filename if you want to use #7.
7. Use the CSV Filename if you want something other than the default obs-local-stream-marker.csv. Add [date] to the filename if you want to use #8.
8. Use Datetime Format to customize your datetime input in #7. e.g. "%Y-%m-%d" for 2023-07-30, "%B %d, %Y" for September 02, 2023. If you are unsure of your datetime syntax, PLEASE SAVE YOUR WORK BEFORE TESTING THIS BECAUSE USING THE WRONG SYNTAX WILL CRASH YOUR OBS! You can test this by setting your datetime syntax, then hitting your “mark stream” hotkey to check if your file will be created. OBS will crash if it’s not.
9. Once you’re done with this window, go to Settings -> Hotkeys and look for the [Local Stream Marker] Add stream mark hotkey and add your specify your preferred hotkey.
10. If you have the [date] shortcode to add #8 to your filename, the following settings will apply:
    1. If streaming or recording is not active, the timestamp when the first marker was made will be used for the filename.
    2. If streaming is active, the timestamp when the stream was started will be used for the filename. If there was a file created in #10.1, a new file will be created with this new filename with the new timestamp.
    3. If recording is active:
       1. If streaming, it will continue to use the existing file with the filename created with this new timestamp.
       2. If not streaming, it will create a new file with a filename similar to the case in #10.2.