Ecosyste.ms: Awesome

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

Awesome Lists | Featured Topics | Projects

https://github.com/kyng-cytro/Screen-Time-Bot

Telegram bot to get Movies and TV-Shows updates
https://github.com/kyng-cytro/Screen-Time-Bot

bot mongodb python3 telegram telegram-bot web-scraper web-scraping

Last synced: 3 months ago
JSON representation

Telegram bot to get Movies and TV-Shows updates

Awesome Lists containing this project

README

        

# 🎬 Screen-Time πŸ“Ί

Screen-Time is a Telegram bot built with Python that provides movie and TV show updates. With Screen-Time, you can easily find information about the latest movies and TV shows, watch trailers 🍿, and get notified πŸ“© about upcoming releases.

## πŸš€ Features

- Search πŸ”Ž for movies πŸŽ₯ and TV shows πŸ“Ί
- Get information ℹ️ about movies and TV shows, including release date πŸ“…, cast 🎭, and ratings 🌟
- Watch trailers 🍿
- Get notified πŸ“© about upcoming releases

## πŸ“£ Try it out

Screen-Time bot has been deactivated pending rewrite using serverless functions.

## πŸ“Έ Screenshots

![Movie Updates](https://imgur.com/ihpE15N.png "Movie Updates")

![TV-Shows Update](https://imgur.com/RKpwQ4y.png "TV-Shows Updates")

![Custom TV-Shows List](https://imgur.com/AtgARoq.png "Custom TV-Shows List")

![Search](https://imgur.com/J0ySlOI.png "Search")

## πŸ› οΈ Getting Started

To get started developing Screen-Time, you will need to have Python 3.x installed on your machine.

1. Clone the repository:

```bash
git clone https://github.com/yourusername/Screen-Time.git
```

2. Install the dependencies:

```bash
pip install -r requirements.txt
```

3. Create a Telegram bot and get the API token from the BotFather.

4. Add the API token to the .env file.

5. Start the bot:

```bash
python bot.py
```

6. Open Telegram and search for your bot to start using it.

## πŸ› οΈ Built With

- [Python](https://www.python.org/) - The programming language used for building the project
- [Telegram Bot API](https://core.telegram.org/bots/api) - The API used for building the bot
- [Next Episode](https://next-episode.net/) - The API used for retrieving movie and TV show information

## πŸ‘₯ Contribution

Please feel free to contribute by submitting pull requests or by reporting any issues you encounter.

## πŸ“ License

Screen-Time is open-sourced software licensed under the [MIT license](https://opensource.org/licenses/MIT).

## πŸ™ Acknowledgments

Screen-Time is inspired by other movie and TV show websites and services, and aims to provide a similar experience within the Telegram app. πŸ€–πŸΏπŸ“Ί