> ## Documentation Index
> Fetch the complete documentation index at: https://docs.1up.vision/llms.txt
> Use this file to discover all available pages before exploring further.

# Chat Timer Bot

> Schedule automatic Twitch chat messages. Post social links, announcements, and reminders on a timer.

## Chat Timers

Timers automatically post messages to your chat at scheduled intervals. Use them to remind viewers about social links, announce events, or trigger overlay actions on a schedule.

***

## Creating a Timer

<Steps>
  <Step title="Go to Chatbot">
    In the dashboard sidebar, click **Chatbot**
  </Step>

  <Step title="Click Timers">
    Select the **Timers** tab
  </Step>

  <Step title="Create Timer">
    Click **Create Timer**
  </Step>

  <Step title="Add messages">
    Enter the messages to post
  </Step>

  <Step title="Set schedule">
    Configure when and how often to post
  </Step>

  <Step title="Enable">
    Toggle the timer on
  </Step>
</Steps>

***

## Timer Settings

### Messages

Add one or more messages to the timer:

* Multiple messages rotate in sequence
* Each message posts on the next interval
* Use variables for dynamic content

***

## Interval Scheduling

Set different intervals for online and offline:

### Online Interval

How often to post when you're live:

* Example: Every 15 minutes during stream

### Offline Interval

How often to post when you're offline:

* Set to 0 to disable when offline
* Useful for 24/7 channels or reruns

***

## Multiple Messages

Add variety with multiple messages:

1. Click **Add Message**
2. Enter additional messages
3. Messages rotate in order
4. Keeps chat fresh without repetition

**Example rotation:**

1. "Follow me on Twitter @username!"
2. "Join our Discord: discord.gg/xxx"
3. "Subscribe for alerts and emotes!"

***

## Overlay Actions

Timers can trigger overlay changes:

### Trigger Rotations

Automatically advance logo rotations on schedule.

### Modify Layers

Update counters or other layer values at intervals.

<Steps>
  <Step title="Create timer">
    Set up messages and schedule
  </Step>

  <Step title="Add action">
    Click **Add Action**
  </Step>

  <Step title="Select overlay">
    Choose the target overlay
  </Step>

  <Step title="Select layer">
    Choose which layer to control
  </Step>

  <Step title="Configure">
    Set the action details
  </Step>
</Steps>

***

## Conditions

Control when timers run:

| Condition        | Description                     |
| ---------------- | ------------------------------- |
| **Online only**  | Only post when streaming        |
| **Offline only** | Only post when offline          |
| **Channel**      | Only in specific channels       |
| **Game**         | Only when playing certain games |

***

## Managing Timers

### Enable/Disable

Toggle timers on or off without deleting them:

* Quickly disable during special events
* Re-enable when ready

### Edit

Modify timer settings anytime:

* Change messages
* Adjust intervals
* Update conditions

### Delete

Remove timers you no longer need.

***

## Examples

### Social Media Reminder

```
Messages:
1. "Follow me on Twitter for stream updates! @username"
2. "Join the Discord community: discord.gg/xxx"
3. "Don't forget to follow the channel!"

Interval: Every 20 minutes (online only)
```

### Sponsor Mention

```
Messages:
1. "Today's stream is sponsored by Example Co! Use code STREAMER for 10% off."

Interval: Every 30 minutes (online only)
```

***

## Tips

<Tip>
  **Don't spam** - Set intervals of at least 10-15 minutes to avoid annoying viewers.
</Tip>

<Tip>
  **Use multiple messages** to keep timer posts varied and interesting.
</Tip>

<Tip>
  **Disable offline** unless you have a specific reason for 24/7 posting.
</Tip>