TikTok LIVE tools for creators, OBS overlay shortcuts, and optional AI Avatar tools—with separate controls for each.
TikTok LIVE · Windows desktop beta
For music, art, conversations, demos, and games. Show community goals in OBS, follow chat activity, and rehearse with sample events. No TikTok password, TikFinity installation, or AI credits required.
Requires Windows 10/11, your existing TikTok LIVE access, and OBS on the same PC. Real events require Streamer or Streamer AI. Test mode uses sample events. The LIVE connection is unofficial.
Run the new Windows beta. Enter your StreamTracker key on Account & Access.
Open TikTok LIVE Tools and verify access. Start your TikTok LIVE, enter its @handle, and connect.
Choose a goal and color, then add the local 960 × 360 Browser Source to OBS. Keep the app open for LIVE events.
Use Overlays & Alerts for website overlay shortcuts. Avatar capture remains optional and separate.
Windows: no installation — run the .exe directly. SmartScreen may warn on first run; click "More info → Run anyway".
macOS: this is the existing Avatar/source package; the TikTok LIVE beta is Windows-first. Mac setup needs Python 3 (one-time install), then:
Unzip the download
Right-click RUN_MAC.command → Open → Open (first time only; after that just double-click)
Say yes to the Screen Recording, Microphone, and Input Monitoring permission popups (Input Monitoring is what makes the talk hotkey work while you're in-game — if you missed it: System Settings → Privacy & Security → Input Monitoring → enable your terminal, then relaunch)
Full walkthrough is in the README_MAC.md inside the zip. Voice push-to-talk: hold fn+F5, use the Hold-to-talk button on the Advanced tab, or the browser panel.
🤖 Bringing your own AI agent? Grab the
co-host skill — paste it into your
agent (OpenClaw skill, system prompt, anywhere) and it knows the whole session loop: instant
voice reactions, when to look at your screen, credit etiquette. Want your agent to stay
itself instead of playing a character? Use the
minimal loop skill — just the
react-to-voice loop, nothing else. MCP-native agents can also pull either directly from the
server (prompt names: cohost,
loop).
TikTok LIVE — for creators beyond gaming
📡
Connect by @handle
Start your TikTok LIVE and connect with its handle. No TikTok password or TikFinity installation. Your account must already have LIVE access.
🎁
Viewer events & alerts
Likes and chat activity, plus configurable gift, follow, subscription and share reactions. Gift streaks count when complete. The LIVE transport is unofficial.
🎯
Community goals
Count likes, followers, gift units, gift coins, shares or subscriptions. Quick presets give you a starting title and target. Coin counts are not cash earnings.
🎨
Your colors & game matching
Pick a color or preset, or click to match the game tracked on the website. Optionally add its name to your goal. Matching is on request; progress is kept.
💬
Chat & !goal
Watch chat in a bounded local activity feed. Viewers can type !goal to show the goal on screen; this does not send an outbound TikTok chat message.
🧪
Rehearse, pause & review
Try sample events, pause reactions, set alert cooldowns and gift thresholds, choose an optional tone, and export a session summary. Test and LIVE counters stay separate.
📺
Local OBS output
A transparent 960 × 360 browser source shows alerts and goal progress. OBS runs on the same PC; keep Desktop open while using this TikTok source.
🔑
Separate from AI
Real LIVE events use your Streamer or Streamer AI access. Test mode is available without a paid plan. TikTok tools do not require Avatar capture or AI credits.
Website overlays — convenient desktop shortcuts
Copy & preview sources
Load your account links and copy or preview the Smart game tracker, vertical tracker, and achievement celebration source. Source availability follows your plan.
Customize on the website
Browse the Overlay library and open settings in Studio. Website-hosted trackers and celebration overlays keep working when Desktop is closed.
What's new
Windows beta 2.4.6 — creator tools in one companion
Separate TikTok LIVE and AI Avatar pages; read-only overlay shortcuts; community goal presets; manual colors and one-click matching to a website-tracked game. The download above becomes available when the new release files are published.
v2.3.1 — macOS + bring-your-own-agent
• macOS support: native screen grab (no OBS required), one-command setup via RUN_MAC.command, and a global push-to-talk hotkey built on Apple's Quartz event taps (grant Input Monitoring once). Extensive stability work: connect freeze, emoji rendering crash, and voice-enable crash all fixed.
• Agent mode: check one box and your own AI (via the MCP server) does the thinking — the built-in brain stays silent. Frame feed selectable down to 6 seconds (free, no credits).
• Every push-to-talk line now ships with a screenshot of that exact moment, skipped automatically when the screen hasn't changed.
• Your agent can demand a live screenshot any time with get_latest_frame {"fresh": true}.
• Hold-to-talk button + window hotkey as no-permission-needed voice fallbacks; fixed mic stutter while holding the talk key.
• Older API keys (pre-st_) and pasted panel URLs now accepted at Connect.
v2.2.0 — UI overhaul
• Sidebar navigation replaces the old top tabs — clearer hierarchy with icons + active accent stripe.
• Persistent quick-actions bar: Start/Stop capture and Capture now from any tab.
• Collapsible activity log (toggle with Ctrl + /) frees up vertical space.
• Tighter, more modern spacing and typography across all panels.
• Builds are now produced automatically by GitHub Actions for every release.
v2.1.0 — Voice + chat
• Push-to-talk voice with ElevenLabs Scribe transcription bundled into the next capture.
• Twitch chat command + raid/sub/cheer event triggers with cooldown.
• Game-state agents (LoL, Steam, Xbox) feed structured context into prompts.
v2.0.0 — Initial v2 release
• Rewritten desktop client with dark theme, OBS WebSocket capture, scene-change skipping, and panel bridge for the browser overlay.
Optional AI Avatar tools
These tools are separate from TikTok LIVE. Connect Avatar only when you want AI reactions. Capture and voice have their own controls; AI credit and provider rules apply.
📸
Auto Screen Capture
Captures your desktop on a configurable interval (1 – 15 min) and sends it to your vision AI.
🎙️
Push-to-Talk Voice
Hold a hotkey to speak directly to your avatar. The transcript is included with the next capture.
🎬
OBS Source Capture
Connect via OBS WebSocket to capture a specific scene source instead of the whole desktop.
⏱️
Live Countdown Timer
See exactly when the next capture fires. Skip unchanged scenes automatically to save API credits.
🎮
Game State Context
Paste custom context — current boss, score, etc. — so the avatar's comments are more relevant.
🔗
Panel Bridge
Connects to the browser overlay panel over WebSocket for real-time avatar animations.
📝
Session & history
Review Avatar replies, session status and usage information. Keep the activity log collapsed until you need it.
🤖
Your setup, your agent
Load your Avatar Studio setup or use the supported bring-your-own-agent/MCP workflow. Personality, voice, provider and credit choices stay separate from ordinary LIVE tools.
Get started with your tool
1
Download & Run
Download the new Windows beta above when available. It is a single-file desktop app. Existing Avatar downloads remain separate below it.
Windows SmartScreen may flag unsigned executables. Click More info → Run anyway to proceed. The app makes no system changes.
2
Paste Your API Key
Open Account & Access and enter your StreamTracker API key. It is not your TikTok password or Steam API key. Choose the tool you want to use.
Get your API key from Account → API Keys on streamtracker.cloud.
3
Choose TikTok, overlays, or Avatar
For TikTok LIVE Tools, verify access, start your LIVE, and enter its handle. For Overlays & Alerts, load your source links. For AI, choose Connect Avatar and configure capture separately.
4
Add your source and test it
Copy the source into OBS, use the size shown, and visually confirm a sample. Keep Desktop open for local TikTok events. Website overlays keep running without it. Avatar Session shows AI replies when you enable those tools.
System Requirements
Component
Requirement
OS
Windows 10 or Windows 11 (64-bit)
Required
Internet
Active internet connection to streamtracker.cloud
Required
API Key
StreamTracker account with an active API key
Required
OBS WebSocket
OBS Studio 28+ (for OBS source capture mode)
Optional
Microphone
Any input device (for push-to-talk voice)
Optional
Running from Source (Mac / Linux)
Python 3.11+ required. Clone the repo, then:
cd desktop_client_v2 pip install -r requirements.txt python main.py
The GUI uses Tkinter (included with most Python distributions). On Ubuntu/Debian: apt install python3-tk
Make it look like your stream
Customize website overlays in the library, or configure your optional AI companion in Avatar Studio.