GiftShow Complete Tutorial
This guide covers every feature in detail — from first setup to advanced configuration. Read the Getting Started section first, then jump to whichever feature you need. Every parameter is explained so you know exactly what each setting does.
Product Overview
GiftShow is a TikTok Live gift effects overlay tool for Windows. When viewers send gifts, it automatically plays your configured effects in a transparent floating window on top of your screen — in real time, with no manual action needed.
How it works — step by step:
GiftShow is designed for TikTok Live streamers who broadcast from a PC. Whether you're using TikTok Live Studio, OBS, or any other setup, GiftShow's transparent overlay works on top of everything.
System Requirements
| Component | Requirement | Notes |
|---|---|---|
| Operating System | Windows 10 / Windows 11 (64-bit) | 32-bit not supported |
| RAM | 4GB minimum | 8GB recommended for smooth video effects |
| Disk Space | 200MB+ (plus your effect files) | App itself ~120MB |
| Internet | Stable connection required | Needed for license verification and connecting to your TikTok Live |
| TikTok Account | Account with Live access enabled | Account must be actively streaming to connect |
| Display | 1280×720 minimum | 1920×1080 recommended for overlay positioning |
GiftShow is a portable EXE file — just double-click to run, no installation needed. On first launch Windows may show a security warning; click "More info" → "Run anyway". We recommend storing the EXE in a permanent folder like D:\GiftShow\ rather than Desktop or Downloads.
Installation & Activation
Step 1: Get Your Activation Key
After purchasing on the website, your activation key is emailed to you. It looks like: GSHO-XXXX-XXXX-XXXX-XXXX.
Copy the full key including all hyphens. Do not type it manually — copy-paste from your email to avoid typos.
Step 2: Download and Run
- Download the latest
GiftShow-vX.X.X-portable.exefrom the Download page - Move the EXE to a permanent folder, e.g.
D:\GiftShow\ - Double-click the EXE. If Windows shows "Windows protected your PC", click "More info" → "Run anyway"
- Wait 3–5 seconds for the GiftShow main window to appear
Step 3: Enter Your Activation Key
- On first launch, the "🔑 License" input field is visible at the top of the main interface
- Paste your activation key into the field (Ctrl+V)
- Click "Verify License"
- GiftShow connects to the license server (takes 2–5 seconds). On success, the status bar shows 🟢 License: Verified
- The field is automatically disabled and shows "Verified." On future launches, GiftShow remembers your key automatically — no re-entry needed
After successful verification, your key is saved locally. As long as you don't clear app data, every launch auto-verifies without you doing anything.
• Check your internet connection (needs to reach international servers)
• Confirm the key is complete with no extra spaces
• If it says "already used on another device," contact support to transfer
Interface Walkthrough
The GiftShow main window has three zones:
Status Bar Indicators
| Status | Meaning | Color |
|---|---|---|
| License: Verified | License server connection OK, key is valid | 🟢 Green |
| License: Unverified | Key not yet verified or verification failed | ⚪ Gray |
| TikTok: Connected | Receiving live stream data in real time | 🟢 Green |
| TikTok: Disconnected | Not yet connected or disconnected | ⚪ Gray |
| TikTok: Connecting… | Connection attempt in progress | 🟡 Yellow |
Left Panel Buttons
| Button | Function |
|---|---|
| 🎬 Gift FX | Opens the gift effects config modal (named gifts / value tiers / built-in animations) |
| 👑 VIP FX | Opens the VIP boss system config modal |
| 👋 Join FX | Opens the entry count and keyword trigger config modal |
| ✨ Create Window | Creates the transparent overlay window |
| ⏹️ Close Window | Closes the transparent overlay window |
| 🏆 Leaderboard | View the current session's gifting leaderboard |
| 🧪 Test All Features | One-click test of all overlay elements (overlay must exist first) |
Connecting to Your TikTok Live
Your TikTok account must be actively streaming. GiftShow can only connect to a live stream that is currently in progress — not to accounts that are offline or haven't started yet.
Connection Steps
- Confirm your license is verified (status bar shows 🟢 License: Verified)
- Find the "TikTok:" input field in the left panel
- Enter your TikTok username. No @ symbol — if your profile URL is
tiktok.com/@myname, entermyname - Click "Connect Live"
- Wait 2–10 seconds. On success, the status bar shows 🟢 TikTok: Connected
- The log area on the right will show "✅ TikTok live connected." Incoming gifts and chat messages will start appearing in the log
Disconnecting
Click "Disconnect" at any time to end the connection. Recommended after each session to free up resources.
Connection Errors Reference
| Error | Cause | Fix |
|---|---|---|
| Username not found | Typo in username or account doesn't exist | Check your TikTok profile URL for the exact username |
| Not currently live | Account isn't streaming right now | Start your TikTok Live first, then connect |
| Connection timeout | Unstable network or temporary service issue | Check internet, wait 30 seconds, try again |
| License invalid | License key not verified | Complete license verification first |
After connecting, watch the log area on the right. Every gift, chat message, and viewer entry appears in real time. If gifts aren't triggering effects, the log shows exactly what gift name was received — use this to match against your configuration.
Named Gift Effects
Named gift effects are the highest-priority trigger: you bind a specific effect file to an exact gift name. When that gift name matches precisely, the effect fires regardless of diamond value.
Opening the Config Modal
- Click "🎬 Gift FX" in the left panel
- The modal has three tabs at the top: "🎯 Specific Gifts (Priority)", "💎 Value Tiers", "🎁 Built-in Effects" — click the first tab
Adding a Named Gift Effect
- In "Gift Name", type the exact gift name as it appears on TikTok. For example:
Rose,Lion,TikTok Universe - Click "Select File" and choose a local media file (MP4 / GIF / PNG / WebM / MP3)
- Adjust parameters as needed (see full parameter table below)
- Click "➕ Add Gift" to save
- The new entry appears in the list below — it's now active
All Parameters Explained
Rose and rose are treated as different names. Best practice: let a viewer send the gift, then copy the name directly from the log.Editing and Deleting Existing Configs
- Click "Edit" next to any entry → the form pre-fills with that entry's settings. Modify and click "Save Changes"
- Click "Delete" → a confirmation dialog appears. Confirm to remove
- Changing the gift name in edit mode replaces the old name's entry with the new one
The most reliable approach: go live, have a viewer send the gift, then look at the GiftShow log. You'll see a line like 🎁 @username sent [GiftName] — copy exactly what appears in brackets.
Value Tier Effects
Value tiers are a fallback system: when a gift doesn't match any named configuration, GiftShow checks the gift's diamond value and plays the effect for the matching tier.
Adding a Value Tier
- In the Gift Effects modal, click the "💎 Value Tiers" tab
- Set the Min Diamonds and Max Diamonds to define the range
- Select an effect file and configure display parameters
- Click "➕ Add Tier" to save
Recommended Tier Structure
| Tier | Diamond Range | Effect Suggestion |
|---|---|---|
| Small gift | 1 – 99 | Lightweight GIF or built-in animation, 2–3s |
| Medium gift | 100 – 999 | MP4 animation, 4–5s, medium size |
| Large gift | 1,000 – 4,999 | Impressive MP4, 6–8s, large display size |
| Super gift | 5,000+ | Most dramatic effect + text overlay |
Tier diamond ranges must not intersect. For example, you can't have "1–100" and "50–200" simultaneously — GiftShow will flag the conflict and block saving. Keep ranges contiguous: 1–99, 100–999, 1000–4999, 5000+.
Built-in Animations
GiftShow ships with 13 built-in animation types. Zero media files needed — they run entirely within the app. When a gift name (or its alias) matches one of these types and no custom effect is configured for that gift, the built-in animation fires automatically.
Accessing Built-in Effects Settings
In the Gift Effects modal, click the "🎁 Built-in Effects" tab. You'll see all 13 effects as cards showing their emoji, name, aliases, animation style, and current enabled/disabled state.
All 13 Built-in Effects
Toggling Effects On/Off
Click any effect card to toggle it on or off. Disabled effects won't fire even if the gift name matches. The panel header has "✅ Enable All" and "✗ Disable All" quick-toggle buttons.
Built-in effects use an alias list to support multiple languages. The Lion gift in Brazilian TikTok appears as leao, in Spanish-speaking regions as leon — both trigger the lion burst animation. For any gift name not in these aliases, configure a Named Gift Effect for precise matching.
Text Overlay Configuration
Text overlay displays a custom text string on screen while the effect plays — useful for showing the gift name, the sender's username, a thank-you message, or any custom text. Both Named Gift Effects and Value Tiers support independent text overlay settings.
Enabling Text Overlay
When adding or editing a named gift or tier, find the "📝 Text Overlay" section and check the enable checkbox. The detailed options will expand.
Text Overlay Parameters
{name} (sender's username), {gift} (gift name), {value} (diamond count). Example: Thanks {name} for the {gift}!#FFD700 for gold). Click the color swatch to open the picker.Don't want video — just a text notification? Leave "Effect File" empty and only enable Text Overlay. GiftShow will show the text without any video/image effect.
Advanced Parameters
Edge Fade
Edge Fade creates a soft transparency gradient at the edges of your effect media, blending it into the background. This eliminates the hard rectangle border that appears when using regular MP4 videos on a transparent overlay.
| Value | Effect | Best Used For |
|---|---|---|
| 0% | No fade, hard edges | WebM with alpha channel, or black-background video |
| 10–15% | Subtle edge softening | Most regular MP4 videos |
| 20–30% | Noticeable blend | When you need very natural blending |
| 40%+ | Strong fade, smaller visible center | Special artistic effects |
Max Concurrent Playback
Controls how many simultaneous instances of the same gift effect can play at once:
- 1: Only one at a time — good for premium gifts (Lion, Fireworks) to keep the screen clean
- 2–3: A few can overlap briefly — works well for medium-tier gifts
- 5+: Many play simultaneously — great for small gifts like Roses to create a "flower rain" effect
Priority & Match Logic
When a gift arrives, GiftShow looks for a matching effect in this exact order:
Gift received: "Rose" (5💎)
1. Check named gifts for "Rose" → if you configured it, plays your custom MP4 ✓
2. If no named config → checks built-in "rose" alias → if Rose animation is enabled, plays falling animation ✓
3. If built-in disabled → checks 1–99💎 tier → plays tier effect ✓
4. If no tier configured → no visual effect, gift only appears in the log
Creating the Transparent Overlay Window
The transparent overlay is GiftShow's signature feature: an always-on-top, transparent-background, click-through floating window that covers your entire screen, letting all effects render directly in your stream view.
Steps to Create
- Make sure TikTok Live is connected
- (Optional) Configure overlay settings first via the "Transparent Window Config" panel
- Click "✨ Create Window" in the left panel
- The overlay is now active over your screen. Since it's transparent and click-through, you won't see much difference visually — use Edit Mode or the Test button to confirm it's working
- Click "🧪 Test All Features" — gift notification text and stats should appear on screen
Three Overlay States
| State | Description | How to Enter |
|---|---|---|
| Not created | Overlay doesn't exist; no effects display on screen | Click "Create Window" |
| Active (always-on-top) | Transparent, click-through; all effects display; doesn't interfere with mouse | Normal operating state |
| Edit Mode | Overlay border visible; mouse can interact with overlay elements | Click "Edit Overlay Layout" |
Edit Mode (WYSIWYG Positioning)
Edit Mode lets you drag overlay elements to exact screen positions with your mouse — what you see is exactly what viewers will see.
Entering and Exiting Edit Mode
- Make sure the overlay window has been created
- In the Transparent Window Config panel, click "✏️ Edit Overlay Layout"
- A visible dashed border appears around the overlay area; your mouse can now interact with elements inside
- Drag elements to your desired positions
- Click "✅ Done Editing" — the overlay returns to click-through mode and positions are auto-saved
Draggable Elements
| Element | Description | Placement Tip |
|---|---|---|
| Gift Notification Text | "Thanks @username for [Gift]!" scrolling text | Bottom or top edge — away from your face on camera |
| Live Stats Panel | Gift count / diamonds / givers / timer | Corner position, e.g. bottom-right |
| Effect Playback Zone | Position set by X/Y in the gift config | Adjust via the gift effect's Position X/Y parameters |
While in edit mode, click "🧪 Test All Features" to trigger test content so all elements become visible on screen — makes positioning much easier since you can see everything at once.
Overlay Window Settings
Click "Transparent Window Config" to open the settings panel. It has multiple tabs:
Gift Notification Text Settings
Stats Panel Settings
Using with OBS / TikTok Live Studio
GiftShow's overlay displays effects directly on your desktop screen. If you need effects to also appear in your streaming software's output, add a window capture source in OBS or TikTok Live Studio.
OBS Studio Setup
- In your OBS Scene, click "+" in the Sources panel and select "Window Capture"
- In the Window dropdown, find
[GiftShow.exe]: TikTok - Effects Window - Disable "Capture Cursor" (you don't want the mouse visible)
- Check any transparency/alpha-related options to keep the background transparent
- In the Scene, drag this source to the top of the layer stack so it overlays everything else
- Preview in OBS to verify effects are rendering correctly
TikTok Live Studio Setup
- Add a Window Capture source in your TikTok Live Studio scene
- Select the GiftShow overlay window (contains "Effects Window" in the name)
- Move it to the top of the layer order
If you capture your screen with a capture card and stream directly from a phone or external device, GiftShow's overlay will appear in the captured screen automatically — no extra configuration needed at all.
VIP Boss Board
The VIP Boss system automatically identifies and rewards your top gifters with personalized welcome messages and exclusive effects — a proven driver of repeat gifting behavior.
Opening the Config
Click "👑 VIP FX" in the left panel. The modal has two main tabs: "VIP Tier Config" and "Live Boss Board".
How Boss Ranking Works
GiftShow tracks every user's cumulative diamond total for the current session and ranks them in real time. Rankings reset when you restart GiftShow (per-session tracking).
Configuring VIP Tiers
The system comes with 5 preset tier templates — edit them, or click "+ Add VIP Tier" to create more.
| Preset Tier | Default Emoji | Default Message |
|---|---|---|
| Tier 1 | 👑 | Welcome Boss {username}! |
| Tier 2 | 🥈 | Welcome VIP {username}! |
| Tier 3 | 🥉 | Welcome {username}! |
| Tier 4 | 🎖️ | Welcome {username}! |
| Tier 5 | ⭐ | Welcome boss {username}! |
VIP Tier Parameters
{username} where the viewer's TikTok name should appear.Saving VIP Config
Click "💾 Save Config" after editing. Once saved, the system is active — whenever a user's cumulative diamonds cross a threshold, their next gift or entry triggers that tier's welcome.
Viewing the Live Boss Board
Switch to the "Live Boss Board" tab to see all gifting users ranked by cumulative session diamonds. Click "🔄 Refresh" to manually update.
Announce the VIP system to your audience at the start of stream: "Send X diamonds this session to become the live boss and get your own welcome effect!" Display the leaderboard on your overlay so viewers can see the rankings in real time — it drives competition.
Viewer Entry Count Trigger
Fire an effect when every Nth viewer enters your stream — great for milestone celebrations ("Welcome our 100th viewer tonight!").
Configuration
- Click "👋 Join FX" in the left panel
- Switch to the "Entry Count" tab
- Check "Enable Entry Count Trigger"
- Click "+ Add Trigger Rule"
- Set the trigger count (e.g. 100 = fires every 100th viewer)
- Select an effect file and configure display parameters
- Click "Save Rule"
Loop vs. Single Trigger
- Loop (recommended): Fires at every multiple of N. Set to 100: fires at viewer 100, 200, 300, etc.
- Single: Fires only once when exactly viewer N enters. Good for a special "100th viewer" celebration that doesn't repeat.
Resetting the Counter
Click "🔄 Reset Counter" at the bottom of the panel to reset the viewer count to zero. Useful at the start of each new stream session.
Add multiple trigger rules with different counts — e.g. fire one effect at 50 viewers, a bigger effect at 100, a massive effect at 500. Each rule operates independently.
Chat Keyword Trigger
Fire an effect when a chat message contains a specific keyword. Perfect for guided audience participation: "Type 'hype' in chat for a special effect!"
Configuration
- In the Join FX modal, switch to the "Chat Keyword" tab
- Check "Enable Keyword Trigger"
- Click "+ Add Keyword Rule"
- Type your trigger keyword, e.g.
hype,666,let's go - Select an effect file and display parameters
- Save the rule — it's immediately active
Cooldown Protection
Each keyword has a built-in cooldown of ~3–5 seconds after triggering. Subsequent chat messages containing the same keyword during the cooldown are ignored, preventing effect spam from a rapid chat flood.
Keyword matching is case-sensitive and full-width vs. half-width sensitive. hype won't match HYPE or Hype. Add multiple rules for common case variations if needed.
For mixed-language audiences, add multiple keyword rules for the same concept: hype, vamo, 666 can all map to the same effect. Each is a separate rule.
Live Stats Panel
Main Interface Stats Area
The right panel's "🎯 Statistics" area shows real-time session data:
| Field | Description |
|---|---|
| ⏱️ Stream Duration | Timer starting from when TikTok connected, shown as HH:MM:SS |
| Total Gifts | Cumulative count of all gifts received this session |
| Total Value | Sum of all gift diamond values |
| Gift Types | Number of distinct gift types received |
| Gift Users | Unique users who've sent gifts (deduplicated) |
Detailed Breakdowns
- Gift Breakdown: Per-gift count and diamond value, sorted by value descending
- User Breakdown: Per-user gift count — the source data for the Boss Board ranking
Overlay Stats Panel
In the Transparent Window Config, check "Show Stats on Overlay" to make the stats panel float on the live stream view. Use Edit Mode to position it wherever you want on screen.
Live Chat Display
The "💬 Live Chat" area in the right panel streams all incoming chat messages in real time:
The "📝 Live Log" area records all gift events, connection state changes, and configuration actions — invaluable for diagnosing why effects aren't triggering.
Session History
GiftShow automatically saves each session's data when you disconnect, so you can review performance after every stream.
- Click the "📁 History" tab in the main interface
- Select a date or session from the list
- Review the session's totals: diamond earnings, top gifters, most popular gifts, session duration
History is stored in a data/ folder next to the GiftShow EXE. If you move the EXE, the historical data stays behind. This is another reason to keep GiftShow in a fixed permanent folder like D:\GiftShow\.
Test Panel
The test panel validates that all overlay features work correctly without needing real gifts. The overlay window must exist first.
| Button | Simulates | What to Check |
|---|---|---|
| 🧪 Test Gift Text | Shows "Thanks @TestUser for Rose!" on the overlay | Text position, font, color, animation direction |
| 📊 Test Stats | Shows the stats panel with dummy data | Panel position, background, font size |
| ✨ Test Effects | Plays a test animation effect | Effect display size, position, edge fade |
| 💥 Test Combo | Rapidly fires multiple effects at once | Concurrent playback, no lag or crash |
| 🧪 Test All Features | All of the above simultaneously | Full visual preview of your setup |
Run "Test All Features" before every stream to confirm your overlay is working, elements are in the right positions, and there's no lag. It takes 10 seconds and catches most issues before they become live problems.
Media File Specifications
| Type | Supported Formats | Recommended Spec | Max Recommended Size |
|---|---|---|---|
| Video (solid background) | MP4 (H.264) | 720p or below, ≤30fps | 20MB |
| Video (transparent) | WebM (VP9 + Alpha) | 720p or below, ≤30fps | 30MB |
| Animated image | GIF | Under 600×600px, ≤30fps | 5MB |
| Static image | PNG, JPEG, WebP | PNG for transparency support | 5MB |
| Audio | MP3, WAV | 128kbps MP3 / 44.1kHz WAV | 5MB |
Best Format: WebM with Alpha Channel
For the best visual quality on the overlay, use WebM video with an alpha channel (transparent background). Transparent effects blend perfectly with any stream background without edge fade tricks.
Tools to create transparent WebM
- Adobe After Effects — Export via Media Encoder, choose WebM format, enable alpha channel export
- Adobe Premiere Pro — Media Encoder, WebM + VP9, select RGB+Alpha
- FFmpeg (command line) — Convert green-screen MP4 to transparent WebM using chroma key
- Asset sites — Motion Array, Envato Elements, and others have pre-made transparent overlay packs
File Path Rules
• Absolute paths are recommended: D:\effects\rose.mp4
• Avoid Chinese characters in file paths — can cause loading failures
• If you move a file, re-select it in GiftShow to update the path
• Store all effect files in a dedicated effects\ subfolder next to GiftShow EXE for easier management
Best Practices & Tips
Pre-Stream Checklist
- ☐ License verified (status bar green)
- ☐ TikTok live started, username connected
- ☐ Transparent overlay window created
- ☐ Ran "Test All Features" — everything looks correct
- ☐ Entry count reset for this session
- ☐ If using OBS: overlay window capture source added and on top
Engagement Tips
• Introduce the effects at stream start: "Send a Lion and watch what happens!"
• Reserve the most dramatic effects for the most expensive gifts
• Use the VIP boss leaderboard on your overlay to drive ranking competition
• Use keyword triggers to make the whole chat feel involved: "Everyone type HYPE for the effect!"
• After a big gift fires an effect, verbally react to it — the combination of visual + audio feedback is powerful
Performance Tips
- Keep effect files under 20MB — larger files cause a noticeable trigger delay
- For high-frequency small gifts (Rose, Heart), keep max concurrent ≤ 3 to avoid screen clutter
- Use MP4 over GIF — MP4 uses hardware decoding and is much lighter on CPU
- Close unnecessary background applications before going live
- Store effects on an SSD rather than HDD for faster file loading
FAQ
Q: Can I use one key on multiple PCs?
No. Each key is bound to one device. To transfer to a new machine, email support@giftshow.live with your original transaction ID.
Q: Gift was sent but no effect triggered — why?
Most likely a name mismatch. Open the log and find the line that says 🎁 @user sent [GiftName] — compare that exact name character-by-character with what you configured. Case and full-width vs. half-width spaces matter.
Q: The transparent overlay is invisible / I can't see anything
First, click "🧪 Test All Features" — if you see content appear on screen, the overlay is working. If not: (1) confirm the overlay was created (button now shows "Close Window"), (2) check if you have multiple monitors and the overlay spawned on the wrong one.
Q: Effects have a noticeable delay after the gift is sent
Two possible causes: (1) your effect file is too large — compress it below 20MB; (2) network latency — typically 1–2 seconds, inherent to the connection and not something GiftShow can eliminate.
Q: Can I configure multiple effects for the same gift?
Currently, one effect file per gift name. To get a "random" feel, edit multiple video clips together into a single longer video and let it play in full each time.
Q: Does GiftShow support Brazilian / LATAM TikTok?
Yes. Built-in animations include Portuguese and Spanish aliases: rosa, corazon, coracao, leao, leon, foguete, borboleta, estrela, galaxia, and more. Works out of the box for BR/LATAM streams.
Q: Is there a refund policy?
If GiftShow fails to work on your system and support can't resolve it within 72 hours, we offer a full refund. Contact support@giftshow.live with your transaction ID.
Troubleshooting
❌ License Key Verification Failed
| Symptom | Cause | Fix |
|---|---|---|
| "Invalid key format" | Incomplete paste or extra characters | Re-copy from email, paste fresh |
| "Already used on another device" | Key bound to a different machine | Contact support for device transfer |
| "Network connection failed" | Can't reach license server | Check internet, try disabling VPN |
| "Key expired" | Monthly or quarterly subscription ended | Renew subscription then re-verify |
❌ TikTok Connection Keeps Failing
1. Confirm the TikTok account is actively live (not test mode, must be a real live stream)
2. Confirm you're entering the username, not the display name/nickname
3. Disconnect, wait 10 seconds, reconnect
4. Verify your internet is stable (open TikTok.com in a browser)
5. If all else fails, screenshot the error from the log and send to support
❌ Effects Not Triggering
- Verify the overlay window exists (run "Test All Features" — does anything appear?)
- Check the log: did GiftShow actually receive the gift? Search for 🎁 in the log
- Compare the log's gift name against your configuration letter-by-letter
- Confirm the effect file path is still valid (file hasn't been moved or deleted)
- Check that Max Concurrent isn't set to 0
❌ Video/Image Not Showing but Audio Plays
Codec compatibility issue. Re-encode the video using HandBrake (H.264 MP4) or a format converter. Alternatively, try a different video file to confirm the issue is file-specific.
❌ Overlay Elements in Wrong Position After Monitor Change
When screen resolution changes, saved positions may become invalid. Enter Edit Mode and manually drag all elements back to correct positions, then save.
❌ App Crashes or Becomes Unresponsive
Please collect: Windows version, GiftShow version (shown at bottom-right), what you were doing when it crashed, any error popups. Log files are in the logs\ folder next to the EXE. Send these to support@giftshow.live.
For unresolved issues: email support@giftshow.live with your GiftShow version number, a screenshot of the log error, and a description of what you were doing. We respond within 24 hours.