Skip to content

Overview

Print TikTok LIVE gifts, follows and comments to a thermal receipt printer with the no-code TikTok Live Printer app or the tiktok-live-printer Node.js library.

TikTok Live Printer turns TikTok LIVE events into paper. A viewer sends a gift, follows, shares, comments or likes, and a receipt comes out of a thermal printer with their avatar, their @username and a line like THANKS FOR 1 X Rose. It is the TypeScript successor to the original Python TikTokPrinter.

There are two ways to use it. Pick one; each section of these docs stands on its own.

Best forStart
The appStreamers. One file to download, no code, drag-and-drop receipts.Install the app
The libraryDevelopers. npm install tiktok-live-printer and build your own printer, overlay or alert in Node.js.Library getting started

LIVE events arrive over the Euler Stream WebSocket API, the same managed TikTok LIVE WebSocket service behind TikTokLive. You need an Euler Stream API key for either path. The library turns events into ESC/POS commands and sends them to the printer over USB, the system print spooler or TCP; the app wraps the library in a local web UI.

  • Gift receipts with the sender’s profile picture, gift name and streak count
  • Follow, share, join and subscribe notifications
  • Comments as a running paper chat log
  • Like milestones, every N likes from a viewer
  • Text to speech alongside any receipt

Any ESC/POS thermal receipt printer: 58 mm (384 dots) and 80 mm (576 dots) rolls, over USB, network (port 9100) or the printer driver already installed on Windows. Tested with a generic POS58 USB printer on macOS. See printers for the app or printer engines for the library.

Source, issues and releases live on GitHub. Questions about the WebSocket service go to Euler Stream support. This is an unofficial project and is not affiliated with TikTok or ByteDance.