ASTO-BOT is an all-in-one Twitch stream management tool for Windows. It connects directly to Twitch, OBS Studio, and AI services, letting you automate your stream without writing a single line of code — but also giving you a full scripting language if you want to go further.
Download · Discord · Support on Ko-fi · User Manual 🇬🇧 · Benutzerhandbuch 🇩🇪
- AI-powered event responses — follows, subs, raids, bits, channel points and more trigger AI-generated or fixed chat messages with a custom bot personality
- 36 Twitch triggers — from Follow and Hype Train to Watch Streak, Charity and Shared Chat (Stream Together)
- OBS Integration — switch scenes, show/hide sources, set GDI text and browser URLs, rotate scenes, take screenshots and save the replay buffer
- ASTOSCRIPT — built-in scripting language with variables, conditions, loops, lists, file access, HTTP requests and OBS control, plus a live debugger and an AI prompt generator
- Visual Overlay Editor — build animated overlays (images + text) for OBS Browser Source or Window Capture, with per-step sounds and multiple timelines
- Browser Overlay — a transparent, click-through desktop window for web-based overlays, controlled live via script, event or WebSocket
- Clip Manager — browse, label and play Twitch clips via clip lists, playlist or chat command
- Giveaway & Points System — viewers earn custom points over time and spend them to enter giveaways (ticket draw or highest-bid mode)
- Photo Mode — live group photo sessions where viewers join via chat command and appear on stream
- Moderation & Chat Modes — ban, timeout, VIP, warnings, shield mode, followers-only, emote-only, sub-only, slow and unique chat, all as event actions
- Now Playing — reads what is playing in Spotify, Apple Music or a browser and controls the player from an event
- Stream Deck & WebSocket — trigger events, scripts, overlays, clips, the browser overlay and photo mode from any external tool on port 2519
- Channel Point Rewards — create, edit and link rewards directly from ASTO-BOT (required for refund support)
- Chat Commands — configurable commands with permission levels, cooldowns and group management
Everything at a glance: connection status for Twitch and OBS, what is running right now, and the live chat next to it.
An event is a trigger plus a list of actions. Pick what should set it off — a follow, a raid, a channel point reward, a chat command — and ASTO-BOT does the rest.
Actions run top to bottom. Send a chat message, play a sound, start an overlay, switch an OBS scene, run a script — combine as many as you like, with permissions and cooldowns per event.
Over a hundred ready-made actions, sorted by category. No code needed.
For everything the ready-made actions do not cover: a real scripting language with variables, conditions, loops, file access and HTTP requests. Syntax highlighting, autocomplete and a live debugger are built in — and if you would rather not write it yourself, Copy AI Prompt hands the job to an AI.
Browse your channel's clips, sort them into lists, and play them on stream — manually, as a playlist, or by chat command.
Build animated overlays from images and text: drag them into place, give each element a timeline, add sounds per step. Runs as an OBS browser source or as a transparent window for window capture.
Viewers collect points just by watching and spend them to enter. Draw a random winner, or let the highest bid win.
Viewers join a group photo by chat command and appear on stream together — with backgrounds, text effects and a countdown.
- Download
ASTO-BOT_Installer.exefrom the Releases page. - Run the installer and choose an installation folder, e.g.
C:\Program Files\ASTO-BOT\ - Follow the installer instructions — ASTO-BOT starts automatically after installation.
- Go to Settings → Twitch and connect your Streamer and Bot accounts.
- Optionally connect OBS via Settings → OBS (WebSocket, default
ws://127.0.0.1:4455).
⚠ To uninstall, use Control Panel → Programs → Uninstall ASTO-BOT or the included
uninstall-asto.exe. Never delete the folder manually.
- Windows 10 or Windows 11 (64-bit)
- Internet connection (for Twitch authentication and AI features)
- An API key from an AI provider (Google Gemini or OpenAI) — only needed for the AI features
- OBS Studio 28 or later (optional, for overlay and scene automation)
Open Settings → Twitch, click Connect next to Streamer, log in, then repeat for Bot. Open Settings → AI, enter your Gemini or ChatGPT API key and configure your bot’s personality.
Then run Settings → System Check — it tells you what is still missing.
Go to Events, click + Add Event, select a trigger (e.g. Follow), then click + Action to add what should happen — a chat message, a sound, an overlay, an OBS scene change, or anything else. Press Simulate to test the event without waiting for a viewer.
Go to Scripts, create a new script, and write ASTOSCRIPT. Click Tutorial to open the built-in reference, or use Copy AI Prompt to let an AI write the script for you.
# Example: greet a subscriber and play a sound
CHAT "Welcome to the sub club, " + %UserName% + "! 🎉"
SOUND "fanfare.mp3" VOLUME 80
WAIT 2
OBS SHOW "Main" "Sub Cam"
| Command | Description |
|---|---|
SET $var = value |
Set a variable |
CHAT "text" |
Send a message to Twitch chat |
WAIT 5 |
Wait 5 seconds (WAIT 500 MS for milliseconds) |
SOUND "file.mp3" VOLUME 80 |
Play a sound |
OBS SHOW "scene" "source" |
Show a source (OBS HIDE hides it again) |
BROWSER ON / OFF / URL / VOLUME |
Control the browser overlay |
IF / ELSE / END |
Conditional logic |
WHILE / END |
Loop while a condition holds |
REPEAT 5 / END |
Loop a fixed number of times |
TRY / CATCH / END |
Catch errors, e.g. a missing file |
HTTP GET "url" $result |
Make an HTTP request (HTTP PUT for sending data) |
JSON $data "path" |
Read a value out of a JSON response |
AI PROMPT $prompt $answer |
Let the AI generate an answer |
FILE READ / FILE WRITE |
Read from and write to text files |
LIST SPLIT / APPEND / POP / JOIN |
Work with lists |
GLOBAL SET / GET / CLEAR |
Variables that survive beyond the script |
RANDOM 5 30 |
A random number |
MUSIC NOW |
Read what is currently playing |
OPEN "url" / CLOSE_TASK "app.exe" |
Open a link, close a program |
STOP |
Terminate the script |
All built-in event variables (%UserName%, %CheerAmount%, %IsSubscriber%, …) are available in scripts, events, and overlays.
The complete command reference lives in the built-in tutorial: Scripts → Tutorial → Glossary.
ASTO-BOT listens on ws://127.0.0.1:2519 (local only — not reachable from the network). Send JSON to control it from any tool, including the Elgato Stream Deck (Web Requests plugin):
// Scripts & Events
{ "script": "my_script_name" }
{ "event": "greeting" }
{ "event": "shoutout", "input": "username" }
// Clips
{ "playlist": "start" }
{ "playlist": "stop" }
{ "clip": "play" }
{ "clip": "pause" }
{ "clip": "stop" }
{ "clip": "replay" }
{ "clip": "volup" }
{ "clip": "voldown" }
// Queues
{ "queue": "play", "name": "Default" }
{ "queue": "stop", "name": "Default" }
{ "queue": "reset", "name": "Default" }
{ "queue": "reset" } // resets ALL queues
// Overlay
{ "overlay": "overlay_name" }
// Browser Overlay
{ "browser": "on" }
{ "browser": "off" }
{ "browser": "toggle" }
{ "browser": "reload" }
{ "browser": "interact_on" } // overlay catches clicks
{ "browser": "interact_off" } // clicks pass through again
{ "browser": "interact_toggle" }
{ "browser": "url", "name": "sticker" } // from the saved URL collection
{ "browser": "url", "url": "https://…" }
// Photo Mode
{ "photo": "start", "user": "username" }
{ "photo": "stop" }
{ "photo": "join", "user": "username" }
{ "photo": "next_bg" }
{ "photo": "prev_bg" }
{ "photo": "snap" }
{ "photo": "timer_stop" }
{ "photo": "select" }
{ "photo": "skip" }
{ "photo": "finish" }
// Other
{ "ping": true } // answers { "pong": true }
{ "game_result": { "key": "aale_roll", "value": 4 } }Every message is answered exactly once and in order — { "ok": true } when it was accepted, or { "ok": false, "error": "…" } with a reason when it was not.
For events, use the signal name (shown under the event name), not the display name or the chat trigger. Upper/lower case does not matter, and events without a trigger work fine. For everything else, the name is used.
The port can be changed under Settings → Websocket, where this list is also available with click-to-copy.
ASTO-BOT runs entirely locally. All configuration files live in the installation folder:
| Path | Contents |
|---|---|
Config/asto_secure.bin |
Tokens & passwords (encrypted) |
Config/ |
All other settings |
Scripts/ |
Your ASTOSCRIPT files |
Overlays/ |
Overlay definitions |
Sounds/ |
Audio files |
PhotoMode/ |
Photos taken in Photo Mode |
Use Settings → Backup to create a full backup archive at any time.
Join the Discord server for help, feature requests and updates: discord.gg/n2nstVwspk
If you enjoy ASTO-BOT and want to support the development: ko-fi.com/captainapolloo ☕