Extensions

Setup

1. Ensure you’re on the latest version of SAMMI.
2. 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 you wish to be triggered once it goes off:
   • Right click on a button within a deck
   • Select ‘Edit Triggers’
   • Click on 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.

Parameter	Description	Example
Minute	The specific minute after the hour	15 (activates at 1:15, 2:15, etc.)
Trigger Name	Name for the trigger	Hourly Reminder

Daily Trigger

Command name: DateTime Triggers: Add Daily Trigger

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

Parameter	Description	Example
Hour	The specific hour and minute to trigger	08 (triggers at 8:00 AM)
Minute	The specific minute after the hour	00 (triggers at 8:00 AM)
Trigger Name	Name for the trigger	Morning Alarm

Weekly Trigger

Command name: DateTime Triggers: Add Weekly Trigger

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

Parameter	Description	Example
Day	The specific day(s) to trigger	Monday, Wednesday
Hour	The specific hour to trigger	12 (triggers at 12:00 PM)
Minute	The specific minute after the hour	00 (triggers at 12:00 PM)
Trigger Name	Name for the trigger	Weekly Update

Monthly Trigger

Command name: DateTime Triggers: Add Monthly Trigger

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

Parameter	Description	Example
Day of Month	The specific day of the month to trigger	1 (triggers on the 1st of every month)
Hour	The specific hour to trigger	00 (triggers at 12:00 AM)
Minute	The specific minute after the hour	00 (triggers at 12:00 AM)
Trigger Name	Name for the trigger	Monthly Report

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.

Parameter	Description	Example
Month	The specific month to trigger	August
Day	The specific day of the month to trigger	25
Hour	The specific hour to trigger	14 (triggers at 2:00 PM)
Minute	The specific minute after the hour	15 (triggers at 2:15 PM)
Trigger Name	Name for the trigger	Yearly Celebration

One-Time Trigger

Command name: DateTime Triggers: Add One Time Trigger

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

Parameter	Description	Example
Year	The specific year to trigger	2024
Month	The specific month to trigger	August
Day	The specific day of the month to trigger	30
Hour	The specific hour to trigger	14 (triggers at 2:00 PM)
Minute	The specific minute after the hour to trigger	15 (triggers at 2:15 PM)
Trigger Name	Name for the trigger	One-Time Event

Date

Command name: DateTime Triggers: Add Date Trigger

Advanced command to create a trigger based on a specific date. It’s handy when the date comes from existing services or APIs, like Twitch, so there’s no need for manual conversion.

The following date formats have been tested and are fully supported:

• 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)

If you’re working with a new date format, please try adding it first. After that, go to the “DateTime Triggers” tab in the Bridge and double-check that the trigger has been added correctly with the accurate date.

Parameter	Description	Example
Date	The specific date to trigger	2024-08-25T14:15:22Z
Trigger Name	Name for the trigger	Special Event

Date Range Condition

Command name: DateTime Triggers: Add Date Range Condition

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

Parameter	Description	Example
Start Year	The start year for the date range	2024
Start Month	The start month for the date range	September
Start Day	The start day for the date range	1
End Year	The end year for the date range	2024
End Month	The end month for the date range	September
End Day	The end day for the date range	30
Trigger Name	Existing Trigger Name	Seasonal Event

Custom Condition

Command name: DateTime Triggers: Add Custom Condition

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

Parameter	Description	Example
Stream Status	The stream status to trigger on	Live
Stream Category	The stream category to trigger on	Just Chatting
Viewer Threshold	The minimum viewer count threshold to trigger on	50
OBS	Triggers only if OBS is connected/disconnected from SAMMI	Connected
OBS Scene	The OBS scene to trigger on	Main Scene
Variable Name == Value	Triggers only if the variable has the specified value	IsLive == true
Trigger Name	Existing Trigger Name	My Daily Trigger