OBS Lua - Comprehensive Stopwatch & Countdown Timer

TIMER PLUGIN

Version 6.0
Released 3 October 2026

This script is a plugin written in the Lua programming language, designed specifically to run inside OBS Studio (OBS > Tools > Scripts).

Completely customizable timer format & display

New in 6.0

Reset and hotkeys fixed on OBS 31/32, including with the Scripts window closed.
Overtime: a countdown can keep counting up after zero.
Pause at markers: e.g. pause at 45:00 and 90:00 for a football match.
Expiry audio, then switch scene.
Frame display, independent hour/minute units, round-up countdown, a 'Set' hotkey, 1-second add/subtract steps, and a Script Description checkbox for small screens.

See the 6.0 update post for the full list of changes.

Feature Overview

This plugin is designed to be highly customizable and versatile, making it suitable for a wide range of scenarios and user preferences. Here are some of the features this plugin has to offer.

Supports Duplication: The plugin can be duplicated and used to run multiple instances simultaneously.
Customizable Timer Format & Display: The timer format and display are completely customizable, allowing for various configurations.
Count Up: The plugin can count time upwards.
Count Down: The plugin can count time downwards.
Real-Time Count Inversion: The plugin can change the counter direction in real-time.
Countdown Components: The plugin supports counting down in days, hours, minutes, seconds, and milliseconds.
Specific Date & Time Countdown: The plugin supports counting down to a specific date and time.
Overtime (new in 6.0): When a countdown reaches zero, the timer can keep counting up, optionally shown with a '+' and its own colour.
Round Up Countdown Display (new in 6.0): Countdown formats without seconds (e.g. hours:minutes) show 00:01 until the timer really reaches zero.
Toggle Visibility of Split Seconds: Triggered by Hotkey or timestamp to show/hide the split seconds.
Frame Display (new in 6.0): Show split seconds as video frames (e.g. 60 fps) instead of hundredths of a second.
Events when Timer Expires: Show a message, play a media source, switch scene, cycle lists, start recording, or keep counting as overtime.
Create a Stopwatch: Features to mark laps and intervals.
Start Timer from Specific Timestamp: The plugin can be started from a specific timestamp, from the settings or with a 'Set' hotkey.
Autoload Last Saved Timestamp: The plugin can autoload the last saved timestamp on startup (Count Up). The time is saved regularly, so it survives a crash.
Cycle Through Source List: The plugin can cycle through a defined source list based on a timer.
Cycle Through Nested Sources: The plugin can cycle through sources that are placed in a defined group or nested scene based on a timer.
Cycle Through Scene List: The plugin can cycle through a defined scene list based on a timer.
Switch to Specific Scene when Timer Expires: The plugin can switch to a specific scene when the timer expires, optionally after the expiry audio has played.
Play a Media Source at Specified Time: The plugin can play up to two media sources (Marker A and Marker B) at specified times, every time the marker is reached, with an optional playback duration.
Play a Media Source when Timer Expires: The plugin can play a media source when the timer expires.
Pause at Specified Time (new in 6.0): The timer can pause itself exactly at Marker A or Marker B, e.g. at half time and full time of a football match.
Change Timer Text Color: The plugin can change the timer text color at a specified time, allows defining two color changes, and can restore the normal color after a set time.
Enable Visibility on Another Text Source: The plugin can enable visibility on another text source (a note) at a specified time, and hide it again after a set time.
Start Recording at Specified Time: In Count Down, the plugin can start recording when the timer expires, at Marker A or Marker B, when the timer becomes visible, or when it starts.
Custom Message on Timer Expiry: The plugin can display a custom message when the timer expires.
Custom Timer Prefix/Suffix: The plugin allows defining a custom prefix or suffix for the timer.
Automatic Timer Start: The plugin can start the timer when the Timer Text Source becomes visible, when its scene (or a specific scene, source or media source) becomes active, or when recording or streaming starts, with an optional automatic reset.
Export Script Settings: The plugin allows exporting script settings for backup or quick setup.
Import Script Settings: The plugin allows importing previously saved script settings.
Add/Subtract Seconds: The plugin can add or subtract time with three preset step sizes each (from 1 second), with optional limits, also while paused.
Assign Minute Unit Format: The plugin allows assigning a minute unit to create a 90-minute timer or any length minute timer, e.g. {$M90}.
Assign Hour Unit Format: The plugin allows assigning an hour unit to override the default 24-hour timer with any length hour timer, e.g. {$H100}. Hour and minute units can be used separately or together.
Debug Logging: Create a local file for debugging issues.
Dedicated Buttons: Ability to split the 'Start' and 'Pause' button.
Hotkey Support: The plugin supports hotkeys for starting, pausing, resetting, setting a manual time, split-time, toggling milliseconds, changing time direction, and adding/subtracting time. Hotkeys work while the Scripts window is closed.
Compact Settings: The script description can be hidden to give the settings more room on small screens.
Disable Unwanted Features: Ability to completely remove unwanted features.

PLUGIN DESIGN OVERVIEW:

To ensure an optimal user experience, it's important to understand the distinction between two types of objectives some of the properties serve in the plugin UI: those that enhance the user experience and those that directly impact the core functionality and behaviour. Let's delve into these categories to help you navigate the plugin effortlessly.

PROPERTIES FOR ENHANCING USER EXPERIENCE:

These properties focus on providing additional customization options and improving the overall usability of the plugin. While they don't directly affect the core functionality, they play a vital role in tailoring the plugin to a specific purpose.

Here's what you need to know:

The OBS native UI can sometimes become cluttered when using plugins with complex configurability. To address this issue, this plugin has been designed to display or hide certain properties based on their relevance. It's important to understand that some properties, while relevant, are intentionally hidden to prevent an overwhelming amount of information. Therefore, it is crucial to carefully examine each property to determine if it reveals any extendable settings. Each property also has a tooltip: hover over its name for help.

Here are some properties that will simplify or expand the available properties:
1. Script Description (top of the settings: show or hide the description)
2. Layout (Basic / Advanced)
3. Timer Settings
4. Marker Settings
5. Timer Manipulation
6. Disable Features

PROPERTIES AFFECTING CORE FUNCTIONALITY AND BEHAVIOR:

These properties directly impact how the plugin operates and can significantly influence its core functionality. Understanding and adjusting these settings will ensure the plugin behaves precisely as you intend.

Here's what you should consider:

The plugin provides timer-focused functionality that can be configured for various scenarios.
The plugin provides two modes, each with some unique features and some that overlap between the two modes.

The plugin modes are:

Count Up
Count Down

The plugin initializes with Count Up as the default mode and with a Basic layout, which expands to an Advanced layout.

The Basic layout hides additional properties that only become available in the Advanced layout.

Switching between the Basic and Advanced layout has no impact on the features or any defined settings of the plugin; it only shows or hides properties in the plugin settings UI. This removes clutter when only a simple layout is required. This approach was chosen because many of the features are not used by the average user, and having them all displayed in a small area can be overwhelming. The downside is that settings may feel hidden at first: if you cannot find a setting, switch to the Advanced layout and expand the relevant section.

Item	PROPERTIES DESIGN	Version	Mode Available
1	Script Description Type: Checkbox, Default value: checked, Shown at the very top of the settings, in every layout, Unticked: hides the script description (title, links) to give the settings more room on small screens, Applies after “Reload Scripts” or an OBS restart.	6.0	Always
2	Timer Mode Type: Dropdown list, Available Static Options: “Count Up”, “Count Down”, Use dynamic options: No, Default value: “Count Up”, On Change: “Hide or display relevant properties”.	0.2 2.0 (Expanded)	Always
3	Layout Type: Dropdown list, Available Static Options: “Basic”, “Advanced”, Use dynamic options: No, Default value: “Basic”, On Change: “Hide or display properties”.	2.0	Always
4	Timer Settings Type: Dropdown list, Available Static Options: “Hidden”, “Expanded”, Use dynamic options: No, Default value: “Hidden”, On Change: “Hide or display properties”.	4.2	Always
5	Timer Source Type: Dropdown list, Available Static Options: “Select”, Use dynamic options: Yes, List all available names of Text Sources, Default value: “Select”, On Change: “”.	0.2	Always
6	Count Down Type Type: Dropdown list, Available Static Options: “Specific Date & Time”, “Hours, Minutes, Seconds”, Use dynamic options: No, Default value: “Hours, Minutes, Seconds”, On Change: “Hide or display relevant properties”.	2.9	Count Down
7	Day Text Format Type: Text input, Default value: “# Day”, On Change: “Updates Timer Display”.	2.9.1	Count Down
8	Days Text Format Type: Text input, Default value: “# Days”, On Change: “Updates Timer Display”.	2.9.1	Count Down
9	Month Type: Dropdown list, Available Static Options: “Select”, “January”, “February”, “March”, “April”, “May”, “June”, “July”, “August”, “September”, “October”, “November”, “December”, Use dynamic options: No, Default value: “Select”, On Change: “Updates Timer Display”.	2.9	Count Down
10	Year Type: Integer input, Default value: the current year, On Change: “Updates Timer Display”.	2.9.1	Count Down
11	Day Type: Integer input (1–31), Default value: “1”, On Change: “Updates Timer Display”.	2.9.1	Count Down
12	Hours Type: Integer input, Range: 0–9999 (“Hours, Minutes, Seconds”), 0–23 (“Specific Date & Time”), Default value: “0”, On Change: “Updates Timer Display”.	2.0 6.0 (Range)	Count Down
13	Minutes Type: Integer input, Range: 0–9999 (“Hours, Minutes, Seconds”), 0–59 (“Specific Date & Time”), Default value: “0”, On Change: “Updates Timer Display”.	2.0 6.0 (Range)	Count Down
14	Seconds Type: Integer input, Default value: “0”, On Change: “Updates Timer Display”.	2.0	Count Down
15	Timer Format Type: Dropdown list, Available Static Options: “Display full format”, “No leading zeros”, “No leading zeros, no split seconds”, “No split seconds”, “Custom Time Format”, Use dynamic options: No, Default value: “Display full format”, Conditional: If “Custom Time Format” is selected, “Time Format” will be shown, On Change: “Hide or display relevant properties”.	3.0 (Expanded) 3.3 (Expanded) 4.8 (Expanded)	Always
16	Time Format Type: Text Input, Default value: “$T$D:$H:$M:$S,$F”, Placeholders: $D day, $H hour, $M minute, $S second, $F split second, $T trims leading zeros, Support Instructions: Yes ( “{param}” ), {$H100} / {$M200}: hour or minute unit, used separately or together, e.g. {$H100}:{$M200}, {$F60} / {$F}: show split seconds as frames (60 fps / OBS frame rate), Older form still supported: {M90}, {H100M200}, On Change: “Adjust timer display” (typing does not move the cursor).	4.8 5.6 6.0 (Expanded)	Always
17	Round up displayed countdown Type: Checkbox, Default value: checked, Shown with “Custom Time Format”, Applies when the Time Format has no seconds ($S), e.g. $H:$M shows 00:01 until zero.	6.0	Count Down
18	Timer Activation Type: Dropdown list, Available Static Options: “Manually”, “Timer Source Visible”, “Timer Scene Active”, “Specific Scene Active”, “Specific Source Active”, “Specific Media Active”, “Recording Started”, “Streaming Started”, Use dynamic options: No, Default value: “Manually”, Conditional: “Specific …” options show “Activation Source”; any option other than “Manually” shows “Timer Reset”, Replaces the earlier “Start/Reset Timer on Source Visible / Scene Active” checkboxes, On Change: “Hide or display relevant properties”.	5.x	Always
19	Activation Source Type: Dropdown list, Available Static Options: “Select”, Use dynamic options: Yes, List the scenes, sources or media sources that match the selected Timer Activation, Default value: “Select”, On Change: “”.	5.x	Always
20	Timer Reset Type: Dropdown list, Available Static Options: “Manual”, “Auto”, Use dynamic options: No, Default value: “Manual”, Auto: reset the timer each time it is activated, On Change: “”.	5.x	Always
21	Toggle Milliseconds Type: Text Input, Default value: “”, Use: time stamp 00:00:00 at which to show the milliseconds, On Change: “”.	3.9	Count Down
22	Split Source Type: Dropdown list, Available Static Options: “Select”, Use dynamic options: Yes, List all available names of Text Sources, Default value: “Select”, The Timer Source and other text roles are not listed; if no Text Source is free, a greyed-out hint explains why, Conditional: If a valid Text Source is selected then “Split Type” will be shown, On Change: “Hide or display relevant properties”.	1.0 6.0 (Hint)	Count Up
23	Refresh sources Type: Button, On Click: “Rebuild the Split Source list from the current OBS sources”.	6.0	Count Up
24	Split Type Type: Dropdown list, Available Static Options: “Interval”, “Mark”, “Mark Interval”, “Interval Mark”, Use dynamic options: No, Default value: “Mark”, On Change: “”.	1.0	Count Up
25	Marker Settings Type: Dropdown list, Available Static Options: “Hidden”, “Expanded”, Use dynamic options: No, Default value: “Hidden”, On Change: “Hide or display relevant properties”.	4.2	Always
26	Tip Type: Text (information), Value: “Use format 00:00:00 ( hours:minutes:seconds )”.	5.x	Always
27	Marker A Time Type: Editable list, Use: time stamps 00:00:00, one per entry, On Change: “”.	2.0	Always
28	Marker B Time Type: Editable list, Use: time stamps 00:00:00, one per entry, On Change: “”.	2.0	Always
29	Pause timer at Marker A Type: Checkbox, Default value: unchecked, Pauses the timer exactly on each Marker A time; marker audio, colour and note still run; press Start to continue.	6.0	Always
30	Pause timer at Marker B Type: Checkbox, Default value: unchecked, Pauses the timer exactly on each Marker B time; marker audio, colour and note still run; press Start to continue.	6.0	Always
31	Reset Marker A Text Type: Integer Slider (seconds), Default value: “3”, Restores the normal colour after this time; paused with the timer, On Change: “”.	5.0 6.0	Always
32	Reset Marker B Text Type: Integer Slider (seconds), Default value: “3”, Restores the normal colour after this time; paused with the timer, On Change: “”.	5.0 6.0	Always
33	Marker A Audio Type: Dropdown list, Available Static Options: “None”, “Allow Multiple Selections”, Use dynamic options: Yes, List all available names of Media Sources, Default value: “None”, Plays every time the marker is reached (no Reset needed), Conditional: If “Allow Multiple Selections” is selected then “Marker A Audio List” will be shown, On Change: “Show/Hide relevant properties”.	2.0 6.0	Always
34	Marker A Audio List Type: Editable list, Use: Define names of Media Sources, played in turn, On Change: “”.	5.0	Always
35	Marker B Audio Type: Dropdown list, Available Static Options: “None”, “Allow Multiple Selections”, Use dynamic options: Yes, List all available names of Media Sources, Default value: “None”, Plays every time the marker is reached (no Reset needed), Conditional: If “Allow Multiple Selections” is selected then “Marker B Audio List” will be shown, On Change: “Show/Hide relevant properties”.	2.0 6.0	Always
36	Marker B Audio List Type: Editable list, Use: Define names of Media Sources, played in turn, On Change: “”.	5.0	Always
37	Timer Expired Audio Type: Dropdown list, Available Static Options: “None”, Use dynamic options: Yes, List all available names of Media Sources, Default value: “None”, Shown for “Select”, “TIMER END TEXT”, overtime, and a scene with “Play Timer Expired Audio first, then switch”, On Change: “”.	4.2 6.0	Count Down
38	Media Playback Limit Type: Dropdown list, Available Static Options: “Disabled”, “Enabled”, Use dynamic options: No, Default value: “Disabled”, On Change: “Show/Hide relevant properties and enable/disable relevant features”.	2.0	Always
39	Marker A Duration Type: Integer Slider (seconds), Default value: “5”, Conditional: Setting to 0 = disabled, Stops the Marker A audio after this time (real time), On Change: “”.	2.0 6.0 (fixed)	Always
40	Marker B Duration Type: Integer Slider (seconds), Default value: “5”, Conditional: Setting to 0 = disabled, Stops the Marker B audio after this time (real time), On Change: “”.	2.0 6.0 (fixed)	Always
41	End Audio Duration Type: Integer Slider (seconds), Default value: “5”, Conditional: Setting to 0 = disabled, On Change: “”.	4.2	Count Down
42	Normal Color Type: Colour Select, Default value: “#ffffff”, On Change: “”.	2.0	Always
43	Marker A Color Type: Colour Select, Default value: “#edf340”, On Change: “”.	2.0	Always
44	Marker B Color Type: Colour Select, Default value: “#5a0505”, Also used for overtime (optional), On Change: “”.	2.0	Always
45	Marker Notes Type: Dropdown list, Available Static Options: “Disabled”, “Enabled”, Use dynamic options: No, Default value: “Disabled”, On Change: “Hide or display relevant properties”.	3.2	Always
46	Marker A Note Source Type: Dropdown list, Available Static Options: “Select”, Use dynamic options: Yes, List all available names of Text Sources, List all available names of Group Sources (all nested Text Sources will be used), Default value: “Select”, On Change: “”.	3.2	Always
47	Marker B Note Source Type: Dropdown list, Available Static Options: “Select”, Use dynamic options: Yes, List all available names of Text Sources, List all available names of Group Sources (all nested Text Sources will be used), Default value: “Select”, On Change: “”.	3.2	Always
48	Marker A Note Type: Text Input, Default value: “”, On Change: “”.	3.2	Always
49	Marker B Note Type: Text Input, Default value: “”, On Change: “”.	3.2	Always
50	Hide Marker A Note Type: Integer Slider (seconds), Default value: “3”, Conditional: Setting to 0 = disabled, Paused with the timer, On Change: “”.	5.0 6.0	Always
51	Hide Marker B Note Type: Integer Slider (seconds), Default value: “3”, Conditional: Setting to 0 = disabled, Paused with the timer, On Change: “”.	5.0 6.0	Always
52	Auto Recording Type: Dropdown list, Available Static Options: “Disabled”, “Timer Expires”, “Marker A Time”, “Marker B Time”, “Timer Visible”, “Timer Start”, Use dynamic options: No, Default value: “Disabled”, Starts OBS recording (if not already recording), On Change: “”.	2.0	Count Down
53	Timer Prefix Type: Text Input, Default value: “”, On Change: “Update Timer prefix display”, Support Instructions: Yes ( “{param,param}” ), Restored after an OBS restart.	2.4 6.0	Always
54	Timer Suffix Type: Text Input, Default value: “”, On Change: “Update Timer suffix display”, Support Instructions: Yes ( “{param,param}” ), Restored after an OBS restart.	3.0 6.0	Always
55	Active Source Type: Dropdown list, Available Static Options: “Select”, Use dynamic options: Yes, List all available names of Text Sources, Default value: “Select”, Shown with the Source / Scene / Auto List expire events, On Change: “”.	2.8	Count Down
56	Timer Expire Event Type: Dropdown list, Available Static Options: “Select”, “TIMER END TEXT”, “Continue counting (overtime)”, “Source List”, “Scene List”, “Auto List”, Use dynamic options: Yes, List all available scene names (switch to that scene when the timer expires), Default value: “Select”, Conditional: Expands features when timer expires, selected feature dependent, On Change: “Show/Hide relevant properties and enable/disable relevant features”.	2.8 5.1 (Expanded) 6.0 (Overtime)	Count Down
57	Play Timer Expired Audio first, then switch Type: Checkbox, Default value: unchecked, Shown when a scene is the Timer Expire Event, Plays the Timer Expired Audio, then switches when it ends or after End Audio Duration, On Change: “Show Timer Expired Audio settings”.	6.0	Count Down
58	Overtime: show '+' and Marker B colour Type: Checkbox, Default value: checked, Shown with “Continue counting (overtime)”, Overtime counts up after zero; Reset ends it.	6.0	Count Down
59	Auto List Type: Dropdown list, Available Static Options: “Select”, Use dynamic options: Yes, List all available names of Group Sources (all nested Text Sources will be used), Default value: “Select”, On Change: “”.	5.1	Count Down
60	Timer Expired Text Type: Text Input, Default value: “”, Shown with “TIMER END TEXT”, On Change: “”.	2.0	Count Down
61	Cycle List Type: Editable list, Use: Define names of Sources or Scenes, Conditional: “Will only allow the appropriate types, will disregard others”, On Change: “”.	2.8	Count Down
62	Cycle Direction Type: Dropdown list, Available Static Options: “Ascending”, “Descending”, Use dynamic options: No, Default value: “Ascending”, On Change: “”.	5.1 (Expanded)	Count Down
63	Timer Manipulation Type: Dropdown list, Available Static Options: “Hidden”, “Expanded”, “Disabled”, Use dynamic options: No, Default value: “Hidden”, Hidden: hotkeys work, options collapsed; Expanded: show step sizes and limits; Disabled: the hotkeys do nothing, On Change: “Show/Hide relevant properties and enable/disable relevant features”.	4.7 6.0 (Default)	Always
64	Add Seconds Type: Group, Name: Add Seconds to time (Initiate with Hotkey), Group Item Name: Set 1, Type: Integer Input (seconds, from 1), Default value: “5”, Step: “1”, Hotkey Available: Yes, must be assigned (“Add Seconds Set 1”). Group Item Name: Set 2, Type: Integer Input (seconds, from 1), Default value: “15”, Step: “1”, Hotkey Available: Yes, must be assigned (“Add Seconds Set 2”). Group Item Name: Set 3, Type: Integer Input (seconds, from 1), Default value: “30”, Step: “1”, Hotkey Available: Yes, must be assigned (“Add Seconds Set 3”). Group Item Name: Limit, Type: Integer Input, Default value: “0”, Conditional: Setting 0 = infinite, Group Item Name: Used, Type: Integer Input, Default value: “0”, Group Item Name: Limit Note, Type: Dropdown list, Static option: “Select”, Dynamic options: List all available names of Text Sources, Default value: “Select”, Group Item Name: Note visible, Type: Integer Input (milliseconds), Default value: “0” (0 = always visible), Group Item Name: Refresh to update form, Type: Button, On Click: “Refresh Properties”. Works while the timer is paused (the display updates).	4.5 4.7 (Expanded) 6.0	Always
65	Subtract Seconds Type: Group, Name: Subtract Seconds from time (Initiate with Hotkey), Group Item Name: Set 1, Type: Integer Input (seconds, from 1), Default value: “5”, Step: “1”, Hotkey Available: Yes, must be assigned (“Subtract Seconds Set 1”). Group Item Name: Set 2, Type: Integer Input (seconds, from 1), Default value: “15”, Step: “1”, Hotkey Available: Yes, must be assigned (“Subtract Seconds Set 2”). Group Item Name: Set 3, Type: Integer Input (seconds, from 1), Default value: “30”, Step: “1”, Hotkey Available: Yes, must be assigned (“Subtract Seconds Set 3”). Group Item Name: Limit, Type: Integer Input, Default value: “0”, Conditional: Setting 0 = infinite, Group Item Name: Used, Type: Integer Input, Default value: “0”, Group Item Name: Limit Note, Type: Dropdown list, Static option: “Select”, Dynamic options: List all available names of Text Sources, Default value: “Select”, Group Item Name: Note visible, Type: Integer Input (milliseconds), Default value: “0” (0 = always visible), Group Item Name: Refresh to update form, Type: Button, On Click: “Refresh Properties”. Works while the timer is paused (the display updates).	4.5 4.7 (Expanded) 6.0	Always
66	Manually set timer Type: Group, Group Item Name: DD, Type: Integer input (days), Default value: “0”, Group Item Name: HH, Type: Integer input (0–9999), Default value: “0”, Group Item Name: MM, Type: Integer input (0–9999), Default value: “0”, With a minute unit (e.g. {$M90}), MM is the minute value shown, Group Item Name: SS, Type: Integer input, Default value: “0”, Group Item Name: FF, Type: Integer input, Default value: “0”, Group Item Name: Autoload last time stamp when OBS starts, Type: Checkbox, Default value: unchecked, Saved every 30 seconds while running and whenever the timer stops (survives a crash), Group Item Name: Set, Type: Button, On Click: “Apply settings to Timer”, Hotkey Available: Yes, must be assigned (“Set”). Group Item Name: Saved Seconds, Type: Number (the last saved time),	3.5 6.0	Count Up
67	Start Timer Type: Button, On Click: “Activate Timer”, Hotkey Available: Yes, must be assigned (“Start (Start/Pause if not split)”), Available via Opt-In (see Split Start Pause Button)	5.1	Always conditional
68	Start / Pause Timer Type: Button, On Click: “Activate / Stop Timer”, Hotkey Available: Yes, must be assigned (“Pause (Start/Pause if not split)”), Can be dedicated Pause only via Opt-In (see Split Start Pause Button)	5.1 (Expanded)	Always
69	Split Time Type: Button, On Click: “Split Timer”, Hotkey Available: Yes, must be assigned.	1.0	Count Up
70	Show/Hide Milliseconds Type: Button, On Click: “Toggle visibility for timer split seconds”, Hotkey Available: Yes, must be assigned (works while the Scripts window is closed).	3.9	Count Down
71	Count Up/Down Type: Button, On Click: “Toggle timer direction (positive/negative)”, Shown when “Enable Timer Direction Toggle” is checked, Hotkey Available: Yes, must be assigned.	4.4	Always not with Specific Date & Time
72	Reset Timer Type: Button, On Click: “Reset Timer to initial position”, Hotkey Available: Yes, must be assigned (works while the Scripts window is closed).	0.2 6.0	Always
73	Split Start Pause Button Type: Checkbox, Default value: unchecked, Unchecked: one Start/Pause button, both hotkeys toggle; Checked: separate Start and Pause, Applies straight away (no OBS restart).	5.1 6.0	Always
74	Adjust timer manually Type: Checkbox, Default value: unchecked, On Click: “Display ‘Manually set timer’”.	3.2	Count Up
75	Active Source Force Visibility Type: Checkbox, Default value: unchecked, On Click: “”.	3.9	Count Down
76	Enable Timer Direction Toggle Type: Checkbox, Default value: unchecked, On Click: “Show the Count Up/Down button and Prevent Negative Time Value”.	4.4	Always not with Specific Date & Time
77	Prevent Negative Time Value Type: Checkbox, Default value: unchecked, On Click: “”.	4.4	Always not with Specific Date & Time
78	Backup Mode Type: Checkbox, Default value: unchecked, On Click: “Display Backup Mechanisms”.	3.3	Always
79	Enable debug logging Type: Checkbox, Default value: unchecked, Writes a “Debug Log” text file next to the script.	5.0	Always
80	Backup Folder Type: Folder path, Default value: “”, On Change: “List the settings files found in the folder”.	3.3	Always
81	Load Settings Type: Dropdown list, Available Static Options: “No Files Found”, Use dynamic options: Yes, List names of all valid settings files in the Backup Folder, Default value: “No Files Found”, On Select: “(when a valid file is selected) Import and apply all property settings from the selected file”, On Change: “”.	3.3	Always
82	Export Split Time Type: Checkbox, Default value: unchecked, Exports split times to a text file (opt-in).	5.9	Always
83	Import Settings Type: Button, On Click: “Import settings from the selected file”.	3.3	Always
84	Export Settings Type: Button, On Click: “Export current property settings to a ‘json’ file”.	3.3	Always
85	Disable Script Type: Checkbox, Default value: unchecked, On Click: “Prevent Core Functions to execute”.	0.2	Always
86	Disable Features Type: Checkbox (shows the group below), Default value: unchecked, Group: “Disable or Enable Plugin Features - Check [x] = enabled”, each item a Checkbox, default checked: Split Seconds Toggle, Timer Time Split/Lap, Marker Settings, Text Colour [Normal], Text Colour [Marker A], Text Colour [Marker B], Recording, Timer Text Prefix, Timer Text Suffix, Timer Activation, Timer Manipulation, Debugging, Backup.	5.1	Always

Video tutorial: Download and install the Script
Getting started with a basic Count Up timer
Exploring advanced features for a Count Up timer.
Getting started with a basic Count Down timer
Exploring advanced features for a Count Down timer [Tutorial Coming Soon]
Exploring advanced features for any timer mode [Tutorial Coming Soon]
Upgrading from an earlier version: in OBS > Tools > Scripts, remove the old StopWatch script first, then add StopWatch-[6.0].lua. Running both would give you two timers.
Need help? Turn on Enable debug logging, reproduce the problem, and attach the log file to your post.

Reactions: NCC24656, clear4blue and Presm

GrumpyDog

Then you owe me another star because it is already possible. Simply duplicate the Script and give it a unique name and add it in the script index with the first one. You can add several scripts if your system can support it. Check the Main Description page, it includes some links for video tutorials.

OBS Lua Comprehensive Stopwatch & Countdown Timer 6.0