PKTOK for OBS Studio: setup without a plugin

PKTOK is not a product of TikTok Pte. Ltd. or ByteDance Ltd., is not affiliated with them, and is not endorsed, sponsored, or approved by them.

If you searched for a "PKTOK OBS plugin", here is the honest answer first: there is no compiled plugin, and we are not planning one. What we do have is a small setup script that runs in OBS's own script menu and does the whole job in one click — no installer, no security warning, nothing to keep updated.

This page explains why we chose that, how to use the script, how to set it up by hand if you prefer, and what to do when the layer looks black. That last one is the most common question we get, and the answer is probably not what you fear.

Why there is no compiled plugin

Most TikTok LIVE streamers do not broadcast from OBS Studio. They use TikTok LIVE Studio, TikTok's own program — and that one does not load third-party plugins at all. A plugin would therefore be useless to the majority of the people asking for it.

On top of that, a real plugin has to be compiled separately for Windows and macOS, signed, shipped through an installer that antivirus software likes to question, and rebuilt for every new OBS release. That is a permanent maintenance cost paid by us and a permanent installation risk taken by you — for something a small script does just as well.

So we built the script instead. It is a plain text file you can read before you run it.

The one-click setup script

Download pktok-obs-setup.lua (works with OBS Studio 28 and newer, Windows and macOS)

What it does when you press its button:

  • Creates a browser source called PKTOK Overlay at the correct size — 1080 × 1920 for a normal vertical stream, 1920 × 1080 if your PKTOK channel is in landscape "gamer" mode. It reads that from your link; you don't have to know which one you need.
  • Sets the settings people usually get wrong: transparent background, "shutdown when not visible" turned off, and browser audio routed through OBS so PKTOK sounds actually reach your stream.
  • Places the layer on top of your scene and fits it to your canvas. A PKTOK layer underneath your camera is invisible, and that is exactly what a hand-made setup tends to produce.
  • Warns you if your canvas and your link disagree — a landscape link on a vertical canvas, for example.
  • Can be run twice without making a mess. It updates the existing layer instead of adding a second one.

How to use it:

  1. In your PKTOK console, open the Videos page and copy the line called Your PKTOK link. It is the only link you need.
  2. In OBS: Tools → Scripts → "+" and pick the downloaded pktok-obs-setup.lua.
  3. Paste your link into the PKTOK overlay link field.
  4. Press Set up the PKTOK layer.
  5. Back in the console, press Test on the Videos page. You should see the test clip play in OBS.

The script talks only to OBS on your own computer. It sends nothing to us, and it stores nothing outside your OBS settings. There is also a Reload the PKTOK layer button and a matching entry in the Tools menu, for when you want to refresh the layer without touching anything else.

Prefer to do it by hand?

Nothing here requires the script. The manual route:

  1. Copy Your PKTOK link from the console's Videos page.
  2. In OBS, add a Browser source and paste the link into the URL field.
  3. Set width 1080 and height 1920 (or 1920 × 1080 in landscape mode).
  4. Untick Shutdown source when not visible.
  5. Tick Control audio via OBS, so PKTOK sounds go out with your stream.
  6. Drag the source to the top of your source list, and stretch it to fill the canvas.

"The layer is black — is it broken?"

Almost certainly not. The PKTOK layer is transparent and idle by design. It shows nothing at all until something happens: a supporter enters, a battle ends and the MVP is announced, a booster card lands, a gift arrives, or you press Test. An empty black rectangle in OBS is what a correct, working setup looks like when nothing is happening.

Prove it to yourself in ten seconds: open the Videos page in your console and press Test. If the clip plays in OBS, you are done — go live.

If the test clip does not play, work down this list:

  • Does the console say the source is connected? If it reports no connected source, the browser source did not load the link. Re-copy it — the whole line, including the part after the question mark.
  • Is it the right link? The video layer link is the one on the Videos page. The widget links belong to separate sources, one per widget.
  • Is the LIVE listener switched on in the console before you go live? Without it, nothing is triggered automatically.
  • Is the layer under your camera? Drag it to the top of the source list. The script does this for you.

There is a second, different "black" worth knowing about: a clip that plays with a black box around it. That means the uploaded file itself is not transparent — iPhone exports and most AI-generated videos never are, even when they look like it. Upload a green-screen version and tick "green background — please remove" when uploading, and PKTOK will key it out for you.

What PKTOK actually does on your stream

PKTOK watches your PK battles and turns their decisive moments into full-screen video on your stream, automatically. Videos fire on entrance, MVP when a battle ends, PK boosters (×2/×3 and the glove card), the 15-second snipe alert, level-up, gifts, and manual trigger. There are also 23 overlay widgets — top gifters, daily coin goal, follower goal, battle supporters and more — and chat text-to-speech.

One account watches one TikTok channel at a time — you can save a second channel and switch to it, but activating one stops the other. Everything is free for everyone right now, with no card; from 1 November 2026 every account gets 6 hours of full access, and the clock only runs while you're actually live. After that it's €15/month (Normal) or €20/month (VIP) — €135 and €180 paid yearly, because you pay for 9 months and get 12. Your account and your videos stay either way; only the overlay stops.

OBS Studio or TikTok LIVE Studio?

Both work with PKTOK, because the layer is an ordinary browser source in either. The difference is only in the setup:

  • OBS Studio — more control, and the setup script on this page. Note that TikTok does not hand out a stream key to every account, so check that you can stream to TikTok from OBS at all before you build a whole scene there.
  • TikTok LIVE Studio — TikTok's own program, no stream key needed. The setup script does not work there (it has no script menu), so follow the step-by-step guide instead.

FAQ

Is this a real OBS plugin?

No. It is a script for OBS's built-in script menu (Tools → Scripts). That is deliberate: nothing is installed, your antivirus has nothing to complain about, and it does not break when OBS updates.

Is it safe to run?

It is a plain text file — open it in any text editor and read it before you run it. It only talks to OBS on your own computer: it creates one browser source and sets its properties. It sends nothing to us and stores nothing outside your OBS settings.

Does it work in TikTok LIVE Studio?

No. LIVE Studio has no script menu. You can still use PKTOK there — you add the browser source by hand, which takes about a minute.

Which OBS versions are supported?

OBS Studio 28 and newer, on Windows and macOS. It was tested on OBS Studio 32.

Will it change my existing scenes?

It adds one source to your current scene and touches nothing else. If a PKTOK layer is already in that scene, it updates its settings and leaves your positioning alone.

Vertical and horizontal streams?

Both. The script reads the orientation from your link and uses 1080 × 1920 or 1920 × 1080 accordingly. If your OBS canvas does not match, it says so instead of quietly producing a layer that doesn't fit.

Do I need the script to use PKTOK?

No. It only saves you the manual browser-source setup. Everything works the same either way.

Create your free PKTOK account and copy your layer link from the Videos page.