Skip to content

dneprsys/Timer-plugin-offline

 
 

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

7 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Timer Plugin (Text-Only Display)

This is a powerful and fully customizable countdown timer plugin designed for OBS Studio.
It consists of two parts:

  • Control Panel – lets you set the time, start/pause/reset the countdown, and customize the message, style, and saved sessions.
  • Display Page – shows a fullscreen countdown timer and message that updates in real time.

πŸ’» How It Works

  • The Control Panel is added to OBS as a dock.
  • The Display Page is added as a browser source.
  • Both communicate instantly through a BroadcastChannel β€” no server or internet required.

🧠 Tabs Overview

⏱️ Timer Settings Tab

  • Enter and start custom countdowns.
  • Use preset minute buttons for quick setup.
  • Select Preset Style – apply a saved visual preset to the current display.
  • Manage saved Sessions such as:
    • Opening Speech
    • Prayer
    • Worship
    • Award Presentation, etc.
  • Each session stores its name, duration, and end message β€” ready to load or start instantly.

🎨 Style Tab

  • Switch between Light and Dark themes (applies to panel only).
  • Choose separate font colors for:
    • Timer text
    • End message text
  • Adjust:
    • Font family (Sans, Serif, Monospace, Cursive)
    • Font sizes (Timer + Message)
    • Container alignment – choose from 9 screen positions
      (Top/Center/Bottom Γ— Left/Center/Right)
  • Save and recall full Style Presets for quick visual configuration.

🧾 Sessions Tab

  • Create and manage named timers.
  • Each session includes:
    • Session name
    • Time (in minutes)
    • End message
  • Options per session:
    • Load (fills Timer tab)
    • Start (immediately begins countdown)
    • Delete
  • Sessions persist automatically between uses.

πŸ“ Example Workflow

  1. Create or load a session (e.g., β€œOpening Speech – 5 min”).
  2. Adjust fonts, colors, and layout under the Style tab.
  3. Save your style as a preset (e.g., β€œBold Stage Display”).
  4. Back in Timer Settings, choose your preset, click Start, and you’re ready to go!

πŸ’– Support the Developer

If you love what I do and want to support ongoing development, you can donate here:

πŸ‘‰ Donate via PayPal

Your support helps keep this tool free and constantly improving. πŸ™


πŸ”– Version History

  • Added Style Presets (save, apply, delete)
  • Added Saved Sessions tab for multiple timers
  • Improved UI layout and panel organization
  • Moved preset selection to Timer Settings tab
  • Added 9-point container alignment control
  • Added font size controls and persistent local storage
  • Added Style tab to Control Panel
  • Theme toggle (Light/Dark) for control panel
  • Font color pickers for timer and end message (independent)
  • Custom font family selector
  • Animated message styling improvements
  • Integrated end message display
  • Basic styling and layout improvements
  • Setup for communication via BroadcastChannel
  • Basic countdown timer
  • End message display logic
  • Core HTML/CSS structure for control and display

πŸ™Œ Credits

Made with ❀️ by Tioluwani Lowo
Designed to be fast, flexible, and offline-friendly.

About

No description, website, or topics provided.

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Languages

  • JavaScript 52.5%
  • HTML 25.0%
  • CSS 22.5%