irlkitcom/tiktokwidgets

TikTok LIVE Follow Widget for OBS Streams

TikTokWidgets

A Node.js project to deliver Gift, Subscriber, and Follow notifications to OBS clients via browser source.

A Node.js project to receive and decode livestream events such as subscribes and follows and display them as stream widgets in real-time from TikTok's LIVE service by connecting to TikTok's internal WebCast push service.

This project is a Javascript tool based off of TikTok-Live-Connector by @zerodytrash meant to serve as a free, open source tool for streamers on the platform.

This is not an official product. It is a research project & tinkering tool for streamers.

Join the community support server and visit the #support channel for questions, contributions and ideas. Feel free to make pull requests with missing/new features, fixes, etc.

Getting Started

To run the chat reader locally, feel free to watch the tutorial expertly created by TikTok LIVE with Harry that will take you through the following steps:

1. Download a code editor like VSCode (not missing this step anymore smh)
2. Install Node.js on your system
3. Clone this repository or download and extract this ZIP file
4. Open a console/terminal in the root directory of the project
5. Enter npm i to install all required dependencies
6. Enter node server.js to start the application server

Now you should see the following message: Server running! Please visit http://localhost:8081
Add http://localhost:8082 as a bowser source in OBS.

IMPORTANT: Notice About Sounds

Sounds will not work unless you click/interact with the page first after loading it due to a browser security feature preventing malicious popups & sounds.

Contributors

• Isaac Kogan - Initial work & primary maintainer - isaackogan
• Zerody - Reverse-Engineering & README.md file - Zerody

See also the full list of contributors who have participated in this project.

License

This project is licensed under the MIT License - see the LICENSE file for details.