⬇️ Desktop Client

StreamTracker Desktop Companion

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.

Checking the published desktop release…

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.

  1. Run the new Windows beta. Enter your StreamTracker key on Account & Access.
  2. Open TikTok LIVE Tools and verify access. Start your TikTok LIVE, enter its @handle, and connect.
  3. Choose a goal and color, then add the local 960 × 360 Browser Source to OBS. Keep the app open for LIVE events.
  4. Use Overlays & Alerts for website overlay shortcuts. Avatar capture remains optional and separate.

Streamer starts at $3.99/month →

Avatar tools & existing macOS downloads
🖥️
Existing Avatar client
Windows 10 / 11 Avatar tools Mac source package available
⬇️ Download for Windows (.exe) 🍎 Download for macOS (.zip)
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:
  1. Unzip the download
  2. Right-click RUN_MAC.command → Open → Open (first time only; after that just double-click)
  3. 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.