A Telegram bot for download and subscribe to tv show subtitles.
Subtitles Alert Bot is a Telegram Bot that let you download and subscribe to subtitles of your favourite tv shows. You can download subtitles for a specific episode or a set of subtitles, and manage your subscriptions. A subscription is referred to a specific tv show for one or more languages: once you have subscribed you will get your subtitles on your phone (also a direct link for others subtitles for all episode versions) without doing anything.
More about Telegram Bots: https://core.telegram.org/bots
With Subtitles Alert Bot you can:
Other minor functionalities such as:
Node.js our bot uses several open-source libraries listed here. Our source of subtitles is www.addic7ed.com and http://www.tvmaze.com/api is the endpoint for retrieve updated informations about tv shows.
If you want to run a version of this bot a nice and suggested cheap server is a RaspberryPi. We use it and it works like charm. Feel free to ask us for help on setting up.
How can I contribute?
In the Issue section of this repository we constantly add bugs to fix or new features to develop. You can fork this repository and start develop as a contributor.
- To run a local version of Subtitles Alert Bot you have first to obtain a token from Telegram
- Set the
js/main.jsto the new token
- We used
MongoDBas database. You first have to install it and run it
- Configure your MongoDB local connection in
dbNameset your database name -
- Run the bot instance:
sudo node main.js
- You're free to use any Telegram client you like and search for your bot instance name. Start the conversation sending
/startto the bot chat.
We used MongoDB. In
js/db/mongo.js you can find our model. For full compatibility with existing code, please use the same data model.
Issue tracker and new features to develop
Public roadmap for Subtitles Alert Bot can be found here. It's always up-to-date with last release.
Feel free to donate
Our project is totally free and open-source. If you want to donate we will be very grateful and it will contribute to our project to mantain an always running version of Subtitles Alert Bot (you can find the official and first version of the bot as @SubtitlesAlertBot on Telegram)
About the authors
Logo is courtesy of Mariusz Nawrocki
This project is released under MIT license as you can check in LICENSE.md file.