Skip to content

A TikTok - Live Watcher application for tty / cli - for the unlikely situation when you live in tty, but want to watch TikTok Live.

License

Notifications You must be signed in to change notification settings

tragdate/ttytok

Repository files navigation

ttytok

Description

ttytok is an application that integrates with TikTok using reversed engineered my rust crate . It allows you to monitor live streams, chat events, and user actions in real-time using various tools and utilities.

Screenshot

image

Features

  • Handle and log various TikTok live events including chats, user joins, and gifts.
  • Use tmux for an organized multi-pane display.
  • Simple scripts for adding and removing TikTok users to monitor.
  • Fuzzy finder UI to select TikTok user accounts for live stream monitoring.
  • Real-time updates displayed in terminal panes.

Requirements

  • Unix-like operating system (Linux, macOS)
  • Root privileges for installation.
  • Basic utilities like bash, tmux, fzf, inotify-tools, mpv.

Installation

  1. Start by installing necessary packages. Run the install_req.sh script which will install the required packages based on your package manager:

    ./install_req.sh
  2. Build the Rust connector binary:

    2.1. Make sure you have cargo and rust installed:

    curl --proto '=https' --tlsv1.2 -sSf https://sh.rustup.rs | sh -s -- -y

    2.2. Build the binary:

    make
  3. Install the built binary and related scripts:

    sudo make install

Usage

Running ttytok

To start using ttytok, simply run the installed executable:

ttytok

This will start a tmux session with multiple panes, displaying different aspects of the monitored TikTok live stream and events.

Managing Users

  • Add User:

    ttytok add "USERNAME"
  • Remove User:

    ttytok remove "USERNAME"
  • List Users:

    ttytok list
  • Add Cookie:

    ttytok addcookie "COOKIE_STRING"

Build and Cleaning

  • Build:

    make
  • Clean Build Files:

    make clean

Uninstalling

To completely remove ttytok and all its components:

sudo make uninstall

Author

Developed by TragDate

License

This project is licensed under the MIT License. See the LICENSE file for more details.

GIB ME MONEH 🪙:

BTC bc1q0dvmajcammgpesu2flamrdj6rs75cuhum5jyj6

ETH 0x3BD77790fc6409441142eb622008d2CdA88aF40c

SOL 3BHNm9d9gRaEMhn8yyxN17FD3cNgz55VESj1h6VH467a

About

A TikTok - Live Watcher application for tty / cli - for the unlikely situation when you live in tty, but want to watch TikTok Live.

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published