Frequently Asked Questions

Find answers to common questions about ltth.app

๐Ÿš€ Getting Started

๐Ÿ’ฐ Is PupCid's Little TikTool Helper free?

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.

๐Ÿ’ป Which operating systems are supported?

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.

๐Ÿ“ฆ How do I install the tool?

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.

๐Ÿ”‘ Do I need to enter login credentials?

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.

๐Ÿš€ What does "Beta Version" mean? Is the tool stable?

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!

๐Ÿ‘ฅ How can I contribute to the community?

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!

โš™๏ธ Technical

๐ŸŽฅ Does the tool work with OBS?

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

๐Ÿ”Œ Do I need Node.js?

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.

๐Ÿ”’ Is my data uploaded to the cloud?

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).

๐Ÿ”ง Troubleshooting

โŒ TikTok connection fails - what to do?

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

๐Ÿ”Š TTS not working - no sound?

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

๐Ÿš€ How do I update the tool?

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.

๐ŸŽจ Features & Plugins

๐Ÿ”Œ Can I create my own plugins?

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.

๐ŸŽฎ Does VRChat integration work?

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.

๐ŸŽฏ How does the Flow system work?

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"

๐Ÿ“œ Legal & Community

โš–๏ธ Does the tool violate TikTok's Terms of Service?

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.

๐Ÿ› How can I report bugs or suggest features?

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.

๐Ÿ’ป Can I contribute to the project?

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.

Still have questions?

If you can't find an answer here, check the Documentation or contact us via Support.

๐Ÿ“– Documentation ๐Ÿ’ฌ Support