Skip to content

Home

Overview

tk3u8 is a TikTok live downloader, written in Python. The project was based and built from Michele0303's tiktok-live-recorder, and modified for ease of use and to utilize yt-dlp and FFmpeg as a downloader. The project currently supports Windows and Linux systems.

Some of the key features include:

  • Download TikTok live stream by username through command-line
  • Choose stream quality (original, uhd, hd, etc.)
  • Let program download live stream once user goes online
  • Public API support for creating your own scripts
  • Proxy support
  • Config support

Quickstart

In case you're in hurry, here is a short, quick installation and usage guide. For more comprehensive details, see the installation and usage guides.

Requirements

  • Windows or Linux
  • Python v3.10 or greater
  • FFmpeg
  • uv

Steps

  1. Install Python 3.10.0 or above. For Windows users, ensure Add Python x.x to PATH is checked.
  2. Install FFmpeg. For Windows users, follow this guide for proper installation.
  3. Open your command-line.

  4. Install uv through pip command or via Standalone installer.

    pip install uv

  5. Install the latest published stable release of tk3u8 into your system.

    uv tool install tk3u8

  6. To download a live stream, simply run this:

    tk3u8 username

  7. To stop and save the live stream, just hit Ctrl+C once and wait for the program to finish processing and you're done! The live stream will be saved in your Downloads folder.