Slot machine game for TikTok LIVE, version 1.0.0
Spin Mania
Your chat pulls the lever. Points only.

How to play
A viewer types spin and sits down at one of three machines with their own name and photo. The four reels stop one by one: three matching symbols win points, four win big, and four red 7s win the jackpot pool. Every point goes onto the leaderboard.
$14
One-time, buyer fee included
Tools License on CodeCanyon
Four ways to earn a spin
Spins come from what viewers already do on a LIVE. Every number here is a setting.
-
Chat
A viewer types spin in chat
1 free spin every 30 seconds. Up to 10 chat words in any language, and the word can sit inside a comment.
-
Follow
A viewer follows you
1 free spin, once per viewer.
-
Likes
Every 100 likes
1 spin. Likes add up per viewer, so slow tappers get there too.
-
Gifts
Every gift coin
1 spin per coin, up to 1,000 spins per gift. Combos count in full, with no multipliers.
Three machines, one fair line
Spins wait in one line in the order they came in, and three machines work through it at once.
- Turns
- A viewer plays up to 10 spins in a row, then the next viewer sits down. A 1,000-spin gift never blocks a single chat spin.
- On the machine
- The player's photo, name and points, and the spins they have left on rolling digit drums.
- The stop
- Reels stop one by one. When a big result is still possible, the last reel keeps spinning under a blinking frame before it lands.
- On the server
- The machines run on the server, so OBS, preview windows and page refreshes always show the same reels.


The paytable
Three matching symbols anywhere on the line win points. Four win big. The default points are below, and every one of them is a setting.
| Symbol | 3 of a kind | 4 of a kind |
|---|---|---|
| 10 | 50 | |
| 12 | 60 | |
| 15 | 75 | |
| 18 | 90 | |
| 24 | 120 | |
| 36 | 180 | |
| 60 | 300 | |
| 100 | 500 | |
| 200 | 1,000 | |
| 400 | Jackpot pool |

Progressive jackpot
5,000 + 10 a spin
The pool starts at 5,000 points and every viewer spin adds 10. Four red 7s win all of it in a full-screen moment, and the pool starts again.
How often it pays
Three presets, Hard by default, like a real casino slot. On a losing spin the game often lands a near miss: two 7s, diamonds or BARs on the line with the next one just above or below it.
| Preset | 3 of a kind | 4 of a kind | Jackpot | Near misses |
|---|---|---|---|---|
| HardDefault | 4.5% | 0.4% | 1 in 25,000 | 40% of losses |
| Normal | 8.95% | 1% | 1 in 20,000 | 30% of losses |
| EasySmall streams | 12% | 2.5% | 1 in 8,000 | 22% of losses |
Points only
Nothing is bought, and nothing of value is won.
Spins come from chat, follows, likes and the gifts viewers send you anyway. Wins are leaderboard points with no cash value, and the game screen never mentions coins or money: gifts give spins and wins give points.
Never offer money, prizes or anything of value for points, wins or jackpots. TikTok's rules for LIVE do not allow gambling content, so read them before you stream any slot-style game. The documentation says the same in its own section.
Thank-yous that never cover the reels
Every gift is thanked on screen, sized by its coins. Big thank-yous wait their turn, so every gifter gets their own moment.
-
1to 9 coins
A notification
A short card with the gift and the spins it gave. Follows and every 100 likes get the same card.

-
10+coins
A marquee banner
The sender's photo and the gift on a banner with chasing bulbs and fireworks, above the machines.

-
500+coins
A spotlight
The sender's photo with confetti and fireworks. Their spins start on the machines below while the spotlight is still up.

When chat goes quiet, the machines keep moving
Like a casino floor at a slow hour, Spin Mania has an attract mode for the quiet minutes of a LIVE.
- House spins
- Whenever all machines are free and nobody is waiting, a house spin runs every 8 seconds. House spins never score, never touch the jackpot and always wait behind viewers.
- Attract mode
- After 20 seconds without a viewer spin, free machines say Type spin. The next viewer spin ends it.
- Pause
- Freeze the machines while you talk to chat. Chat, follows, likes and gifts still line spins up, and they play when you resume.
- Light effects
- For a slower streaming PC, Light draws the reels at a lower resolution and 30 frames per second, with fewer fireworks. The results stay the same.


Laid out around the LIVE app
On a phone, the LIVE app draws its header over the top of your stream and its chat over the bottom. Spin Mania keeps everything that matters in between.
- Top
- Left clear for the LIVE header with your name and the viewer count.
- Upper 62%
- The sign with the jackpot, the leaderboard, the three machines and the gift thank-yous.
- Bottom 38%
- Calm velvet. The chat, the gift bar and the comment field can run over it without hiding anything that matters.
The screen is locked to 9:16. Add it as a 1080 x 1920 Browser Source, and for a horizontal stream scale it down in OBS. Refreshing the source or restarting OBS is safe, because the machines keep running on the server.
Your control room
The Admin Panel runs in the browser, and on a phone on the same Wi-Fi. Changes reach the running game straight away, without a restart.







What you download
Version 1.0.0, first released in October 2026. Updates are free from your CodeCanyon Downloads page.
- 10original slot symbols, as SVG files you can replace
- 13original sound effects, each replaceable with your own file
- 4Admin Panel tabs: Live, TikTok, Settings and Sounds
- 2start scripts: START_GAME.bat and start_game.sh
In the package
- Full Python, HTML, CSS and JavaScript source code. The machines, the sign, the bulbs and the effects are drawn in code.
- Documentation with screenshots: installation, OBS, the TikTok connection, every rule and setting, and how to change colors, fonts and the logo.
- Flask, Flask-SocketIO and TikTokLive install from PyPI through requirements.txt or the start script.
- No TikTok gift artwork. The game shows the gift pictures from TikTok's own servers, and its own gift box where none is available.

From download to live in five steps
- Step 1
Install Python 3.10+
On Windows, tick Add Python to PATH in the installer.
- Step 2
Run the start script
Open the Source folder and double-click START_GAME.bat, or run start_game.sh on macOS and Linux. It installs the requirements and starts the server.
- Step 3
Copy the password
The server window shows a new Admin Panel password at every start. Keep that window open while you stream.
- Step 4
Add the Browser Source
In OBS or TikTok LIVE Studio, add a Browser Source at http://localhost:5000 with a width of 1080 and a height of 1920.
- Step 5
Test, then connect
Open localhost:5000/admin and try the machines with Test without going live. Then go live, type your username in the TikTok tab and click Connect.
pip install -r requirements.txt
python app.py
Requirements
- Operating system
- Windows 10 or 11. A start script for macOS and Linux is included.
- Python
- 3.10 or newer
- Streaming app
- OBS Studio, TikTok LIVE Studio, Streamlabs Desktop or another app with a Browser Source
- Browser Source
- 1080 x 1920, locked to 9:16
- Internet
- A connection for the LIVE data and TikTok's gift pictures
- TikTok
- An account that can go LIVE. The game never asks for your TikTok password.
Pay once, run it on your own PC
Spin Mania is sold on CodeCanyon. The game server, the machines and your leaderboard all run on your own computer.
- Full Python, HTML, CSS and JavaScript source code
- Three slot machines with a fair line and a jackpot pool of points
- Admin Panel with a test mode for chat, follows, likes and gifts
- Ten original symbols and thirteen original sound effects
- Documentation with screenshots and start scripts for Windows, macOS and Linux
Good to know
The live connection reads TikTok's unofficial LIVE data through the open-source TikTokLive library, and each connection is signed by Euler Stream, a third-party service. Changes on their side can stop the connection until the item is updated. Euler Stream's free plan has a daily limit; if you stream often you may need a paid plan, billed monthly by Euler Stream and not included in this price. TikTok is a trademark of ByteDance Ltd. Spin Mania is an independent product, not affiliated with, endorsed or supported by TikTok, ByteDance or Euler Stream.
Tools License, CodeCanyon
$14
One-time payment, buyer fee included
- Full source code
- Free updates from your Downloads page
- Item support through CodeCanyon
- Documentation included
Questions before you buy
Is this gambling?
No. Viewers never pay to play and never win anything of value. Spins come from chat, follows, likes and gifts the viewer sends to you anyway, and wins are leaderboard points with no cash value. The game screen never mentions coins or money. Never offer money, prizes or anything of value for points, wins or jackpots, and read TikTok's LIVE rules before you stream any slot-style game.
Can I try it without going live?
Yes. The Live tab of the Admin Panel has a Test without going live card: type the spin word, follow, send likes and send any gift as a test viewer. It can also show a test jackpot that gives no points. Test players land on the leaderboard, so reset it before your stream.
How hard is it to win?
Hard is the default: three of a kind on 4.5% of spins, four of a kind on 0.4% and the jackpot about once in 25,000 spins. Normal and Easy give more wins for smaller streams, and the points for every result are editable, with the chance of each result shown next to it.
Will one big gift block everyone else?
No. Spins wait in one line in the order they came in. A viewer plays up to 10 spins in a row, then the next viewer sits down, and three machines play at once, so the line keeps moving.
How does the jackpot grow?
The pool starts at 5,000 points and every viewer spin adds 10. Four red 7s win the whole pool and it starts again. House spins never touch it. Both numbers are settings.
Does it need my TikTok password?
No. It only reads the public comments, follows, likes and gifts of your LIVE, using your username.
Why does TikTok refuse the connection?
TikTokLive signs each connection through Euler Stream, whose free plan has a daily request limit. A rate-limit message usually clears after a few minutes, and a key from Euler Stream raises the limit. Also check that you are live on the account you typed, without the @.
The game is slow on my PC. What can I do?
Set Effects quality to Light in Settings. It draws the reels at a lower resolution and 30 frames per second, with fewer fireworks. The results are the same; only the drawing gets lighter.
Can I change the symbols and colors?
Yes. The ten symbols are SVG files you can replace, the title you set becomes the marquee sign, and the documentation shows how to change the colors, the fonts and the logo.
What does the purchase include?
The full Python, HTML, CSS and JavaScript source code, the documentation with screenshots, the ten slot symbols as SVG files, thirteen original sound effects and start scripts for Windows, macOS and Linux. TikTok gift artwork is not included: the game shows the gift pictures from TikTok's own servers, and its own gift box where none is available.
Can I get a refund?
Refunds follow the Envato Market refund rules on CodeCanyon. They cover items that are not as described, do not work and cannot be fixed, have an unpatched security issue, or come without the promised support, within 180 days for supported CodeCanyon items. A change of mind is not covered. Contact us first so we can try to fix the problem.
Open the casino floor, points only
One purchase, running on your own PC. Test every spin and gift in the Admin Panel before you go live.