MIRROR OF GALADRIAKNOW WHAT MAY BE
0 LIVE💡 What to do today worked out on this computer from your own numbers — no key, no internet needed
🤖 Ask Claude
Paste a screenshot straight into the box with Ctrl+V, drag one onto this panel, or use 🖼️. Claude can read what is on the picture — a TikTok screen, an error, a chart.
🔴 LIVE now click a creator to open their full tracker
⚡ Live feed every LIVE in the network, newest first
💬 What chats are talking about live, grouped by topic
🏆 This month's leaderboard tracked by the hub
💎 Diamonds per day last 30 days, all creators
➕ Add creators paste usernames or profile links
📈 Creator performance
💎 Diamonds = coin value of gifts received. ≈ $ uses your diamond value in Settings. Valid days = days with at least 1 hour LIVE. Gift rate = viewers who gifted ÷ viewers who did something. Numbers cover the time the hub was running.
📡 Where your audience comes from
All of this was already being sent by TikTok and thrown away. Source is how a viewer arrived — the daily rank, a recommendation, a search — which is the question growth actually turns on.
How they found the stream
First-time gifters watcher → payer
Languages in chat
Status in the room
🎁 Which gifts actually get sent
What your audience really sends. The gifts sent most often and the gifts that bring in most of the money are usually not the same ones — use the two buttons to see both.
🌍 Earnings by country this month, from the country TikTok reports for each creator
Gifters by the country of the creators they back
TikTok sends no country for a viewer, so this is not where they live — it is where their money goes. Someone who spends almost everything in one country is tied to that market rather than to one person.
👑 Big Gifters saved list · everyone who has gifted at least the amount below across your creators is added automatically
Notes save when you click away. ⭐ keeps someone on the list even below the line; ✕ removes them (they won't be added back). Names open their TikTok profile.
✨ Suggested creators creators you don't track yet, ranked by TikTok in the countries you work in
These come from TikTok's own daily LIVE rankings, so they are creators already doing well on LIVE in your countries. ➕ Track starts watching their public LIVEs — useful for scouting before you approach them. The hub cannot see where your own supporters gift outside your network; this is the closest honest substitute.
🌎 Top LIVE creators
TikTok's own LIVE rankings by country. Great for scouting: ➕ Track adds a creator to your Creators tab so their public LIVEs are watched for you. ✅ Tracking means they are already in your list.
💎 Everyone who supports your creators loading…
Everyone appears once, with their diamonds added up across every creator they support — no duplicate rows. The list has no cut-off and loads more as you scroll, or search to jump straight to someone. ≈ Earned is what your creators receive; ≈ Spent is what the supporter paid. Supporters who gift to 2 or more of your creators are your network's VIPs.
🎭 Enigma gifters
What is an Enigma, and can the hub work out who they are?
Enigma is a TikTok LIVE feature: the viewer is invisible for the stream — identity, badges and gifting all masked — so they arrive with no username and there is no profile to open.
The hub does not try to work out who they are. It is something the viewer deliberately turns on, so a guess would be unreliable and a breach of the thing they chose; a wrong guess passed to a creator is worse than not knowing. What does work: the mask is per-stream, so anyone who stops using it reappears under their real name on their own. And the creator receiving the gifts is the one person placed to build that relationship — which is why the Spent on column is the part you can act on.
💬 Who is talking to each other
A room looks like one crowd, but it is usually several conversations at once. Every message that names somebody is a thread between two people — these are the little groups that form from them. The same faces turning up together across different creators' rooms is the interesting part.
🌍 By country worked out on its own from what TikTok tells us
TikTok sends a country with the room info every time a creator goes live, so this sorts itself. Click Make it a group and it becomes one of your own groups, which you can then rename and edit.
🏷️ Your groups the ones you decide on — a manager's roster, a campaign, a payout tier
A creator can be in as many groups as you like. Groups are yours and are kept when the hub restarts; putting someone in one never changes how they are tracked.
🧩 Worked-out groups supporters and creators sorted into the ones who behave the same way — and why
🕸️ Supporter web who gifts to which creator, and who they share
Each large glowing dot is one of your creators, coloured by country; each small dot is a supporter, sitting beside whoever they actually gift to. Gold dots support more than one creator — those are the people holding your network together. Drag to turn it, scroll to zoom, hold Shift and drag to slide, click a dot to inspect it, double-click the background to start or stop the spin. Gifts arriving in a LIVE fly down the line as they happen.
🤝 Network Boost viewers find your other creators, nobody has to talk about it
Each creator's game shows a small "PRIMAL FAMILY LIVE" banner at the top of the screen for a few seconds every few minutes, with the names of network creators who are LIVE right now. When someone goes LIVE, it shows "JUST WENT LIVE".
- Tick who should be promoted, then Copy network code.
- Post it in your Discord.
- Each creator pastes it once in their game's setup page (🦁 Primal Network Boost box) and clicks Save.
- Added a new creator? Copy the code again and repost it.
🔴 Promoted right now
More ways to cross-promote: invite each other to multi-guest LIVEs and LIVE battles, and schedule creators back-to-back so one ends as the next starts.
🛠️ Builder change the hub itself — describe what you want and approve the change
Ask for a change in plain words — "make the live feed taller", "add a column for follows", "put the Keys tab first". It reads the hub's own code, shows you exactly what it wants to change, and writes nothing until you press Apply. Every edit is backed up first, and anything that would break the file is refused before it is written.
↩ Undo a change
The Builder is deliberately kept apart from the Assistant: it can see the hub's code but none of your data — no creators, no supporters, no chat, no keys. The Assistant is the other way round. That way nothing a stranger types in a LIVE can ever reach the part that writes code.
🔑 Euler keys
Each creator is pinned to one key and stays there; anyone new goes to whichever key is carrying the fewest. More keys do not buy you more requests — your allowance belongs to your Euler account, and every key draws on that same pool. Extra keys are useful for keeping work separate or swapping one out, not for going faster.
📊 Your Euler allowance
Your allowance belongs to your Euler account, not to each key — every key you paste is another door into the same room, so adding keys does not give you more requests. The hub paces itself against the three limits below and eases off the full connection tests before any of them runs out. Leave a box empty to use what Euler reports.
⚙️ Settings
🛰️ Let Euler do the asking
Every "is this creator live?" check leaves this computer and lands on TikTok from your home internet connection — 674 of them, round after round. That is what TikTok is rate-limiting, and more Euler keys do not change it: keys are for connecting to a room once you know somebody is live, not for the asking. Euler's bulk check moves the asking to their servers. One request from here carries fifty usernames; their machines ask TikTok and send back the answers. That is the only thing that genuinely spreads the load.
🔗 Connect to Euler (OAuth)
The bulk live check will not take your API key — Euler needs an OAuth token instead. This does the whole exchange on this computer: nothing is copied by hand and your TikTok password is never involved.
Euler answered 422 — "Either x-oauth-token or x-cookie-header must be provided". Their documentation says the bulk live check accepts one of two things, and the API key you already have is not one of them:
- An Euler OAuth token — created from an OAuth app in your Euler account. Use this one. It is made for this, it can be revoked on its own, and it never exposes your TikTok password.
- Raw TikTok cookies: not accepted on this site. That is your actual TikTok login session, and this site serves other people.
The token is kept on the server only, in its own file outside backups, shown masked, never printed and never given to the assistant or to a customer. Clear the box and save to remove it.
This is safe to leave on. It only ever adds answers — your creators carry on being checked the normal way too, so a wrong address here can never leave you seeing nobody live.
Numeric TikTok ids
Euler's bulk check is addressed by each creator's numeric TikTok id, not their @name. The hub learns one every time it connects to a creator who is live, and keeps it for good — ids never change. For creators it has not caught live yet, this fetches them from Euler in one go. It is a one-off, and it does not ask TikTok, so it does not feed the rate limit.
Not sure of the addresses?
Euler move these around, and they answer an unknown address with Route … DNE — which means the hub can simply ask. This tries each likely address and keeps whichever works.
🆓 Free clues from the leaderboards
Euler's ranking lists do not count against your allowance, and they name creators who are live right now. Any of yours on one gets checked first. It is only ever a clue — the hub still confirms properly before saying anyone is live — so it costs nothing and cannot be wrong. Here is whether it is earning its place:
Copy the exact addresses from your Euler dashboard if either is wrong (their API docs call them bulk live check and retrieve TikTok user basic). The test says plainly whether it worked, and shows what came back if it did not.
🔔 Instant go-live alerts from Euler
Right now the hub finds out a creator is live by asking TikTok, over and over, for every creator on your list. On a roster your size that is what gets you rate-limited. Euler Stream can turn it around: it tells this hub the moment one of your creators starts — no asking, no quota, and the hub knows in a second or two instead of waiting for its turn.
🌍 Where does a creator's country come from?
We checked, and the answer was not what we expected: TikTok does not send a country in the live room reply at all. A census of real rooms found no country code anywhere in them — the one field that looks like it should hold one, idc_region, comes through empty every time. So the country cannot simply be read off; it has to come from somewhere else.
The hub now tries four sources, best first: what you set yourself (always wins), TikTok's regional leaderboards, TikTok's creator search, and last which of TikTok's data centres hosts the creator's profile picture — accounts are served from the one nearest them, so the path is a real clue. That last one is a guess, and the hub marks it as one: a small orange ~ beside the flag, everywhere it appears. Hover any flag to see where that country came from. If a guess is wrong, set it yourself on the creator's card and it will never be overwritten.
The room census below is what established the above. It is kept because it is the evidence, and because TikTok may start sending a country one day.
🔬 What does TikTok actually send about a viewer?
The hub keeps a fixed set of fields per viewer and drops the rest, which is why things like guardian status cannot simply be dug out of your recordings. This takes a census of the first few hundred viewers seen in a LIVE and reports every field TikTok really sends. If guardian is in there, it will show up here and I can build the list from it. If it is not, we will know that for certain instead of guessing.
🩺 Something is wrong — what is it?
If the window is full of "TikTok would not say whether they are live", press this. It runs real checks with nothing hidden and tells you which of the four possible causes it actually is: your internet, your Euler key, a rate limit on your connection, or something that has already passed.
📡 What TikTok is sending
Every kind of message the hub has received since it started, with how many have arrived. In use means the hub turns it into something you can see; the rest are being counted but not kept. Leave the hub running a day or two, then tell the 🛠️ Builder which of these you want captured.
💾 Your data
📥 Creators missing? Bring them over
If you unzipped a new copy of the hub into a different folder, your creators are still in the old one — the hub only looks next to itself. Paste that old folder here and they come straight across. Nothing is deleted and nothing already here is overwritten.
🎬 Recordings every event exactly as it arrived
The saved stats are totals, and totals cannot be un-summed. So every chat message, gift, join, like and follow is also written down in the order it happened — one file per LIVE, compressed (usually about a tenth of the raw size). ⬇ Excel turns any of them into a spreadsheet.
The hub keeps a dated copy of everything each day for the last 14 days, in a backups folder inside the location above. To go back to an earlier day, close the hub, copy that day's data folder and settings.json over the current ones, and start the hub again.
Money is an estimate: TikTok pays creators about $0.005 per diamond (a gift's coin price = the diamonds the creator gets), and viewers pay about $0.0105 to $0.014 per coin depending on the package and where they buy (the app costs more than the website). Exact payouts vary by country and taxes; TikTok's own LIVE Center shows the real amount.
Creators can also connect themselves with the Creator Connect page (in the creator-page folder): they paste their message in Discord, you paste it in the Creators tab.