Platform

Trovo

Complete integration with Trovo's Open Platform API including real-time chat, moderation, spells, channel management, and comprehensive data access.

Overview

FaustBot provides full coverage of Trovo's Open Platform API, giving you complete control over your Trovo channel and chat.

Real-time Chat

WebSocket-based chat connection for instant message delivery.

Moderation

Ban, timeout, and manage users with full moderation controls.

Spells & Events

React to spell donations, subscriptions, and raids.

Complete API

Access followers, subscribers, viewers, emotes, clips, and VODs.

Trovo Open Platform

FaustBot uses OAuth2 authentication with Trovo's Open Platform. All API features are available once connected.

Setup

Connect your Trovo account to FaustBot:

1

Open Trovo Settings

Navigate to Platforms → Trovo in the FaustBot sidebar.

2

Login with Trovo

Click Login with Trovo to open the authorization page in your browser. Log in with your Trovo account and authorize FaustBot.

3

Connect

After authorization, click Connect to establish the chat connection. Enable Auto-connect to connect automatically on startup.

Permissions

FaustBot requests permissions to read and send chat messages, manage channel settings, access subscriber and follower data, and perform moderation actions.

Triggers

React to events from your Trovo channel:

Chat Message

Fires when a message is sent in chat. Includes user info and message content.

Spell

Fires when a viewer sends a spell. Includes spell name and value.

Subscription

Fires when someone subscribes or resubscribes. Includes months and tier.

Raid

Fires when your channel receives a raid. Includes source channel and viewer count.

Viewer Count

Fires when the viewer count changes significantly.

Connection Status

Fires when the connection state changes (connected, disconnected, reconnecting).

Effects

Use these effects to control your Trovo channel:

Chat Effects

Send Message

Send a message to chat.

Delete Message

Remove a message from chat.

Execute Command

Run a Trovo chat command.

Moderation Effects

Ban User

Permanently ban a user.

Unban User

Remove a ban from a user.

Timeout User

Temporarily mute a user.

Untimeout User

Remove a timeout from a user.

Add Moderator

Grant moderator status.

Remove Moderator

Revoke moderator status.

Channel Effects

Set Title

Update stream title.

Set Category

Change stream category.

Set Game

Set the game by name.

Host Channel

Host another streamer.

Slow Mode

Enable/disable slow mode.

Followers Only

Toggle followers-only mode.

Subscribers Only

Toggle subscribers-only mode.

Scripting API

Access Trovo features from your scripts via the CPH.Trovo* methods:

Sending Messages

Send chat messages 
# Send a message to Trovo chat
CPH.TrovoSendMessage("Hello from FaustBot!")

# Execute a chat command
CPH.TrovoExecuteCommand("shoutout", "targetUsername")

Moderation

Moderate users 
# Ban a user
CPH.TrovoBan(userId, "Rule violation")

# Timeout a user for 5 minutes
CPH.TrovoTimeout(userId, 300, "Please follow the rules")

# Unban a user
CPH.TrovoUnban(userId)

# Remove timeout from a user
CPH.TrovoRemoveTimeout(userId)

Channel Management

Manage channel settings 
# Update stream title
CPH.TrovoSetTitle("Playing with viewers!")

# Set the game/category
CPH.TrovoSetGame("Fortnite")

# Get channel info
info = CPH.TrovoGetChannelInfo()
print(f"Live: {info['is_live']}, Viewers: {info['viewers']}")

# Host another channel
CPH.TrovoHostChannel("streamer_name")

Data Access

Access channel data 
# Get followers
followers = CPH.TrovoGetFollowers(limit=100)
for follower in followers['followers']:
    print(f"Follower: {follower['nickname']}")

# Get subscribers
subs = CPH.TrovoGetSubscribers(limit=50)
for sub in subs['subscribers']:
    print(f"Sub: {sub['nickname']} - Tier {sub['tier']}")

# Get current viewers
viewers = CPH.TrovoGetViewers()
print(f"Current viewers: {len(viewers['viewers'])}")

# Get channel emotes
emotes = CPH.TrovoGetEmotes()
print(f"Channel has {len(emotes['customized_emotes'])} custom emotes")

Additional API Methods

The Trovo API also provides these methods:

TrovoGetTopChannels(limit, categoryId) Get top live channels, optionally filtered by category.
TrovoGetTopCategories(limit) Get the most popular categories on Trovo.
TrovoSearchCategories(query, limit) Search for categories by name.
TrovoGetClips(channelId, limit) Get clips from a channel.
TrovoGetPastStreams(channelId, limit) Get VODs/past broadcasts from a channel.
TrovoGetUsers(usernames) Get user information by username list.

See the scripting reference for the full Trovo API documentation.

Example Use Cases

Spell Alerts

Use the Spell trigger to thank viewers for sending spells and trigger special effects based on the spell value.

Subscriber Perks

React to Subscription events to welcome new subscribers and give them special chat privileges or shoutouts.

Raid Welcome

When receiving a raid, automatically thank the raider and optionally enable slow mode to manage the incoming chat traffic.

Follower Leaderboard

Use the followers API to build a chat command that shows your most recent or longest-following supporters.

Auto-Host

When your stream ends, use the host effect to automatically host a friend or featured streamer.

Category Tracking

Use the categories API to track popular games and update your stream category based on trends.