Find answers to common questions about ltth.app
The Cloud Launcher is a small Windows application (~7 MB) that automatically downloads, installs and keeps LTTH up to date. It offers automatic updates, rollback to previous versions and integrated version management.
The launcher is a new application that hasn't been code-signed yet. This is normal for open-source projects. Click 'More info' → 'Run anyway'. The file is safe and the source code is available on GitHub.
The Cloud Launcher is currently only available for Windows. macOS and Linux launcher support is planned. LTTH itself runs on all platforms, but automatic installation via the launcher is currently Windows-only.
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.
Launcher: Windows 10/11 only
LTTH itself: Windows, macOS and Linux
Windows: Windows 10/11 (64-bit) with Cloud Launcher - 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: Download and run the Cloud Launcher from /downloads/launcher.exe. It automatically downloads, installs and keeps LTTH up to date.
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
The launcher brings all required components with it. 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 launcher automatically checks for updates on every start. When an update is available, you'll see a banner in the Dashboard.
Manual update: Simply download the new launcher 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.
AnimazingPal is an AI-powered plugin that gives VTuber avatars memory and personality. It remembers viewers, generates contextual responses via GPT (4o-mini or 5 Nano), and batches events for natural speech flow. It includes 5 pre-defined streamer personalities and a custom personality creator.
Yes, an OpenAI API key is required for the AnimazingPal Brain Engine and Response Engine. GPT-4o-mini and GPT-5 Nano are supported. The key is stored securely and persistently in the user_data/ folder and survives updates.
No. All user data, settings, plugin configurations, and API keys are stored in the user_data/ and user_configs/ folders and survive updates. A backup is automatically created before each update.
If you can't find an answer here, check the Documentation or contact us via Support.