# zerodytrash/TikTok-Live-Connector

Node.js library to receive live stream events (comments, gifts, etc.) in realtime from TikTok LIVE.

Repository: https://github.com/zerodytrash/TikTok-Live-Connector
Canonical: https://ross.abutalabs.com/products/tiktok-live-connector
Homepage: https://discord.gg/2c6kX6g3Pa
Language: TypeScript
License: AGPL-3.0
License Family: copyleft
Topics: tiktok, tiktok-api, tiktok-live, chat, chat-reader, connector, stream, scraper, webcast, javascript, nodejs, live, bot, api, api-wrapper, websocket, package, broadcast, livestream, hacktoberfest
Last push: 2026-08-18T04:47:38+00:00

## Health v2 (maintenance only)
Score: 74/100 (v2, computed 2026-09-02T17:46:02.011165+00:00)
- activity 98, release rhythm 28, longevity 100
- inputs: {"age_days": 1671, "days_push": 15, "days_rel": 582, "gap_med": 45, "n_releases_24m": 2}
- flags: none
- formula: round(0.45*activity + 0.35*rhythm + 0.20*longevity); archived -> min(score, 10)

## Adoption (not part of the score)
Stars 2133, forks 463 (observed 2026-08-28T04:06:17.327221+00:00)

## What it is
An unofficial Node.js library that connects to TikTok LIVE streams and delivers real-time events such as chat comments, gifts, likes, follows, shares, viewer counts and battles using only a creator's username. It reads TikTok's internal Webcast push service and serves as a foundation for chat bots, gift trackers, OBS overlays and livestream analytics.

## Use cases
- build a tiktok live chat bot
- track gifts and donations from a tiktok livestream
- show live tiktok comments in an OBS overlay
- monitor viewer counts and likes of a tiktok stream
- read tiktok live chat messages in realtime without login
- build donation alerts from tiktok live events
- collect livestream analytics for tiktok creators

## When to choose
- you need real-time TikTok LIVE events in a Node.js application
- you want to build chat bots, gift trackers or overlays without TikTok API credentials
- you only have a creator's username and no app registration

## When to avoid
- you need a production-ready, officially supported TikTok API
- your project is not in JavaScript or Node.js
- you require guaranteed stability, since this is a reverse-engineering project that can break when TikTok changes

## Facets
- artifact type: library
- maturity: active
- function: websocket, http-client, sdk, web-scraping
- domain: social-media, apis, developer-tools
- platform: -
- tags: tiktok, livestream, chat-bot, reverse-engineering, unofficial-api, gift-tracker, obs-overlays, event-streaming, real-time, nodejs, javascript

## Member repositories
- zerodytrash/TikTok-Live-Connector (main) score 74

## Provenance
- Observed fields: from GitHub, fetched 2026-08-28T04:06:17.327221+00:00.
- Health v2: computed from the inputs above; adoption is never an input.
- Inferred fields (summary, facets, guidance): AI-extracted, prompt v1, taxonomy v1, on 2026-08-30T02:52:00.746911+00:00, confidence not recorded.
  - readme: https://github.com/zerodytrash/TikTok-Live-Connector (fetched 2026-08-28T04:06:17.327221+00:00, sha 23e5649c3b74)
  - homepage: https://discord.gg/2c6kX6g3Pa (fetched 2026-08-29T10:32:30.704467+00:00, sha 651ed426796a)
  - registry_npm: https://registry.npmjs.org/tiktok-live-connector (fetched 2026-08-29T10:32:30.713386+00:00, sha bb0656740945)
- Data as of 2026-08-30T08:39:29.467469+00:00.