tiktoklive 0.0.9

A Rust library. Use it to receive live stream events such as comments and gifts in realtime from TikTok LIVE No credentials are required.
Documentation

❤️❤️🎁 Connect to TikTok live in 3 lines 🎁❤️❤️

Introduction

A Rust library. Use it to receive live stream events such as comments and gifts in realtime from TikTok LIVE No credentials are required.

Join the support discord and visit the #rust-support channel for questions, contributions and ideas. Feel free to make pull requests with missing/new features, fixes, etc

Do you prefer other programming languages?

NOTE: This is not an official API. It's a reverse engineering project.

Overview

Getting started

[dependencies]
 tiktoklive = "0.0.9"

use std::time::Duration;
use tiktoklive::core::live_client::TikTokLiveClient;
use tiktoklive::data::live_common::TikTokLiveSettings;
use tiktoklive::generated::events::TikTokLiveEvent;
use tiktoklive::TikTokLive;
use tokio::signal;

#[tokio::main]
async fn main() {
    let user_name = "dash4214";
    let client = TikTokLive::new_client(user_name)
        .configure(configure)
        .on_event(handle_event)
        .build();

    let _ = tokio::spawn(async move {
        client.connect().await;
    });

    //Wait for Ctrl+C to exit
    signal::ctrl_c().await.expect("Failed to listen for Ctrl+C");
}

fn handle_event(_client: &TikTokLiveClient, event: &TikTokLiveEvent) {
    match event {
        TikTokLiveEvent::OnMember(join_event) => {
            println!("user: {}  joined", join_event.raw_data.user.nickname);
        }

        TikTokLiveEvent::OnChat(chat_event) => {
            println!(
                "user: {} -> {} ",
                chat_event.raw_data.user.nickname, chat_event.raw_data.content
            );
        }

        TikTokLiveEvent::OnGift(gift_event) => {
            let nick = &gift_event.raw_data.user.nickname;
            let gift_name = &gift_event.raw_data.gift.name;
            let gifts_amount = gift_event.raw_data.gift.combo;

            println!(
                "user: {} sends gift: {} x {}",
                nick, gift_name, gifts_amount
            );
        }

        TikTokLiveEvent::OnLike(like_event) => {
            let nick = &like_event.raw_data.user.nickname;
            println!("user: {} likes", nick);
        }
        _ => {}
    }
}

fn configure(settings: &mut TikTokLiveSettings) {
    settings.http_data.time_out = Duration::from_secs(12);
}

For streams that are flagged adult/disturbing

You should use an authenticated account by injecting the cookie in the headers

fn configure(settings: &mut TikTokLiveSettings) {
    settings.http_data.time_out = Duration::from_secs(12);
    settings
        .http_data
        .headers
        .insert("Cookie".to_string(), "your-cookie".to_string());
}

Contributing

Your improvements are welcome! Feel free to open an issue or pull request.

Contributors

Zmole Cristian