DateTime Triggers

DateTime Triggers is an extension that allows you to trigger buttons in SAMMI based on date and time triggers, including custom conditions like whether you're live or if a variable has a specific value.

Features

Available Trigger Types:

• Hourly: Triggers at a specified minute after every hour.
• Daily: Triggers at a specified hour and minute every day.
• Weekly: Triggers on specified days at a set hour and minute.
• Monthly: Triggers on a specified day, hour, and minute every month.
• Specific Day of the Year: Triggers once a year on a specific day, hour, and minute.
• One-Time Trigger: Triggers on a specified date and time.
• Trigger from Date: Triggers only within a specified date range.

Date Range Condition:

• Set a date range condition for an existing trigger to only activate within a specific date range.

Custom Conditions:

• Stream Status: Triggers based on your Twitch stream status (Live/Offline).
• Stream Category: Triggers based on your current Twitch stream category.
• Viewer Threshold: Triggers based on a minimum Twitch viewer count.
• OBS: Triggers based on whether OBS is connected or disconnected.
• OBS Scene: Triggers based on a specific OBS scene.
• Variable Name == Value: Triggers based on a specific variable having a specific value.

Setup

1. Install the extension. You can follow the Extension Install Guide.

To Set Up a DateTime Trigger

1. Fill out and run the 'DateTime Triggers: Add X Trigger' command, depending on the trigger type you need.
2. Attach the extension trigger to any button in SAMMI that you wish to be triggered when it goes off:
   • Right-click a button within a deck.
   • Select Edit Triggers.
   • Click the + icon to add a new trigger.
   • Select Extension Trigger from the dropdown.
   • The Message field should be the name of the trigger you set up in the DateTime Triggers extension command.

Key Points to Remember

• This only needs to run once; the trigger will persist even after restarting SAMMI.
• Bridge must be running and connected to SAMMI at all times for this to work.

Hourly Trigger

Command name: DateTime Triggers: Add Hourly Trigger

To set up an hourly trigger, specify the minute after the hour when the trigger should activate.

Daily Trigger

Command name: DateTime Triggers: Add Daily Trigger

To set up a daily trigger, specify the hour and minute.

Weekly Trigger

Command name: DateTime Triggers: Add Weekly Trigger

To set up a weekly trigger, specify the days, hour, and minute.

Monthly Trigger

Command name: DateTime Triggers: Add Monthly Trigger

To set up a monthly trigger, specify the day, hour, and minute.

Specific Day of the Year Trigger

Command name: DateTime Triggers: Add Specific Day Trigger

To set up a specific day trigger, specify the month, day, hour, and minute.

One-Time Trigger

Command name: DateTime Triggers: Add One-Time Trigger

Create a one-time trigger based on a specific date.

Date Trigger

Command name: DateTime Triggers: Add Date Trigger

Advanced command to create a trigger based on a specific date. This is handy when working with dates from services like Twitch.

Supported formats:

• Twitch/ISO 8601 (e.g., 2024-08-25T14:15:22Z)
• RFC 2822 (e.g., Tue, 27 Aug 2024 22:35:00 PDT)
• Unix timestamps (e.g., 1724829572)

Date Range Condition

Command name: DateTime Triggers: Add Date Range Condition

Attach to an existing trigger to only activate within a specific date range.

Custom Condition

Command name: DateTime Triggers: Add Custom Condition

Attach to an existing trigger to only activate when specific conditions are met.