OBS Lua Smart Chapters 1.0

Smart Chapters LUA Script​

If you find this script useful and wish to support further development:
Ko-fi: https://ko-fi.com/mmltech
PayPal: https://paypal.me/mmltools

How to use it​

1. Load the script
   • Tools → Scripts → + → smart_chapters.lua.
2. Set the chapters file
   • In the script settings, choose a file like
     D:\OBS\chapters.txt (or wherever you want).
3. Optional: enable auto scene chapters
   • Check “Auto add chapter on scene change”
     → every scene switch writes a new chapter line.
4. Set scene-specific labels (optional)
   • In “Scene label overrides”, use one per line:
     
     Code:

     Intro = Intro
     Gameplay = Gameplay Start
     Boss = Boss Fight
     BRB Screen = Break

   • The scene name on the left must match your OBS scene name.
   • The right side is what will appear in the file.
5. Bind the hotkey
   • Settings → Hotkeys → Smart Chapters: Add chapter (current scene)
   • Hit the hotkey during stream/record to drop a marker anytime.
6. Resulting file
   You’ll get lines like:
   
   
   Code:

   # --- New session: 2025-12-01 20:00:15 ---
   00:00 – Intro
   03:25 – Gameplay Start
   14:10 – Boss Fight
   23:42 – Break