PirateTok GUI

WinForms TikTok Live client for Windows 7 and newer.

What It Ships

• one-window meme GUI with embedded ffplay
• favorites and discovery panels
• local user state in the app folder
• self-installing trainer-style setup with no console windows
• runtime dependency download for:
  • PirateTok.Live
  • FFmpeg ffplay

Runtime Layout

Installed app path:

• %LOCALAPPDATA%\PirateTok\app\tiktok-live.ps1
• %LOCALAPPDATA%\PirateTok\app\PirateTok-launch.vbs
• %LOCALAPPDATA%\PirateTok\app\PirateTok.Live\...
• %LOCALAPPDATA%\PirateTok\app\ffmpeg\bin\ffplay.exe

Mutable state is stored next to the app:

• favorite-users.txt
• ttwid-cache.txt

Development

Run the GUI locally:

PirateTok.bat

Or directly:

powershell -ExecutionPolicy Bypass -File .\tiktok-live.ps1 -Gui

Enable app debug logging only when needed:

$env:PIRATETOK_DEBUG = "1"
powershell -ExecutionPolicy Bypass -File .\tiktok-live.ps1 -Gui

Installer Build

Build the trainer-style installer from installer/build-installer.sh.

Default reproducible-oriented build requirements:

• bash
• wine
• sha256sum

The default build uses tracked generated assets and verifies them before compiling.

If you intentionally change the logo art or tracker music source, regenerate the tracked build assets with:

cd installer
./refresh-assets.sh

That refresh step additionally requires:

• python3
• ffmpeg
• Pillow

The local AutoHotkey compiler toolchain is kept in automation.

See REPRODUCIBLE.md for the pinned build expectations.

Release Notes

The installer is the release artifact. Generated payload directories and compiled installers are ignored, but the canonical installer .ico, background .bmp, and soundtrack .wav are tracked as build inputs for reproducibility.