⚔️ WoWOBSAutoClip

Automated Combat Recorder for World of Warcraft

WoWOBSAutoClip is a lightweight Python utility that monitors your World of Warcraft combat log and automatically triggers OBS Studio to record your boss encounters and Mythic+ runs. It handles the annoying parts—starting, stopping, and naming files—so you can focus on the game and analyze later.

✨ Features

• 📦 Universal Support: Works with Retail, Classic (Cata/MoP), TBC Anniversary, and Classic Era.
• 🏆 Mythic+: Detects run start, extracts the Key Level for the filename, and records the entire run as one file.
• 📍 Smart Chapters: Automatically adds MKV chapter markers for Boss Pulls (inside M+), Boss Defeated/Wipes, and Player Deaths.
• 🚀 Auto-Naming: Files are saved with timestamps, boss names, key levels, and result (KILL/WIPE).

📋 Prerequisites

1. OBS Studio: Download here.
2. OBS WebSocket: Ensure "WebSocket Server Settings" is enabled in OBS (Tools menu).
3. MKVToolNix: Required for injecting chapters. Download here.
4. Python 3.x: Download here.

Important

You must enable Advanced Combat Logging in-game for Mythic+ data and Boss names to be captured accurately. Location: Menu -> Options -> Network -> Advanced Combat Logging (Check this box).

🛠️ Setup

1. Download this repository and extract it to a folder.
2. Configure the Script: Open WoWOBSAutoClip.py in a text editor and update the entire --- 1. Configuration --- section:
   • OBS_PASSWORD: Your OBS WebSocket password.
   • WOW_LOG_DIRECTORY: Path to your WoW Logs folder (e.g., _retail_\Logs).
   • STOP_DELAY_SECONDS: How long to keep recording after a boss dies (default: 5).
   • MKVMERGE_CMD: The full path to your mkvmerge.exe.
   • OBS_EXE_PATH: The full path to your obs64.exe.
3. Run the Recorder: Simply double-click Run_WoWOBSAutoClip.bat. It will automatically install the required libraries on the first run.

🎮 Supported Content

Content Type	Start Trigger	End Trigger	Markers
Raid Bosses	Encounter Start	Encounter End	Deaths
Mythic+	Key Inserted	Dungeon End	Bosses & Deaths
Anniversary	Encounter Start	Encounter End	Deaths

🖥️ Console Preview

 --------------------------------------------------
        W o W   O B S   A u t o C l i p
   [ Raids  -  Mythic+  -  Retail  -  Classic  ]
 --------------------------------------------------

[SUCCESS] Monitoring WoW Logs...
(Keep this window open while playing!)

>> OBS is already running.
>> VERSION: 1.5.7
>> FULL LOG PATH: X:\World of Warcraft\_classic_\Logs\WoWCombatLog-010326_233254.txt
>> World of Warcraft Classic
>> Log file is fresh. Ready!
>> OBS CONNECTED successfully.
>> MONITORING ACTIVE <<

--- [ SCENARIO: RAID KILL ] ---
!!! RECORDING STARTED: Thalnos the Soulrender
>> PLAYER DEATH: Janhus-Garalon-EU
>> Waiting 5s to finalize log data...
>> FINALIZED: 2026-01-04 01-12-18_Thalnos_the_Soulrender_KILL.mkv

--- [ SCENARIO: RAID WIPE ] ---
!!! RECORDING STARTED: Heroic Lich King
>> PLAYER DEATH: Tankname-Silvermoon-EU
>> PLAYER DEATH: Healername-Silvermoon-EU
>> Waiting 5s to finalize log data...
>> FINALIZED: 2026-01-04 01-45-10_Heroic_Lich_King_WIPE.mkv

--- [ SCENARIO: MYTHIC+ ] ---
!!! RECORDING STARTED: M+ The Necrotic Wake (+15)
>> PLAYER DEATH: Rogue-Illidan-US
>> Waiting 5s to finalize log data...
>> FINALIZED: 2026-01-04 02-15-05_MPlus_The_Necrotic_Wake_plus15_KILL.mkv

⚖️ License

This project is open-source and free to use for the WoW community.