Aquilo Bot

Custom commands, timers, auto-mod, quotes, the Bolts economy with minigames, counters with OBS overlays, and your dock — hosted in the cloud, nothing to install. Song requests live in Jukebox.

Health Last stream recap →

Connect Twitch Not connected

We watch your channel's chat, cheers, and reward redeems.

Connect Twitch

Connect Spotify Not connected

Requests queue to this account. (Spotify Premium required to queue.)

Connect Spotify

Your Spotify app Required

Spotify now requires each streamer to register their own (free) app before connecting: 1. Create an app at developer.spotify.com/dashboard (any name, check the "Web API" box). 2. In its settings, add this exact Redirect URI: /auth/spotify/callback 3. Paste the app's Client ID and Client Secret here and save.

Command ! Per-viewer cooldown sec

🎚️ Who can request with !sr

Bits and Channel Points (below) always work for everyone — they're their own permission.

Let VIPs bypass this

Mods and you (the broadcaster) can always request.

⏱️ Request limits by role

Off = can't request · Cooldown = the per-viewer cooldown above · Unlimited = no limit · Quota = N requests per window. A viewer gets their highest role's rule. Mods + you are always unlimited; Bits + Channel Points bypass limits.

⚡ Bits cheer

Viewers cheer at least bits with a song in the message to request it.

Cheers aren't armed yet. Reconnect Twitch to grant Bits access.

✨ Bits Power-up

Tie requests to a custom Bits Power-up. In Twitch → Creator Dashboard → Viewer Rewards → Power-ups, create one with "require viewer text" on, then put its exact name here. Viewers use the Power-up and type the song.

Power-up name

Power-up events aren't armed yet. Reconnect Twitch to enable.

🎁 Channel Points

Reward name Cost pts

Redemptions aren't armed yet. Reconnect Twitch to grant Channel Points access.

🟢 Kick points

Enable this and the reward is created on your Kick channel automatically (with "require viewer text" on) — no manual setup. Viewers redeem it and type the song. (Kick has no per-redeem refund, so requests are matched by name.)

Reward name Cost

Connect your Kick channel first (Platforms above).

Kick redeems aren't armed yet. Reconnect Kick to grant the rewards scope.

💚 Kicks (gifts)

Viewers gift at least Kicks with a song in the message to request it.

⚡ Priority request

Viewers spend Bolts to skip the request cooldown/limit (needs the Bolts economy on, in Aquilo Bot). Spotify can't reorder its queue, so this is a paid line-skip — refunded if the song isn't found.

Command ! Cost Bolts

Also play it next — ⚠ this cuts the currently-playing song. Off by default.

📱 QR / web requests

A phone/IRL-friendly request form behind a QR code — no chat typing. Add the QR as an OBS browser source:

Per-viewer cooldown sec

💬 Chat responses

The bot replies in your chat, threaded to the request. Leave a field blank to turn that message off. Placeholders: {user} {title} {artist} {query} {wait} {permission}

Posting as you Use a bot account

When queued

When no match is found

When Spotify has no active device

On cooldown (blank = off, avoids spam)

When not allowed (blank = off)

Chat replies need a new permission. Reconnect Twitch to enable.

Heads up: Spotify only queues when you have it open and playing on a device — that's a Spotify rule. If requests show "no active device", just start a track.

💬 Chat commands

Toggle each command, rename its keyword, or make it mods-only. Viewers type !keyword.

Announce now-playing

Post the track to chat when a new song starts (checked ~once a minute).

!like needs a new Spotify permission — if it says "reconnect", hit Reconnect on Spotify above. !remove can't pull a song out of Spotify's queue (Spotify has no such API), so it just replies with a heads-up.

🌐 Platforms

The bot listens and replies on every platform you connect. Commands, economy, games, quotes, and counters all work cross-platform (each platform's viewers keep their own wallets until they link accounts on aquilo.gg).

Kick Not connected Connect Kick

YouTube Not connected Connect YouTube

🚂 Hype train

A shared hype train that fills from every platform at once — Twitch subs/bits/gifts/raids and YouTube members/Super Chats push the same train up levels against a rolling timer. TikTok gifts + Kick subs join it from StreamFusion. Add the overlay URL to OBS.

Timer s Level 1 points + per level Max level Announce in chat

Open

To feed TikTok gifts + Kick subs from StreamFusion, paste this into SF (it stores as sf_hype_url):

Overlay look

Sleek slim bar by default. Presets set the essentials; tweak anything below.

Style height px

bar start bar end text bar height px label

background font align size

level timer % 🚂 contributors latest glow animate pops 👑 crown throne bar

Rewards

Give the train stakes: pay everyone who fed it when it completes, and fire an action as it levels up.

All-aboard payout — Bolts to every contributor on completion

Bolts / level Split Cap

Post completions + records to the Discord webhook (set on Go-Live)

Per-level triggers

At a chosen level, shout in chat and/or drop a named action into the redeem queue (StreamFusion / Streamer.bot picks it up).

👑 The throne

The top contributor to each train claims a persistent, cross-platform throne — a 👑 on the overlay and a passive Bolts stipend while they reign — until the next train dethrones them.

Stipend Bolts/min Label Announce coronations

🧠 Trivia

Start a round with !trivia — the first correct answer in any connected chat (Twitch/Kick/YouTube) wins Bolts. Race-safe across platforms.

Keyword ! Prize Answer window s Mods only can start

20 built-in questions; add your own on the site later.

📣 Live everywhere

When you go live on Twitch, announce it everywhere at once — a chat line on each connected platform plus a Discord post. Placeholders: {title} {game} {channel} {login}.

Chat announcement

Twitch chat Kick chat YouTube chat Cooldown min

Discord webhook URL (blank = off)

Discord message

TikTok has no chat-send API, so it's not a destination. YouTube posts only while its live chat is up.

🗓️ Go-live schedule

When you go live, the slot matching today's day + time sets your stream title, category and tags automatically (and can post its own chat announce). Runs in the cloud off Twitch's go-live signal — nothing to keep open. Applying title/category needs the newest Twitch permission; if nothing changes on go-live, reconnect Twitch once.

Timezone Match up to min after the slot time

⚡ Custom commands

Your own !commands with template replies. Placeholders: {user} {target} {count} {channel}. With counter on, mods type !cmd + / - / set 5 / reset and {count} tracks it.

🔢 Counters + overlays

Each counter is its own command: !deaths shows it, mods bump it with !deaths + / - / set 12 / reset. Per game tracks a separate tally for each Twitch category you stream in ({total} sums them). Add the overlay URL to OBS as a browser source — style changes apply live. Quick style knobs below; the full overlay customizer (10 fonts, box/border/opacity, layouts, outlines, glow, animations, custom CSS) lives on the Counters page.

📖 Quotes

Viewers pull a random quote with !quote or a specific one with !quote 3. Mods add with add <text> and remove with del <n>.

Keyword !

📣 Auto-messages

Timed messages posted to your chat, each on its own schedule (checked about once a minute).

Only while live Wait for chat lines between posts (0 = off)

📦 Migrate from StreamFusion

Moving off the StreamFusion bot? In SF open Settings → Bot → Copy my bot config, paste it here, and your commands, counters (with their tallies), auto-messages, auto-mod, quotes and go-live schedule import in one shot. Nothing already configured here gets overwritten.

🪙 Economy

A loyalty currency for your chat: viewers earn by watching and chatting, then check !bolts, climb !top, claim !daily, share with !give, and risk it on !gamble. Wallets are shared with the aquilo.gg site + Twitch panel when the community id below matches.

Watch-time earning needs a new permission. Reconnect Twitch to enable (commands + chat earning work without it).

Currency name Community wallet id

Earning

per min watched only while live

per chat message (max one per s, 0 = off)

Daily claim + per streak day (cap days)

Gambling

Win chance % Bet to Cooldown s

Event bonuses

Automatic credits when Twitch events land. Sub bonus scales by tier (x1 / x2 / x4).

Sub Per gifted sub (gifter) Per 100 bits Raid

Chat minigames

All wagers come from the same wallets. !slots · !roulette red|black|green · !duel @user + !accept · !heist (group, 2-min boarding) · !8ball (free).

slots roulette duel heist 8ball

Bet to Heist survive % pays x

Giveaways

Mods run !giveaway start / draw / end; viewers buy weighted entries with !ticket [n].

Ticket cost Max tickets per viewer

Redemption store

Viewers spend with !redeem <item>. Redeems land in a queue your Streamer.bot / StreamFusion polls (URL below) to trigger the actual effect on stream.

Public leaderboard page: /top

Command keywords

balance ! top ! daily ! give ! gamble !

🛡️ Auto-mod

Deletes (or times out) messages that trip a filter. Mods and you are always exempt. Timeout 0 = delete only. A blank warning stays silent. Mods can !permit user to allow a link.

Auto-mod needs two new permissions. Reconnect Twitch to enable.

Also exempt !permit lasts sec

🎛️ Dock + mod line

Add the dock URL to OBS (Docks → Custom Browser Docks) or a StreamFusion webview: counters, giveaway controls, the redeem queue, a mod inbox, and a raid finder with live stream snapshots. Give the mod-line link to your mods — their messages land in the dock, verified against your real mod list.

Open

The dock URL is a remote control for your bot — treat it like a stream key.

🔗 Rotation overlay sync

Using the Rotation OBS overlay too? Paste this link into Rotation's config (Jukebox sync) and the overlay shows your now-playing + queue with who requested each song — read straight from Jukebox, no separate Spotify connect in Rotation.

Anyone with this link can see your now-playing + queue (that's the point — it feeds your overlay). Keep it to your OBS.

💬 StreamFusion

Run StreamFusion too? In StreamFusion → Settings → Connections → Jukebox, paste this link — its now-playing bar then mirrors your Jukebox song + who requested it, just like the Rotation widget does.

Needs StreamFusion updated to the latest version. It's the same link as the Rotation sync above (one feed, both apps can read it).

Recent requests

No requests yet.

Bot status: —