TikTok

Live chat & emotes

Why TikTok Is Different

Unlike Twitch, YouTube, and Kick, TikTok does not offer a public API for accessing live stream chat. This means ChatEgg cannot connect to TikTok directly the way it does with other platforms.

Instead, TikTok Live connections require a signing server — an intermediary that handles the authentication and request signing that TikTok's internal protocol requires. ChatEgg supports two options:

Euler Stream Recommended

A hosted signing service that handles all the complexity for you. Get a free API key and start watching TikTok Live chat in seconds.

eulerstream.com →

Custom Signing Server

For advanced users who prefer to self-host. You run your own signing server on your local network or a server in the cloud, and point ChatEgg at its URL.

github.com/carcabot/tiktok-signature →

Getting Connected

Step 1: Enter the TikTok username of the live stream you want to watch (without the @ symbol).

Step 2: Choose your connection method — Euler Stream or Custom Server.

If using Euler Stream:

Paste your API key (starts with euler_) into the API Key field.

If using a Custom Server:

Enter the full base URL of your signing server (e.g. http://192.168.1.100:8080). Make sure your phone can reach this address on your network.

Step 3: Tap Save. ChatEgg will connect and start streaming live chat messages.

You can also adjust the Refresh Interval to control how frequently chat messages are polled. The default is usually fine for most streams.

Supported Features

Troubleshooting

Euler Stream not connecting

Make sure your API key is valid and hasn't expired. You can get a new free key at eulerstream.com.

Custom server not working

Verify the server URL is reachable from your phone. The server must be running and accessible on your network. If you're on a different WiFi network than the server, the connection will fail.

Connection drops frequently

Because TikTok does not provide an official API, connections can be less stable than other platforms. TikTok may also apply rate limiting. The app will automatically attempt to reconnect when a connection drops.

"No live stream found" error

Double-check the username spelling (no @ symbol). The user must be actively live on TikTok for the connection to succeed.

Custom server getting blocked

TikTok may temporarily block your signing server if it detects too many requests. If this happens:

  1. Restart your signing server — this often clears the block.
  2. Increase the polling interval in the ChatEgg TikTok settings to reduce request frequency.
  3. If the problem persists, TikTok may have blocked your server's IP address entirely. You may need to switch to a different server or use Euler Stream instead.