README.md

tikvidbot

A Telegram bot to fetch TikTok videos locally

A bot for what?

tikvidbot is a bot allows you to save TikTok videos locally. To get a video, just share it's URL to the chat and it'll send the file.

Usage

You can use the latest docker hub image passing config variables through environment:

docker run --rm \
-e BOT_NAME="tikvidbot" \
-e BOT_TOKEN="your:token" \
-e HTTP_AGENT="Mozilla/5.0 (Macintosh; Intel Mac OS X 10_14_5) AppleWebKit/605.1.15 (KHTML, like Gecko)" \
thundersquared/tikvidbot

Start it without Docker:

install node and yarn with this manual:

INSTALL.md

Just run "yarn" once and then you can start the bot with "yarn dev"

Tech stack

The bot is written in Node.JS, relies on telegraf to consume Telegram's Bot API, loves got for fetching video pages and streaming videos and jsdom for parsing and interacting with them.

Credits

Project originally started by thundersquared, improved by the contributors.

License

The code in this repo and used modules are open-sourced software licensed under the MIT license.