Open Source Libraries

Rust

Connect to TikTok LIVE streams in real-time with the TikTokLiveRust library.

|View as Markdown|

TikTokLiveRust is a Rust library for connecting to TikTok LIVE streams. It provides an async, event-driven API built on Tokio.

View the full source on GitHub.

Quickstart

1

Add dependencies

Add to your Cargo.toml:

[dependencies]
tiktoklive = "0.0.19"
tokio = { version = "1.35.1", features = ["full"] }
log = "0.4"
env_logger = "0.10.1"
2

Connect and listen to events

use tiktoklive::{
    core::live_client::TikTokLiveClient,
    data::live_common::TikTokLiveSettings,
    generated::events::TikTokLiveEvent,
    TikTokLive,
};

#[tokio::main]
async fn main() {
    let client = TikTokLive::new_client("username")
        .configure(|settings| {
            settings.sign_api_key = "YOUR_API_KEY".to_string();
        })
        .on_event(handle_event)
        .build();

    if let Err(e) = client.connect().await {
        eprintln!("Error: {}", e);
    }
}

fn handle_event(client: &TikTokLiveClient, event: &TikTokLiveEvent) {
    match event {
        TikTokLiveEvent::OnChat(e) => {
            println!("{}: {}", e.raw_data.user.nickname, e.raw_data.content);
        }
        TikTokLiveEvent::OnGift(e) => {
            println!("{} sent {} x{}",
                e.raw_data.user.nickname,
                e.raw_data.gift.name,
                e.raw_data.gift.combo
            );
        }
        TikTokLiveEvent::OnMember(e) => {
            println!("{} joined", e.raw_data.user.nickname);
        }
        _ => {}
    }
}

Common Events

EventDescription
OnChatA viewer sent a chat message
OnGiftA viewer sent a gift
OnMemberA viewer joined the stream
OnLikeA viewer liked the stream
OnConnectedSuccessfully connected