Chaturbate App · v1.2.0

CB APP
ONBOARDING

Everything you need to install, configure, and get the most out of the Apex Revenue Chaturbate App — from first deploy to advanced commands.

Get Started
Overview

What It Does

The Apex Revenue CB App runs directly inside Chaturbate's developer platform. It powers tip announcements, tipper tier tracking, chat moderation, goal progress, and banner automation — all synced with your browser extension overlay in real time.

Tipper tier system
Bronze → Diamond tiers based on lifetime tips. Auto-badges, enter banners, and special treatment per tier.
Tip goal tracking
Set a token goal. The panel and chat auto-update with progress bars and completion banners.
Chat moderation
Keyword filters, spam detection, link blocking, data masking — all configurable without code.
7 color themes
Apex Purple, Gold VIP, Neon Green, Hot Pink, Ice Blue, Sunset Orange, Stealth Dark.
Recurring banners
Schedule custom chat banners at set intervals with dynamic variables like {total} and {toptipper}.
Extension sync
Tip events, goal data, and session stats stream live into your Apex Revenue browser overlay.
Installation

Install in 5 Steps

The CB App lives entirely inside Chaturbate's developer portal — no downloads required. The whole process takes about 5 minutes.

You must be a verified broadcaster on Chaturbate to access the Developer Portal. Complete account verification first if you haven't already.
1
Open the CB Developer Portal

Navigate to devportal.cb.dev and sign in with your Chaturbate broadcaster account. Click "New App", name it Apex Revenue, then open the IDE view.

https://devportal.cb.dev
2
Paste the Shared Code

In the sidebar click "Shared Code". Clear any existing content and paste both files in this exact order:

First: paste shared-code-additions.js

Second: paste transform-shared-code.js immediately after (no gap)

These files contain the theme engine, tier classification, announcement helpers, and v1.2.0 moderation utilities that every handler depends on.

Both files are in cb-app/shared-code/ inside the Apex-Revenue-Edge GitHub repo.
3
Load the App Settings

Click "Settings" in the Dev Portal, then toggle on "Advanced Settings Editor (JSON)".

Clear the JSON editor and paste the entire contents of settings-merged-minified.json. This loads all 8 setting fieldsets in one paste.

4
Paste Each Handler

Each event type has its own editor in the sidebar. Paste the matching file into each slot:

handler-appstart.js
App Start
Initialises session state, starts timers, whispers broadcaster on load
handler-appstop.js
App Stop
Cleanup and saves persistent data
handler-broadcaststart.js
Broadcast Start
Resets session counters, starts recurring timers, reloads panel
handler-broadcaststop.js
Broadcast Stop
Session summary whisper to broadcaster
handler-callback.js
Callback
Fires recurring banners and auto-announcements on schedule
handler-enter.js
User Enter
New viewer onboarding, known tipper return banners, viewer milestones
handler-tip.js
Tip Received
Records tip, fires announcement or big-tip banner, syncs to extension overlay
handler-follow.js
User Follow
Follow banner in chat, sends install guide whisper to new follower
handler-fanclubjoin.js
Fanclub Join
Fanclub join banner and thank-you whisper to new member
handler-message.js
Chat Message
Handles /apex commands for broadcaster and mods
handler-messagetransform.js
Chat Message Transform
Silent moderation: keyword filter, spam detect, link block, data masking, styling
handler-paneltemplate.js
Broadcast Panel Update
Real-time stats panel: session tips, top tipper, goal progress bar
5
Deploy to Testbed & Go Live

Click "Update on testbed" in the Dev Portal header to deploy to a private test room. Verify everything works before broadcasting.

On a successful start, Apex Revenue will whisper this to you: Apex Revenue v1.1.0 loaded. Type /apex help for commands.

The startup whisper also shows your current theme, announcement status, and tip goal — a fast sanity check that settings loaded correctly.

Features

What Happens Automatically

Once deployed, the app runs without manual input. Here's what fires automatically during a live broadcast.

💬
Tip Announcements

Every tip fires a themed room notice using your chosen color scheme. Tips at or above the Big Tip Threshold (default 100 tokens) get a full banner — separator lines, bold text, accent color — instead of a standard notice.

Announcement templates use {user} {amount} {total} — fully customisable in settings.

🎯
Tip Goal Progress

Enable a tip goal and set a target amount. The broadcast panel shows a live ASCII progress bar. At 25%, 50%, and 75% milestones a subtle chat notice fires automatically. When the goal is hit, a full banner fires and the extension overlay is notified.

👋
Return Tipper Banners

When a viewer who has tipped above the Enter Banner Threshold (default 50 lifetime tokens) enters your room, a banner fires with their tier badge and total. First-time visitors receive a separate welcome onboarding whisper.

🛡
Chat Moderation (v1.2.0)

The Message Transform handler silently processes every message. Configure blocked keywords with actions: replace with ***, hide, or flag. The spam filter catches all-caps abuse and repeated characters. The link filter blocks URLs from non-tippers. Data masking auto-redacts emails, phone numbers, and SSN patterns from chat.

All moderation actions are optionally whispered to you in real time by enabling Mod Log to Owner.

Tipper Tiers

The Tier System

Every tipper is automatically classified based on their lifetime token total tracked across sessions. Tiers appear in enter banners, announcements, and message badges.

TierLifetime tokensBadge emoji
Diamond5,000 +:gem2
Platinum1,000 – 4,999:crown2
Gold500 – 999:goldstar2
Silver100 – 499:silverstar
Bronze10 – 99:star2
New0 – 9:heart22
Tier totals persist across sessions using Chaturbate's key-value storage. A Diamond tipper is still recognised as Diamond the next time they enter your room.
Settings

Configuration Guide

All settings are in the Dev Portal under your app's Settings tab. Click any section to expand it.

Onboarding & Extension Promotion
Welcome message, auto-announce interval
Enable new user onboardingtoggle
Sends a welcome whisper to first-time viewers when they enter. Default: ON
Auto-announce extensiontoggle
Periodically posts a notice promoting the Apex Revenue extension. Default: ON
Announcement intervalnumber
How often (minutes) the auto-announce fires. Range: 5–120. Default: 30
Tip Tracking & Notifications
Acknowledgments, big tip threshold
Send tip acknowledgmentstoggle
Fires a themed notice for standard tips. Turn off for silence on small tips. Default: ON
Big tip thresholdnumber
Tips at or above this amount trigger the full banner treatment. Default: 100 tokens
Custom Announcements
Color theme, tip templates, tip goal
Color themeselect
Applies to all notices and banners. Options: Apex Purple, Gold VIP, Neon Green, Hot Pink, Ice Blue, Sunset Orange, Stealth Dark
Tip announcement messagetext
Template for standard tips. Variables: {user} {amount} {total}
Big tip announcementtext
Template for big tips. Same variables available.
Enable tip goaltoggle
Activates goal tracking, progress milestones, and completion banner. Default: OFF
Tip goal targetnumber
Token amount to reach. Shown as an ASCII bar in the broadcast panel.
Goal progress intervalnumber
Fire a milestone notice every N%. Set 0 to disable. Default: 25 (fires at 25, 50, 75%)
Chat Banners & Triggers
Enter banners, follows, milestones, recurring
Known tipper enter bannertoggle
Fires when a tipper above the lifetime threshold enters. Shows tier and total. Default: ON
Min lifetime tips for bannernumber
Minimum lifetime tokens before enter banner triggers. Default: 50
Follow bannertoggle
Celebrates new followers. Template: {user} {followers}
Fanclub join bannertoggle
Big banner on fanclub join. Template: {user}
Viewer milestone bannertoggle
Fires every N viewers (default 50). Template: {count}
Recurring custom bannertoggle
Posts a custom message on an interval. Variables: {total} {toptipper} {toptips} {viewers} {percent}
Recurring intervalnumber
How often (minutes) the recurring banner fires. Range: 3–120. Default: 15
Chat Moderation & Filtering
Keywords, spam, links, data masking — v1.2.0
Enable moderationtoggle
Master switch for all Message Transform features. Default: ON
Blocked keywordstext
Comma-separated words to filter. Action: replace (***), hide, or flag.
Spam filtertoggle
Detects all-caps abuse and repeated characters. Action: fix or hide. Default caps threshold: 70%
Link filtertoggle
Blocks URLs from non-privileged users. Tippers and fanclub members can be exempted.
Data maskingtoggle
Auto-redacts emails, phone numbers, and SSN patterns from all messages. Default: ON
Mod log to ownertoggle
Whispers you whenever a message is moderated, including the original text if enabled.
Message Styling & Badges
Role-based highlights and badges — v1.2.0
Highlight tipper messagestoggle
Adds a coloured background to messages from viewers who have tipped. Default: ON
Big tipper style thresholdnumber
Lifetime tokens above which the "big tipper" highlight style applies. Default: 500
Show tier badgetoggle
Prepends a Bronze/Gold/Diamond badge to tipper messages so the room can see their rank.
Fanclub badgetoggle
Shows a custom emoji on messages from fanclub members. Default emoji: :heart22
Highlight broadcaster messagestoggle
Gives your own messages a distinct background colour. Default: ON
Chat Commands

/apex Commands

Type these in your chat during a live broadcast. Only you (broadcaster) and your mods can use them — invisible to viewers.

CommandWhat it does
/apex helpFull command menu as a private whisper to you
/apex statsSession stats whisper: total tips, tip count, unique tippers, highest tip
/apex topTop 5 tippers this session as a private whisper
/apex top 10Top N tippers — replace 10 with any number
/apex goalWhispers current goal progress: X/Y tokens (Z%)
/apex goal-announceManually broadcasts goal progress to the whole room
/apex banner <text>Sends a one-off themed banner to chat with your message
/apex ac <text>Sends a one-off themed announcement (lighter than a banner)
/apex announceManually fires the extension promotion announcement
/apex themeWhispers current color theme and announcement toggle status
/apex resetResets all session tip stats and goal tracking to zero
/apex onboardClears onboarding history — all viewers get the welcome message again
/apex statusShows the Apex Revenue extension connection status
/apex startSends an extension start signal (if auto-control is off)
/apex stopSends an extension stop signal
/apex dlWhispers the extension download link to yourself
Broadcast Panel

The Stats Panel

The broadcast panel appears next to your stream and updates automatically on every tip. Choose the display style in Settings → Display.

A
Tips & Top Tipper (default)

Row 1 — Session Tips: Total tokens this broadcast + tip count (e.g. "840 tk (12 tips)")

Row 2 — Top Tipper: The viewer with the highest single tip this session

Row 3 — Goal or Unique Tippers: When a goal is enabled, shows an ASCII progress bar like ██████░░░░ 320/500 tk. Otherwise shows the unique tipper count.

B
Tips Only

Shows only Row 1 — the running total and tip count. Cleaner for broadcasters who prefer minimal info.

C
Disabled

The panel handler exits early and nothing is displayed. Use this if you're running another panel app alongside Apex Revenue.

Pro Tips

Getting the Most Out of It

Set a tip goal at the start of every broadcast. The progress bar and 25/50/75% milestone announcements significantly increase token velocity — viewers can see how close the goal is and are more motivated to push it over.
Use the recurring banner for social proof. A 15-minute recurring message like {total} tokens tipped today — top tipper: {toptipper} with {toptips} tk shows new viewers activity is happening.
Enable data masking and link filtering before going live. These run silently and protect your room from phone number drops and spam links without any manual moderation on your part.
The extension and CB app work together. When both are running, tip events, goal completions, and session data sync directly into your browser overlay in real time.
Use /apex reset sparingly. It clears all session tip totals and goal progress. All-time tier history is preserved in key-value storage, but the session leaderboard starts over from zero.