Date condition
The "Date" macro condition allows you to check the current date/time.
Simple settings
Day of the week selection
The first dropdown lets you pick the day of the week.

You can set it to "Any day" if you will only be checking the time.
Time of day
The checkbox at (2) enables time checking and you can type the time at (3). The format is in hours:minutes:seconds and only 24-hour format is supported. The supported check types at (1) are:
- At - Whether the current time is exactly the specified time.
- Before - Whether the current time is before the specified time.
- After - Whether the current time is after the specified time.
Note that the time checks will only be done if the current day of the week matches the specified day of the week.
Advanced settings
You can click "Show advanced settings" to switch to the advanced settings, where you can specify exact dates and additionally check if the current date/time is between the specified range.
Date and time selection
The checkbox at (2) enables the date check at (3), while the checkbox at (4) enables the time check at (5). The time uses the same time format in simple settings.
Although you can type the date manually at (3), you can also click the arrow beside it to select the date from a calendar.
The advanced settings adds a "Between" check type, allowing you to set a date/time range.
Repeat with interval
You can set the condition to return true every X seconds, minutes, or hours by ticking the checkbox at (1). This will make it so once the date/time condition on top is met, the condition will repeat continuously with the specified interval.
Ticking the checkbox at (3) will update the selected date/time to the date/time that the repeat feature will activate next, which is shown at (2). This means that if you set the repeat interval to 5 seconds, the date/time you selected will be incremented by 5 seconds every time the repeat feature activates. This can be useful if you will have to restart OBS during the repeat interval, so that the condition will be executed again, as long as the next match time will still be met. If you are using this feature with the "Between" check type, both the start date/time and the end date/time of the date range will be incremented.
Switch back to simple settings
Clicking this button will switch it back to the simple settings of the date macro condition.
Home
FAQ
Example guides
- Installation
- Show webcam only when speaking
- Twitch Category Changer
- Hotkeys to control counter in text source (e.g. death or win counter)
- Show text source with latest Twitch follower
- Detect elements on screen and hide them automatically
- Motion detection
- Start other programs when starting OBS
- Crossfading audio during scene changes
- Looping a set of media sources
- Switch scenes randomly
- Re-shuffle VLC source
- Automatically switch scene if a game capture's target window no longer exists
- Audio based scene switching in podcast setting
- Switching scenes based on portrait or landscape mode resolution of a window capture source
- Set up a hotkey to start and stop recording with a fade from and to black
- Automatically cycle through a list of scenes
- Toggle visibility of scene items on a timer
- Advance through a list of scenes by hotkey
- Performing actions only when transitioning from A to B
- Media playlist with commercial interruptions
- Split recording of stream into chunks
- Switching scenes for Aitum Vertical plugin
- Using MIDI devices
- Controlling audio source volume using MIDI devices
- Change capture window of Window Capture source
- Show URLs in clipboard in browser source
- League of Legends process based scene swtich
- Push-to-show source
Explanations
- General tab overview
- Starting and stopping the plugin
- Macros explained
- Macro tab overview
- Creating a macro
- Pausing macros
- Macro duration modifiers
- Macro docks
- Exporting and importing individual macros
- Audio condition
- Cursor condition
- Date condition
- Hotkey condition
- Media condition
- Process condition
- Scene item transform condition
- Slide Show condition
- Video condition
- Audio action
- Http action
- Hotkey action
- Random action
- Scene item visibility
- Sequence action
- Action Queue example
- Variables
- Macro properties
- Websockets
- Scripting
- Troubleshooting
- Saving and loading settings





