Skip to content

carstenbock/obs-stopwatch

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

1 Commit
 
 
 
 

Repository files navigation

OBS Stopwatch

A simple, customizable stopwatch designed for use as a browser source in OBS Studio.

Features

  • Clean, minimal design optimized for streaming overlays
  • Configurable settings directly in the file (no URL parameters needed)
  • Auto-start with delay – perfect for countdowns before recording
  • Keyboard shortcuts for quick control
  • Transparent background in minimal mode for seamless OBS integration

Quick Start

  1. Download stopwatch.html
  2. In OBS: SourcesAddBrowser
  3. Check Local file and select stopwatch.html
  4. Set dimensions to 300 × 150
  5. Done!

Configuration

Open stopwatch.html in any text editor and modify the CONFIG object at the top of the <script> section:

const CONFIG = {
    minimal: true,       // true = time only (for OBS), false = with buttons
    autostart: true,     // true = starts automatically
    delay: 3000          // delay in milliseconds (e.g., 3000 = 3 seconds)
};
Option Type Default Description
minimal boolean true Hides buttons and decorations for a clean overlay
autostart boolean true Automatically starts the timer on load
delay number 3000 Milliseconds to wait before auto-starting (only applies if autostart is true)

Keyboard Shortcuts

Key Action
Space Start / Stop
R Reset
M Toggle minimal mode

OBS Setup

Recommended Settings

  • Width: 300
  • Height: 150
  • Custom CSS: (leave empty)

For Transparent Background

Make sure minimal: true is set in the config. The background will be fully transparent in OBS, allowing the stopwatch to overlay your content seamlessly.

Refreshing the Source

If you change the configuration, right-click the browser source in OBS and select Refresh to apply changes.

Customization

Changing the Font Color

Find this section in the CSS and modify the color value:

.time-display {
    font-size: 3.2rem;
    font-weight: bold;
    color: #2a2a2a;  /* Change this to any color */
    ...
}

Changing the Font Size

Adjust font-size in the same .time-display section. For a 300×150 viewport, values between 2.5rem and 4rem work well.

License

MIT License – free to use, modify, and distribute.

About

Stopwatch for OBS

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors

Languages