Clean Chat — TikTok Live Chat overlay
Clean Chat lifts the noisy TikTok chat into your stream canvas: avatars, colored nicknames, badges, and auto fade-out. It is the foundation overlay — readable for viewers, controllable for you.
Prerequisite: install and run TKStudio (Windows desktop) and connect it to the TikTok LIVE room you are streaming. This article stands on its own — from configuration to OBS / TikTok LIVE Studio setup.
When to use it
When you game, native chat is folded on phones and tiny on an OBS canvas — pin Clean Chat to the left edge and viewer messages become part of the show. Shopping hosts use the level filters to keep only high-quality comments on screen while blocked words weed out ads and bait.
Turn on TTS for chat or music streams: messages read themselves aloud while your hands stay busy. Slower formats (teaching, talk shows) benefit from a longer 20–30s fade delay.
The demo video above shows Clean Chat in action (both EN and ZH versions), and the cover previews the layout; the plugin page's live preview is the source of truth.
Configuration
Configure everything on the plugin page in TKStudio — tune on the left, preview live on the right, then hit Generate link. The table below lists every parameter in panel order, its default, and practical gotchas.
| Parameter | Description | Default | Gotchas |
|---|---|---|---|
minUserLevel | Only show events from viewers at or above this TikTok user level. (0–100) | 0 | 0 = no filter. High values silently drop normal viewers — mainly useful for welcome plugins. |
minFansClubLevel | Only react to fan-club members at or above this level. (0–50) | 0 | Fan club level ≠ user level — check your real top fans' levels before raising this. |
onlyFansClubUser | Show fan-club members only. | false | Great for fan-club-only sessions; everyday streams will look empty if enabled. |
minGiftPrice | Gifts cheaper than this unit price are ignored. (0–20, step 0.1) | 0 | The best fix for 1-coin gift spam. Too high hides mid-tier gifts and kills feedback. |
showUserLevel | Show the sender's pay-grade badge next to the nickname. | true | Badges feed status competition; turn off for a minimal look. |
showPayGradeName | Show grade name text instead of the badge icon. | false | Pairs with the badge toggle above; both off hides the grade entirely. |
showFansClub | Show the viewer's fan-club level. | true | Highlights loyal fans and encourages joining the club. |
showFansClubName | Also show the fan-club name. | false | Long club names can wrap — check the preview before going live. |
fontSizeLevel | Overall text size step (1–10). (1–10) | 5 | Judge in preview; lower it for vertical (portrait) streams so text stays in frame. |
disappearSec | How long a message stays before fading out. (0–120) | 12 | 0 hides instantly (debug only). Slow-paced shows (chat / teaching) can go 20–30s. |
maxDisplayRows | Max message rows kept on screen. (3–30) | 8 | More rows = more screen. 3–8 is usually plenty; too many will cover gameplay or your face. |
filterWords | Messages containing these words are hidden entirely. | — | Substring matching — short words over-match (blocking gun also hits begun). |
voiceEnabled | Read events aloud with system TTS. | false | Uses your OS TTS voices — install extra language packs if missing; pick a zh-* voice for Chinese. |
voiceReadNick | Include the viewer's nickname in speech. | false | Nicknames with emoji or rare characters may sound odd. |
voiceVolume | TTS volume (0–100). (0–100, step 5) | 80 | 60–80 recommended so TTS never drowns your mic. |
voiceStyle | TTS voice style. | normal | Available styles depend on installed system voices. |
voiceIntervalSec | Minimum gap between two announcements. (0–10) | 2 | Raise it for busy rooms so announcements queue instead of piling up. |
voiceLang | TTS language (e.g. en-US / zh-CN). | en-US | Voices come from the OS; add a language pack first if your target language is missing. |
How to use it in OBS
This section assumes you have generated and copied the link: open TKStudio → pick Clean Chat → choose the room and tune parameters → Generate link → Copy link. Keep TKStudio running while you stream — the overlay link talks to the local TKStudio process.
Add the link to OBS as a Browser Source:
- In the Sources dock click + → Browser.
- Paste the copied link into URL; set width / height to your canvas (usually 1920×1080).
- Leave Shutdown source when not visible unchecked so the overlay never pauses.
- Click OK, then drag / resize the source into position.
Placement: Anchor to the left third of the canvas — ideal when game HUD sits bottom-right. Font step 4–6 with 6–8 rows balances well at 1080p.
- The page background is transparent out of the box — do not override it with custom CSS.
- After changing parameters, Generate link again and refresh the Browser Source (or update its URL).
- One plugin = one Browser Source; add more sources for more overlays.
How to use it in TikTok LIVE Studio
If you go live with TikTok LIVE Studio, the approach is the same — a browser layer, nearly identical to OBS:
- Open your scene / layer list in TikTok LIVE Studio.
- Add a Browser layer.
- Paste the link from Copy link into the URL field.
- Match the canvas size (e.g. 1920×1080) and keep the background transparent.
- Position the layer, go live, and send a test chat / gift to confirm it animates.
- TKStudio and TikTok LIVE Studio must run on the same PC (the link points to 127.0.0.1).
- Blank overlay? Make sure TKStudio is connected to the right room, then re-copy the link and refresh the layer.
- After regenerating a link, refresh or re-create the browser layer.
Related plugins
Browse all plugin docs or try them live in the TKStudio marketplace.