tiktok-live-api 1.2.2 → 1.2.3

package/LICENSE

@@ -1,21 +1,21 @@
-MIT License
-
-Copyright (c) 2024 TikTool
-
-Permission is hereby granted, free of charge, to any person obtaining a copy
-of this software and associated documentation files (the "Software"), to deal
-in the Software without restriction, including without limitation the rights
-to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
-copies of the Software, and to permit persons to whom the Software is
-furnished to do so, subject to the following conditions:
-
-The above copyright notice and this permission notice shall be included in all
-copies or substantial portions of the Software.
-
-THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
-IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
-FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
-AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
-LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
-OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
-SOFTWARE.
+MIT License
+
+Copyright (c) 2024 TikTool
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -1,5 +1,5 @@
 <p align="center">
-  <img src="https://raw.githubusercontent.com/tiktool/tiktok-live-api/main/banner.png" alt="tiktok-live-api" width="100%" />
+  <img src="banner.png" alt="tiktok-live-api" width="100%" />
 </p>
 
 # tiktok-live-api

package/bin/demo.mjs

@@ -0,0 +1,185 @@
+#!/usr/bin/env node
+
+/**
+ * tiktok-live-api CLI
+ * Instantly connects to a live TikTok stream and prints real-time events.
+ *
+ * Usage:
+ *   npx tiktok-live-api                  auto-find a live stream
+ *   npx tiktok-live-api @username        connect to a specific stream
+ *   npx tiktok-live-api --key YOUR_KEY   use your own API key
+ *
+ * Unofficial third-party API by TikTool · https://tik.tools
+ * Not affiliated with TikTok or ByteDance.
+ */
+
+import WebSocket from 'ws';
+
+const WS_BASE = 'wss://api.tik.tools';
+const DEMO_KEY = 'demo_tiktokliveapi_public_2026';
+
+const CHANNELS = [
+    'aljazeeraenglish', 'cgtnofficial', 'france24_en',
+    'weathernewslive', 'gbnews', 'bbcnews',
+    'skynews', 'tv_asahi_news', 'abc7chicago', 'thairath_news',
+];
+
+// ── ANSI ───────────────────────────────────────────────────────────────
+const R = '\x1b[0m';
+const B = '\x1b[1m';
+const D = '\x1b[2m';
+const I = '\x1b[3m';
+const C = {
+    cyan: '\x1b[38;5;80m', green: '\x1b[38;5;114m', yellow: '\x1b[38;5;222m',
+    mag: '\x1b[38;5;176m', blue: '\x1b[38;5;111m', red: '\x1b[38;5;203m',
+    gray: '\x1b[38;5;242m', white: '\x1b[38;5;252m', pink: '\x1b[38;5;218m',
+};
+
+const TAG = {
+    chat: `${C.cyan}chat${R}`,
+    gift: `${C.yellow}gift${R}`,
+    like: `${C.mag}like${R}`,
+    member: `${C.green}join${R}`,
+    follow: `${C.green}follow${R}`,
+    viewer: `${C.blue}viewers${R}`,
+    share: `${C.white}share${R}`,
+};
+
+// ── Parse args ─────────────────────────────────────────────────────────
+let target = '';
+let apiKey = DEMO_KEY;
+
+const args = process.argv.slice(2);
+for (let i = 0; i < args.length; i++) {
+    const a = args[i];
+    if (a === '--key' || a === '-k') { apiKey = args[++i] || DEMO_KEY; }
+    else if (a === '--help' || a === '-h') { help(); process.exit(0); }
+    else if (!a.startsWith('-')) { target = a.replace(/^@/, ''); }
+}
+
+function help() {
+    console.log(`
+  ${B}tiktok-live-api${R}  ${D}Real-time TikTok Live events in your terminal${R}
+
+  ${B}Usage${R}
+    ${C.cyan}npx tiktok-live-api${R}                  ${D}auto-find a live stream${R}
+    ${C.cyan}npx tiktok-live-api${R} ${C.white}@username${R}        ${D}connect to a specific user${R}
+    ${C.cyan}npx tiktok-live-api${R} ${C.gray}--key KEY${R}        ${D}use your own API key${R}
+
+  ${D}Unofficial third-party API by TikTool${R}
+  ${D}https://tik.tools · Not affiliated with TikTok or ByteDance${R}
+`);
+}
+
+// ── WebSocket probe ────────────────────────────────────────────────────
+function probe(uid, ms = 8000) {
+    return new Promise(resolve => {
+        const ws = new WebSocket(`${WS_BASE}?uniqueId=${uid}&apiKey=${apiKey}`);
+        const t = setTimeout(() => { ws.close(); resolve(null); }, ms);
+        ws.on('message', () => { clearTimeout(t); resolve(ws); });
+        ws.on('error', () => { clearTimeout(t); resolve(null); });
+        ws.on('close', () => { clearTimeout(t); });
+    });
+}
+
+// ── Banner ─────────────────────────────────────────────────────────────
+function banner() {
+    console.log();
+    console.log(`  ${B}tiktok-live-api${R}  ${D}·${R}  ${D}Real-time TikTok Live events${R}`);
+    console.log(`  ${D}Unofficial API by TikTool · https://tik.tools${R}`);
+    console.log();
+}
+
+// ── Format ─────────────────────────────────────────────────────────────
+function ts() {
+    const d = new Date();
+    return `${C.gray}${String(d.getHours()).padStart(2, '0')}:${String(d.getMinutes()).padStart(2, '0')}:${String(d.getSeconds()).padStart(2, '0')}${R}`;
+}
+
+function fmt(event, data) {
+    const tag = TAG[event] || `${C.gray}${event.padEnd(7)}${R}`;
+    const u = data.user?.uniqueId || '';
+    const pad = tag.length < 20 ? '  ' : ' ';
+
+    switch (event) {
+        case 'chat':
+            return `${ts()} ${tag}${pad}  ${B}${u}${R}  ${data.comment || ''}`;
+        case 'gift': {
+            const name = data.giftName || 'gift';
+            const n = data.repeatCount || 1;
+            const d2 = data.diamondCount || 0;
+            return `${ts()} ${tag}${pad}  ${B}${u}${R}  ${C.yellow}${name}${R} x${n} ${D}(${d2}💎)${R}`;
+        }
+        case 'like':
+            return `${ts()} ${tag}${pad}  ${B}${u}${R}  ${D}total ${(data.totalLikeCount || 0).toLocaleString()}${R}`;
+        case 'member':
+            return `${ts()} ${tag}${pad}  ${C.green}${u}${R}`;
+        case 'follow':
+            return `${ts()} ${tag}  ${C.green}${u}${R}`;
+        case 'viewer':
+            return `${ts()} ${tag}  ${B}${(data.viewerCount || 0).toLocaleString()}${R}`;
+        case 'share':
+            return `${ts()} ${tag} ${u}`;
+        default:
+            return null; // skip noisy unknown events
+    }
+}
+
+// ── Main ───────────────────────────────────────────────────────────────
+async function main() {
+    banner();
+    let ws = null, who = '';
+
+    if (target) {
+        process.stdout.write(`  ${D}connecting to${R} ${B}@${target}${R} ${D}...${R}`);
+        ws = await probe(target);
+        if (ws) { who = target; console.log(` ${C.green}●${R}`); }
+        else { console.log(` ${C.red}✗${R}\n\n  ${C.red}Stream not found.${R} Make sure ${B}@${target}${R} is live.\n`); process.exit(1); }
+    } else {
+        console.log(`  ${D}scanning for live streams...${R}\n`);
+        for (const uid of CHANNELS) {
+            process.stdout.write(`  ${C.gray}@${uid}${R}`);
+            ws = await probe(uid);
+            if (ws) { who = uid; console.log(`  ${C.green}● live${R}`); break; }
+            else { console.log(`  ${D}—${R}`); }
+        }
+        if (!ws) {
+            console.log(`\n  ${C.red}No live streams found.${R} Try: ${C.cyan}npx tiktok-live-api @username${R}\n`);
+            console.log(`  ${D}Get your own API key at${R} ${C.cyan}https://tik.tools${R}\n`);
+            process.exit(1);
+        }
+    }
+
+    console.log();
+    console.log(`  ${C.green}●${R} ${B}@${who}${R}  ${D}— streaming events. Ctrl+C to stop.${R}`);
+    console.log(`  ${D}${'─'.repeat(50)}${R}`);
+    console.log();
+
+    let count = 0;
+    ws.on('message', raw => {
+        try {
+            const m = JSON.parse(raw.toString());
+            const ev = m.event || 'unknown';
+            const d = m.data || m;
+            const line = fmt(ev, d);
+            if (line) { count++; console.log(`  ${line}`); }
+        } catch { }
+    });
+
+    ws.on('close', () => {
+        console.log(`\n  ${D}disconnected — ${B}${count}${R}${D} events received${R}`);
+        console.log(`  ${D}Get unlimited access:${R} ${C.cyan}https://tik.tools${R}\n`);
+        process.exit(0);
+    });
+
+    ws.on('error', e => console.error(`  ${C.red}error${R} ${e.message}`));
+
+    process.on('SIGINT', () => {
+        console.log(`\n\n  ${D}stopped — ${B}${count}${R}${D} events received${R}`);
+        console.log(`  ${D}Get your own key:${R} ${C.cyan}https://tik.tools${R}\n`);
+        ws.close();
+        process.exit(0);
+    });
+}
+
+main().catch(e => { console.error(`  ${C.red}${e.message}${R}`); process.exit(1); });

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "tiktok-live-api",
-  "version": "1.2.2",
+  "version": "1.2.3",
   "description": "Unofficial TikTok LIVE API Client — Real-time chat, gifts, viewers, battles, and AI live captions from any TikTok livestream. Managed WebSocket API with 99.9% uptime.",
   "main": "dist/index.js",
   "module": "dist/index.mjs",
@@ -12,8 +12,12 @@
       "require": "./dist/index.js"
     }
   },
+  "bin": {
+    "tiktok-live-api": "./bin/demo.mjs"
+  },
   "files": [
     "dist",
+    "bin",
     "README.md",
     "LICENSE"
   ],