Find answers to common questions about ltth.app
Yes, completely free! The tool is 100% free and Open Source (MIT License). There are no hidden costs, premium tiers or feature restrictions. All features are freely available to everyone.
Windows, macOS and Linux are supported:
Windows: Windows 10/11 (64-bit) with setup.exe installer - easiest installation
macOS: macOS 10.15+ - manual installation via npm (Native Installer planned)
Linux: Ubuntu 20.04+, Debian 11+ - manual installation via npm
All platforms require Node.js 18.0.0 or higher. See Installation Guide for details.
Windows: Simply download setup.exe and run it. Node.js is automatically installed if needed.
Linux/macOS: Manual installation with npm install and npm start.
See Documentation for detailed instructions.
No, no login credentials required! You only need your TikTok username (without @). No passwords, no OAuth, no account connection. The tool only reads publicly available LIVE stream data.
Yes, the tool is production-ready and fully functional! "Beta" means we're actively developing new features and collecting feedback. All main features (TTS, Alerts, Soundboard, Plugins, OBS Integration) work reliably. Occasional bugs may occur - just report them on GitHub and we'll fix them quickly!
There are many ways:
โข GitHub Star and recommend the project
โข Report bugs and suggest features
โข Contribute code via Pull Requests
โข Develop your own plugins and share them
โข Help others in GitHub Discussions
Visit the Community page for more info!
Yes, full OBS integration!
โข Transparent Full-HD overlays (1920x1080) as browser source
โข OBS WebSocket v5 for scene control via Gifts/Chat
โข Separate browser source URLs for Goals
โข HUD configuration with Drag & Drop
See OBS Integration Features
Node.js is required, but is automatically installed with setup.exe if not present. Supported versions: Node.js 18.0.0 - 23.x. You don't need to worry about anything.
No, everything stays local! All data stays on your computer. No cloud connection, no data collection, no tracking. 100% local and private. Optional cloud sync for configs is planned (opt-in with full control).
Common solutions:
โ
You must already be LIVE on TikTok (not in Preview)
โ
Username must be correct (without @)
โ
Firewall/Antivirus might be blocking the connection
โ
Port 3000 must be available
โ
Try Auto-Reconnect (attempted automatically)
More help: Troubleshooting Guide
Checklist:
โ
TTS plugin enabled? (Dashboard โ Plugins)
โ
System volume not muted?
โ
Default audio device set correctly?
โ
TTS volume turned up in Dashboard?
โ
Try the test button in TTS Admin Panel
If nothing helps: Contact Support
The tool automatically checks for updates every 24 hours. When an update is available, you'll see a banner in the Dashboard.
Manual update: Simply download the new setup.exe and install over the old version. Your data will be preserved.
Yes, fully supported! The plugin system is completely documented. You can create plugins with:
โข Express routes for APIs
โข Socket.io events for real-time communication
โข TikTok event callbacks
โข Custom Admin UIs
See Plugin Documentation for examples and API reference.
Yes, via OSC-Bridge Plugin! Control your VRChat avatar with TikTok events:
โข Wave gesture on Gifts
โข Celebrate animation on large donations
โข Dance, Hearts, Confetti effects
โข Bidirectional communication
โข Latency < 50ms
See OSC-Bridge Plugin in Dashboard for setup.
Flows = Automation without code! Create "If-Then" rules:
โข Trigger: TikTok events (Gift, Follow, Chat, etc.)
โข Conditions: Gift value, username, text match (with Regex)
โข Actions: TTS, Alerts, Sounds, OBS scenes, Webhooks
Example: "When Rose Gift โ TTS 'Thanks for the Rose' + Switch OBS scene"
No. The tool only reads publicly available TikTok LIVE data without login. It's comparable to StreamElements, Streamlabs etc. for Twitch. No account manipulation, only reading public events. No TOS violation.
Open an issue on GitHub: GitHub Issues
Bug Report: Describe the problem, steps to reproduce, screenshots
Feature Request: Explain the use case and why it would be helpful
We appreciate your feedback! The tool is in Beta and your input helps enormously.
Yes, contributions are welcome!
โข Pull Requests on Main Repository
โข Plugin development and sharing
โข Improve wiki documentation
โข Bug reports and testing
โข Community support on Discord/GitHub
See Contribution Guidelines in the repository.
If you can't find an answer here, check the Documentation or contact us via Support.