obs-custom-plugins 🧩

A small collection of custom OBS plugins and Lua scripts built to streamline my own workflows.

The mission is simple — solve real OBS problems without overengineering.

---

Overview ⚙️

This repository houses custom OBS scripts/plugins, starting with a hotkey-based countdown timer.
Each plugin is built to be:

• 🎯 Purpose-driven — does one thing well
• 🧠 Simple — easy to understand and reuse
• 🎥 Practical — made for real streaming or study setups

New plugins will be added as new needs arise.

---

Current Plugin ⏱️

Hotkey Countdown Timer

A lightweight, text-based countdown timer for OBS — fully controlled via hotkeys.

Features

• ▶️ Start / ⏸️ Stop / 🔄 Reset — configure custom hotkeys in OBS settings
• Updates an OBS text source in real time
• Works independently of scene switching
• Perfect for “Starting Soon” scenes, breaks, or study streams

Why Choose This? ✨🚀

• Built from real-world use (not tutorials) — simplifies timer/scene control
• Hotkey-driven (no scene dependency) — streamlines study/stream flow
• Lightweight (no external dependencies) — ditches outside timer apps
• Easy to modify — keeps everything inside OBS

---

Installation & Usage 📦

Option 1: Download (simple)

1. Visit the GitHub repo
2. Click Code → Download ZIP
3. Extract the folder
4. In OBS: Tools → Scripts → +
5. Load the .lua file and assign your preferred hotkeys(In settings)

Option 2: Clone (for developers)

git clone https://github.com/pushkarthisside/obs-custom-plugins.git