Get Started


A brief introduction to

Your Bot

  • With, the bot is yours! is a local bot, meaning all connections are made directly from your local PC to any configured external services, such as Twitch, YouTube, etc.

This means you have full ownership and control of any data stored in, and your bot does not depend on a central 3rd party service to continue operating.


While allows for very advanced functionality, it can be used by experts and novices alike.

In all cases, it is important to understand the basic fundamental building blocks of creating with

  • Actions & Sub-Actions
  • Triggers & Events
  • Variables

In this guide, we'll walk you through each of these concepts step-by-step.

Actions & Sub-Actions

Actions are the backbone of, as they act as the core entity responsible for both creating & organizing your logical pieces (sub-actions), and for executing all of that logic at once.

Simply put, an action can consist of one or more sub-actions, and can react to one or more triggers.

Learn more about sub-actions and triggers below.


Sub-Actions are the individual logical pieces of your actions which allow you to perform a wide range of various interactions.

There are currently more than 200 sub-actions available in, such as:

Explore all available sub-actions in the Sub-Actions API References

You can combine as many of these together as you wish to create complex interactivity, or simply use a single sub-action to do something like send a message to your stream chat.

  • If you can think of it, chances are you can do it with Sub-Actions!
If you have any suggestions for new Sub-Actions, you can submit them to Ideas & Suggestions

Triggers & Events

Events occur whenever something happens on any of your configured services or integrations.

Any of these events can then be used as a trigger to execute your configured actions.

There are currently over 150 triggers available in, such as:

Explore all available triggers in the Triggers API References

Actions can be executed by multiple triggers, and you can assign the same trigger to multiple actions.

Most triggers will also provide a set of variables with related event data that then can be used by any sub-actions.


Whenever one of your actions executes, there will always be a set of data values associated with it, called variables.

Variable Sources

Variables can come from triggers, which often contain a set of related event data, and they can also come from previous sub-actions within an action.

For example, the Twitch Chat Message Trigger will provide you with various variables, including the name of the chatter, and the message content.

In another example, the Get Random Number Sub-Action will provide you with a variable containing a random number value.

Using Variables

Variable names and example values are documented throughout the Triggers Reference and Sub-Actions Reference pages.

To access these values in subsequent sub-actions, you can wrap the variable name with percent symbols.

For example, a variable named randomNumber can be accessed within configuration text boxes of subsequent sub-actions by typing %randomNumber%.

  • Variables are always case-sensitive

Action History

You can use the action history view to inspect any variables that were populated within a given action.

This view can be found by navigating to Action Queues -> Action History

Here you will see a list of all previous action executions. To inspect the variables generated by a specific action, right-click the row and select Inspect Variables After Run.

Variable Types

When you begin to build more complex interactions with, you will probably want to store data that can be accessed across multiple actions, permanently persisted, or event store data for specific users. provides variable types for each of these use cases, Global Variables and User Variables

Start Building

Now that you have a basic understanding of these building blocks, you're ready to start building!

Continue to the installation guide below, or explore further into the Configuration Guide and full API References documentation.

Welcome to, enjoy your stay!