Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

https://github.com/thundersquared/tikvidbot

🎵🤖 TikTok Any Video Downloader Telegram Bot
https://github.com/thundersquared/tikvidbot

microservice microservices telegram telegram-bot tiktok tiktokbot

Last synced: 3 months ago
JSON representation

🎵🤖 TikTok Any Video Downloader Telegram Bot

Awesome Lists containing this project

README

        



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](https://hub.docker.com/r/thundersquared/tikvidbot) passing [config variables](./config.js) through environment:

```bash
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](./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](https://github.com/telegraf/telegraf) to consume Telegram's Bot API, loves [got](https://github.com/sindresorhus/got) for fetching video pages and streaming videos and [jsdom](https://github.com/jsdom/jsdom) for parsing and interacting with them.

## Credits

Project originally started by [thundersquared](https://github.com/thundersquared), improved by the [contributors](https://github.com/thundersquared/tikvidbot/graphs/contributors).

## License

The code in this repo and used modules are open-sourced software licensed under the [MIT license](LICENSE.md).