Skip to content
@PirateTok

PirateTok

Raiding for fun and non-profit.
README.md

PirateTok

TikTok Live, unchained.

Real-time TikTok Live events in 12 languages. No signing server. No API keys. No proprietary middleman.

What is this?

Every TikTok Live connector library on the internet funnels your traffic through a proprietary signing server — a black box that mints authentication tokens and gates access behind infrastructure you don't control. They'll tell you it's required. It isn't.

PirateTok libraries connect directly to TikTok's WebSocket stream. No signing server. No middleman. No fees.

12 native implementations. Same protocol. Same events. Same freedom.

Libraries

Language Install Repo
Rust cargo add piratetok-live-rs live-rs
Go go get github.com/PirateTok/live-go live-go
Python pip install piratetok-live-py live-py
JavaScript npm install piratetok-live-js live-js
C# dotnet add package PirateTok.Live live-cs
Java com.piratetok:live live-java
Lua luarocks install piratetok-live-lua live-lua
Elixir {:piratetok_live, "~> 0.1"} live-ex
Dart dart pub add piratetok_live live-dart
C #include "piratetok.h" live-c
PowerShell Install-Module PirateTok.Live live-ps1
Shell bpkg install PirateTok/live-sh live-sh

Features

  • No signing server — no proprietary token minting, no third-party dependency
  • Auto-reconnect — stale detection, exponential backoff, self-healing on blocks
  • Proxy support — HTTP/HTTPS/SOCKS5
  • CDN selection — EU, US, or Global endpoints
  • No protoc — no build-time protobuf tooling, ever
  • Age-restricted rooms — event streaming works out of the box, no special auth needed
  • Room info — optional fetch_room_info call returns title, viewer count, FLV stream URLs (5 quality tiers). Age-restricted streams need session cookies for this call only — event streaming never needs cookies.

Decode Matrix

Enriched user data on every event — badges, gifter level, moderator status, fan club, follow info.

Event Ours Go C# JS Python Java
ChatMessage ✅ ✅ ✅ ✅ ✅ ✅
GiftMessage ✅ ✅ ✅ ✅ ✅ ✅
LikeMessage ✅ ✅ ✅ ✅ ✅ ✅
MemberMessage ✅ ✅ ✅ ✅ ✅ ✅
SocialMessage ✅ ✅ ✅ ✅ ✅ ✅
RoomUserSeqMessage ✅ ✅ ✅ ✅ ✅ ✅
ControlMessage ✅ ✅ ✅ ✅ ✅ ✅
LiveIntroMessage ✅ ❌ ✅ ✅ ✅ ❌
RoomMessage ✅ ❌ ✅ ✅ ✅ ❌
CaptionMessage ✅ ❌ ❌ ❌ ✅ ❌
GoalUpdateMessage ✅ ❌ ❌ ❌ ✅ ❌
ImDeleteMessage ✅ ❌ ✅ ✅ ✅ ❌
RankUpdateMessage ✅ ❌ ✅ ❌ ✅ ❌
PollMessage ✅ ❌ ✅ ❌ ✅ ❌
EnvelopeMessage ✅ ❌ ❌ ❌ ✅ ❌
RoomPinMessage ✅ ❌ ❌ ❌ ✅ ❌
LinkMicBattle ✅ ❌ ✅ ✅ ✅ ✅
LinkMicArmies ✅ ❌ ✅ ✅ ✅ ✅
EmoteChatMessage ✅ ❌ ✅ ✅ ✅ ✅
QuestionNewMessage ✅ ✅ ❌ ✅ ✅ ✅
SubNotifyMessage ✅ ❌ ✅ ❌ ✅ ✅
BarrageMessage ✅ ❌ ✅ ✅ ✅ ✅
HourlyRankMessage ✅ ❌ ✅ ✅ ✅ ❌
MsgDetectMessage ✅ ❌ ✅ ✅ ✅ ❌
LinkMicFanTicketMethod ✅ ❌ ❌ ✅ ✅ ❌
RoomVerifyMessage ✅ ❌ ✅ ✅ ✅ ❌
OecLiveShoppingMessage ✅ ❌ ✅ ✅ ✅ ❌
GiftBroadcastMessage ✅ ❌ ✅ ✅ ✅ ❌
RankTextMessage ✅ ❌ ✅ ✅ ✅ ❌
UnauthorizedMemberMessage ✅ ❌ ❌ ❌ ✅ ❌
GiftPanelUpdateMessage ✅ ❌ ❌ ❌ ❌ ❌
InRoomBannerMessage ✅ ❌ ❌ ❌ ❌ ❌
GuideMessage ✅ ❌ ❌ ❌ ❌ ❌
GiftDynamicRestrictionMessage ✅ ❌ ❌ ❌ ❌ ❌
ViewerPicksUpdateMessage ✅ ❌ ❌ ❌ ❌ ❌
+ 25 Tier B events ✅ ❌ partial partial stub ❌
Unknown passthrough ✅ ❌ ❌ ❌ ❌ ❌
Signing server required No Yes Yes Yes Yes Yes

"Ours" = all 12 PirateTok libraries. Others columns show their single upstream equivalent.

License

Every library is 0BSD — do whatever you want with it. No attribution required. No restrictions. No copyleft. Nothing.

The Saga — why this project exists

I joined the TikTok Live open-source community as the maintainer of the Rust library. The ecosystem was built around a single chokepoint: a proprietary signing server. Every library in every language depended on this one piece of infrastructure to function. A free community tier existed (up to 1,000 requests/day), with paid plans above that — but either way, it was a central point of failure that no one controlled except its owner.

I run an NGO that fights child sexual abuse online. TikTok, to their credit, is one of the fastest platforms to act when authorities reach out — they take these reports seriously and respond quickly, which is more than can be said for most. But reactive enforcement has limits. By the time a report is filed, the damage is done. Our work is proactive: we monitor TikTok Live streams where predators target minors, gather evidence, and intervene before abuse happens rather than after.

This kind of surveillance requires volume — far more than the community tier could offer. I couldn't afford to depend on infrastructure I didn't control for work this critical. So I built my own signing server. And while optimizing it, I discovered something: the signing server is unnecessary. The entire authentication ceremony — x_bogus, msToken, session tokens — none of it is validated at the WebSocket level. You don't need any of it.

I rewrote everything from scratch. Then I did it again in 11 more languages.

Every library is 0BSD. No signing server. No API keys. No gatekeepers. No one gets to sit between you and a WebSocket connection and decide whether your use case is worthy.

Come aboard 🏴‍☠️

PirateTok

Popular repositories Loading

  1. ttytok ttytok Public

    TikTok Live in your terminal. tmux + fzf + pure shell.

    Shell 27

  2. live-java live-java Public

    TikTok Live WebSocket connector for Java — real-time chat, gifts, likes, viewer events. No API keys required.

    Java 2 1

  3. live-rs live-rs Public

    TikTok Live WebSocket connector for Rust — real-time chat, gifts, likes, and 60+ event types. No authentication required.

    Rust 1

  4. .github .github Public

  5. live-ps1 live-ps1 Public

    TikTok Live WebSocket connector for PowerShell -- real-time events, no auth required. 0BSD.

    PowerShell

  6. live-sh live-sh Public

    TikTok Live WebSocket connector in POSIX sh — real-time chat, gifts, likes. No authentication required.

    Shell

Repositories

Showing 10 of 15 repositories
View all repositories

People

This organization has no public members. You must be a member to see who’s a part of this organization.

Top languages

Loading…

Most used topics

Loading…