Free OBS Tool by Aquilo

TikTok Gift Guide rotator

A thin bar that cycles through your TikTok gifts: the real gift icon next to what it does (a Crowd Control effect, a sound, whatever you set). Make a profile per game and it auto-switches to the right list using Streamer.bot. Transparent by default; everything's free.

Your gifts

Each row shows one gift and what it equals. Pick from the real TikTok gift list, or choose Custom to paste your own icon URL (e.g. from TikFinity). Use the tabs to keep a separate gift list per game.

Pick the exact Twitch category that should show this profile. Link any profile to any category, no need to rename it. Leave blank to match on the profile name instead.

Import from Crowd Control

Paste (or load) your Crowd Control export. A TikTok events export (.cctiktok) already maps gifts to effects, so it converts 1:1, real gift icons and counts straight from the file. A raw effect-pack JSON has no gift, so each effect's price becomes a count of the trigger gift below (× the multiplier). Random triggers (several effects on one gift) merge into one 🎲 row.

Auto-switch by game Streamer.bot

Connect to Streamer.bot so the bar follows whatever game you're on and shows that game's profile automatically. Leave this off to use a single list.

The overlay reads your live Twitch category directly, no Streamer.bot needed. Link each profile to a Twitch category up in Your gifts (the “Auto-switch when my Twitch category is…” picker), and it follows your stream automatically.

Streamer.bot setup: one-paste import
  1. Make sure the Streamer.bot WebSocket Server is running (Servers/Clients → WebSocket Server → Start; default port 8080). Match the host/port above.
  2. Click Copy import string below.
  3. In Streamer.bot: Import (top bar) → paste → Import. It adds the Gift Guide Sync action (compiles automatically).
  4. Done. The overlay calls this action on load and every few seconds, so the bar follows your game. Optional: also drag this action onto your category/scene-change event for instant switching.

Profiles match by name (case-insensitive). Name each one to match exactly what your source reports.

Live gift reactions (if enabled in Layout): also broadcast {"app":"giftguide","gift":"%giftName%"} from your TikTok-gift handler (a WebSocket Broadcast JSON sub-action) to pulse that gift on the bar when it's sent.

Prefer to set it up by hand?
  1. Create an action named exactly Gift Guide Sync (match the field above).
  2. Add a sub-action Core → C# → Execute C# Code, paste this, and compile:

          

Push to OBS live

Force your live browser source to a specific profile right now. Handy when your Twitch category doesn't match a profile name, or you just want to lock one in. Pin holds it (and overrides auto-switch) until you resume, and it survives a source refresh. Your OBS source URL must include the pairing token; re-copy it from below once.

Layout

Built for vertical / TikTok by default: a full-width bar across the bottom of a 1080×1920 canvas. Switch to Horizontal for a compact pill.

Needs Streamer.bot to broadcast gifts; see the note in the Streamer.bot section. Preview a reaction →

Floating text

Optional headline above and a line below the bar, e.g. “Send a gift = control my game!”. Leave blank to hide.

Look & timing

Shared across all your game profiles, so the bar looks consistent.

Frosts the gameplay behind the bar (no solid fill needed). Heavier in OBS than a flat background, so keep it modest if you see any stutter.

Reset to aquilo.gg colors · GPU-only (transform) animation; it won't lag in OBS even while streaming.

Live preview

Exactly what renders in OBS. Preview over a sample backdrop to judge how the text reads over real gameplay (the shadow is invisible on the dark checkerboard).

Your OBS browser source

Copy this URL into OBS → add a Browser source → paste as the URL. Re-copy it once after this update; it now carries a pairing token so switching profiles here live-previews the OBS source.

Suggested browser-source size: 900 × 90 (drag to reposition; the bar hugs its content).

Your draft saves automatically in this browser. Start over

Stacked list overlay (optional)

A second source that shows every gift at once, stacked top-to-bottom, and slowly auto-scrolls if the list is taller than its source. Same gifts as the bar. Add it somewhere else on your layout. Tall & narrow works great (e.g. 360 × 900). No floating text here.

Free for everyone · Support Aquilo on Patreon for early access · More Aquilo widgets