Skip to content

Grymtrx/OBS-Live-Overlay

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

7 Commits
 
 
 
 
 
 

Repository files navigation

OBS Live Overlay

A small Python script that shows a "Recording..." or "Streaming..." indicator on the top-left corner of your screen whenever OBS is active.
It runs as an always-on-top, click-through overlay so you can always tell when OBS is streaming or recording — without tabbing out.

⚙️ Requirements

  • OBS Studio 28+ (includes WebSocket by default; tested on OBS 31)
  • Python 3.8+ installed and added to your PATH

🧠 Setup

  1. Enable WebSocket in OBS

    • Go to Tools → WebSocket Server Settings
    • Check ✅ Enable WebSocket Server
    • Leave port as 4455
    • Set a password (e.g. mypassword)
  2. Install dependencies

    pip install PyQt5 obsws-python
    
  3. Create Auto-Start on Windows (so you dont have to run this everytime)

    • Create a new file named run_overlay.bat in the same folder as obs_live_overlay.py, and paste this:
      @echo off
      python "%~dp0obs_live_overlay.py"
      
    • Press Win + R, type shell:startup, and press Enter.
    • Right-click inside that folder → New → Shortcut → browse to your run_overlay.bat file.
    • Save the shortcut.

About

Displays "Recording..." in top left corner of your screen when OBS is streaming or recording.

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Languages