Have you ever asked yourself, “Where was that POG moment a while ago?” or interrupting your stream to bookmark a moment and say, “Sheesh! I wish there was a better way to note down these awesome moments than writing on paper!” The Local Stream Marker for OBS will allow you to sift through your recordings when you edit them later on. The markers will be saved in a CSV file which you can view and edit with a spreadsheet app like Microsoft Excel, Google Sheets, and so on… You can watch a video of this tutorial here:
Installation: Local Stream Marker
To install this script, download from the OBS Forums or from my GitHub, then extract the files somewhere.
- OBS Forums – https://obsproject.com/forum/resources/local-stream-marker.1457/
- GitHub – https://github.com/honganqi/OBS-Local-Stream-Marker
The zip file will contain a number of files but you actually need a single LUA file: “obs-local-stream-marker.lua”. Launch OBS if you haven’t, then go to “Tools > Scripts”. Click on the plus sign (+) to add a script, browse to where you extracted it, select it, click “Open”.
There are 2 things left to do. Set the output folder and set your hotkey. The “Output Folder” is where the script will save the CSV file when you set a marker. If you leave this blank, or if the folder doesn’t exist anymore, or if there is a problem making changes to this folder, the script will save the CSV file in the same folder where the script is found.
Now, let’s set what is probably the most important thing you need to: the hotkeys. You can actually set markers without hotkeys on the Scripts window but I would really recommend it only for testing. Go to “Settings > Hotkeys” and search for “[Local Stream Marker] Add stream mark” and set a hotkey here. You may want to add a second hotkey for “[Local Stream Marker] Mark end” to mark the end of that marker. That’s it!
A Look at the Output File
Now, let’s look at the CSV output file. The CSV has 10 columns. The data in the “Date Time” column is when you actually set a marker. If you are streaming, the “Stream Start” column has the date and time information of when you started the stream, otherwise it will show “n/a” or “not applicable”. The same goes for “Stream Timestamp” but for the timestamp on the stream. “Stream End Mark Timestamp” would be the end of your marker if you used this.
If you are recording, “Recording Full Path” will show the path of where OBS is INITIALLY saving the recording. It will be blank if you’re not recording. If you move the file of the recording afterwards, the CSV file will not reflect this change, so please be mindful of this. “Recording Filename” will contain just the filename section of the full path. Both of these will contain the filename that was being used by OBS at the time the marker was used. This will be relevant for you if you have “Automatic File Splitting” enabled in the “Output > Recording” setting in OBS.
Then you have “Recording Timestamp” and “Recording Timestamp on File”. The difference between these 2 columns is if you have “Automatic File Splitting” turned on. “Recording End Mark Timestamp” and “Recording End Mark Timestamp on File” are just the “end” portions similar to the one in the paragraph above.
So, that’s it! Easy peasy ggwp! If you have any questions, please let me know in the comments here, in the OBS Forums, or in my Discord. If you encounter any errors or if you have any suggestions, I would appreciate any submissions!
Thank you very much!
Leave a Reply