PirateTok Go Live

Connect to any TikTok Live stream and receive real-time events in Go. No signing server, no API keys, no authentication required.

package main

import (
    "context"
    "fmt"
    golive "github.com/PirateTok/live-go"
    "github.com/PirateTok/live-go/events"
    pb "github.com/PirateTok/live-go/proto"
)

func main() {
    // Connect returns a channel of decoded events
    ch, err := golive.NewClient("username_here").Connect(context.Background())
    if err != nil {
        panic(err)
    }

    // Events arrive as fully decoded protobuf messages
    for evt := range ch {
        switch evt.Type {
        case events.EventConnected:
            fmt.Println("connected to room:", evt.RoomID)
        case events.EventChat:
            msg := evt.Data.(*pb.WebcastChatMessage)
            fmt.Printf("[chat] %s: %s\n", msg.User.GetNickname(), msg.GetContent())
        case events.EventGift:
            msg := evt.Data.(*pb.WebcastGiftMessage)
            fmt.Printf("[gift] %s sent %s x%d\n",
                msg.User.GetNickname(), msg.GetGiftName(), msg.GetRepeatCount())
        case events.EventDisconnected:
            fmt.Println("disconnected")
            return
        }
    }
}

Install

go get github.com/PirateTok/live-go

Other languages

Language	Install	Repo
Rust	cargo add piratetok-live-rs	live-rs
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

• Zero signing dependency — no API keys, no signing server, no external auth
• 64 decoded event types — committed protobuf codegen, no build-time protoc
• Auto-reconnection — stale detection, exponential backoff, self-healing auth
• HTTP proxy inheritance — plain HTTP requests use Go's default transport behavior, including env proxy settings
• Enriched User data — badges, gifter level, moderator status, follow info, fan club
• Sub-routed convenience events — EventFollow, EventShare, EventJoin, EventLiveEnded
• 2 dependencies — gobwas/ws + google.golang.org/protobuf

Configuration

client := golive.NewClient("username_here").
    CdnEU().
    MaxRetries(10).
    StaleTimeout(90 * time.Second)

Room info (optional, separate call)

info, err := golive.FetchRoomInfo("ROOM_ID", 10*time.Second, "")

// 18+ rooms
info, err := golive.FetchRoomInfo("ROOM_ID", 10*time.Second, "sessionid=abc; sid_tt=abc")

Examples

go run ./cmd/basic_chat <username>       # connect + print chat events
go run ./cmd/online_check <username>     # check if user is live
go run ./cmd/stream_info <username>      # fetch room metadata + stream URLs
go run ./cmd/gift_tracker <username>     # track gifts with diamond totals

Known gaps

• WSS proxy transport support is not implemented yet.
• Explicit DEVICE_BLOCKED handshake handling is not implemented yet.

License

0BSD