https://github.com/matt0550/eurostreaming-telegrambot

An unofficial Telegram BOT and Mini App for Eurostreaming website.
https://github.com/matt0550/eurostreaming-telegrambot

mini-app python scraping telegram telegram-bot

Last synced: 6 months ago
JSON representation

An unofficial Telegram BOT and Mini App for Eurostreaming website.

Host: GitHub
URL: https://github.com/matt0550/eurostreaming-telegrambot
Owner: Matt0550
License: gpl-3.0
Created: 2024-08-25T18:34:32.000Z (about 1 year ago)
Default Branch: main
Last Pushed: 2025-01-20T22:36:52.000Z (9 months ago)
Last Synced: 2025-02-12T06:01:59.705Z (8 months ago)
Topics: mini-app, python, scraping, telegram, telegram-bot
Language: Python
Homepage:
Size: 1.81 MB
Stars: 0
Watchers: 1
Forks: 1
Open Issues: 1
Metadata Files:
- Readme: README.md
- License: LICENSE

Awesome Lists containing this project

README

          [![Forks][forks-shield]][forks-url]

[![Stargazers][stars-shield]][stars-url]

[![Issues][issues-shield]][issues-url]

[![MIT License][license-shield]][license-url]

[![Discord][discord-shield]][discord-url]

[![Docker Pulls][docker-shield]][docker-url]






  

    

  

  
Eurostreaming Unofficial Telegram BOT & Mini App


  


    An unofficial Telegram BOT and Mini App for Eurostreaming website.

    


    


    Report Bug

    ·

    Request Feature

  



All the data is scraped from the Eurostreaming website using my [**own API**](https://github.com/Matt0550/EurostreamingAPI-scraping) and is not affiliated with Eurostreaming in any way. This project is for educational purposes only. I do not condone piracy in any way. Please use this project responsibly.

Copyright and all rights belong to the respective owners.

## Bot Features (only with WebApp)

- View the latest TV shows

- Search for TV shows

- Get the details of a TV show

- Get the streaming links of a TV show episode

## Mini App Demo

https://github.com/user-attachments/assets/38c202f8-6bcc-4983-8847-cf5aaf0d9d2a

## TO-DO

- [ ] Notifications for new episodes

- [ ] Categories

- [x] Docker support

## Public instance of the Bot

**Currently, I’m unable to provide a public instance of the bot because web scraping is not permitted by the Eurostreaming website and is considered unethical. To avoid any potential issues or conflicts, I’ve decided not to make the bot publicly accessible. I apologize for any inconvenience this may cause and appreciate your understanding.**

## Environment Variables

| Variable | Description | Default |

| :--- | :--- | :--- |

| `token` | The Telegram Bot token | `None` |

| `owner_id` | The Telegram ID of the owner | `None` |

| `enable_webapp_server` | Enable the webapp server | `False` |

| `webserver_debug` | Enable the debug mode for the webapp server | `False` |

| `webapp_host` | The host of the mini app server | `0.0.0.0 or localhost (win)` |

| `webapp_port` | The port of the mini app server | `5000` |

| `report_errors_owner` | Report errors to the owner | `False` |

| `secret_key` | The secret key for the webapp server | `abc123` |

| `scraping_api_url` | The URL of the scraping API | `http://localhost:8000` |

| `PUID` | Docker PUID | `1000` |

| `PGID` | Docker PGID | `1000` |

## Installation - Using Docker Compose (recommended)

```yaml

version: '3'

services:

  eurostreaming_telegrambot:

    image: matt0550/eurostreaming_telegrambot

    environment:

      - token=TG_TOKEN

      - owner_id=TG_OWNER_ID

      - enable_webapp_server=True # For the telegram webapp.

      - webserver_debug=False

      - report_errors_owner=True # Report errors to the owner.

      - secret_key=abc123    # Random string

      - scraping_api_url=http://localhost:8000 # INFO: https://github.com/Matt0550/EurostreamingAPI-scraping

      - PUID=1000     # UID of the user inside the container

      - PGID=1000     # GID of the user inside the container

    ports:

      - 7015:5000

    restart: unless-stopped

```

Run the container with `docker-compose up -d`

## Installation - Using Docker Run

```bash

docker run -d \

  --name=eurostreaming_telegrambot \

  -e token=TG_TOKEN \

  -e owner_id=TG_OWNER_ID \

  -e enable_webapp_server=True \

  -e webserver_debug=False \

  -e report_errors_owner=True \

  -e secret_key=abc123

  -e PUID=1000 \

  -e PGID=1000 \

  -p 7015:5000 \

  --restart unless-stopped \

  matt0550/eurostreaming_telegrambot

```

## Installation - Self-Host or docker build

Clone the project

```bash

  git clone https://github.com/Matt0550/Eurostreaming-telegramBot

```

Go to the project directory

```bash

  cd Eurostreaming-telegramBot-master

```

OPTIONAL: use docker to build the image

If you don't want to use docker, you can just go ahead and skip this step.

Otherwise, change the `image` in `docker-compose.yml` with the image name you used.

Run the container with `docker-compose up -d`

```bash

  docker build -t Eurostreaming-telegramBot .

```

Install dependencies

```bash

  pip install -r requirements.txt

```

Start the REST API (after setting the **environment variables**)

```bash

  cd src

  python main.py

```

## Help - Feedback

You can contact me on:

Discord: https://matt05.it/discord

Telegram: https://matt05.it/telegram

Mail: mail@matteosillitti.com

## License

[GNU GPLv3](https://choosealicense.com/licenses/gpl-3.0/)

## Support me

[![ko-fi](https://ko-fi.com/img/githubbutton_sm.svg)](https://ko-fi.com/matt05)

[![buy-me-a-coffee](https://www.buymeacoffee.com/assets/img/custom_images/orange_img.png)](https://www.buymeacoffee.com/Matt0550)

[![paypal](https://www.paypalobjects.com/en_US/i/btn/btn_donateCC_LG.gif)](https://paypal.me/sillittimatteo)

[contributors-shield]: https://img.shields.io/github/contributors/Matt0550/Eurostreaming-telegramBot.svg?style=for-the-badge

[contributors-url]: https://github.com/Matt0550/Eurostreaming-telegramBot/graphs/contributors

[forks-shield]: https://img.shields.io/github/forks/Matt0550/Eurostreaming-telegramBot.svg?style=for-the-badge

[forks-url]: https://github.com/Matt0550/Eurostreaming-telegramBot/network/members

[stars-shield]: https://img.shields.io/github/stars/Matt0550/Eurostreaming-telegramBot.svg?style=for-the-badge

[stars-url]: https://github.com/Matt0550/Eurostreaming-telegramBot/stargazers

[issues-shield]: https://img.shields.io/github/issues/Matt0550/Eurostreaming-telegramBot.svg?style=for-the-badge

[issues-url]: https://github.com/Matt0550/Eurostreaming-telegramBot/issues

[license-shield]: https://img.shields.io/github/license/Matt0550/Eurostreaming-telegramBot.svg?style=for-the-badge

[license-url]: https://github.com/Matt0550/Eurostreaming-telegramBot/blob/master/LICENSE

[discord-shield]: https://img.shields.io/discord/828990499507404820?style=for-the-badge

[discord-url]: https://matt05.it/discord

[docker-shield]: https://img.shields.io/docker/pulls/matt0550/eurostreaming_telegrambot?style=for-the-badge

[docker-url]: https://hub.docker.com/r/matt0550/eurostreaming_telegrambot

ecosyste.ms

Data

Tools

Indexes

Applications

Experiments

Awesome

https://github.com/matt0550/eurostreaming-telegrambot

Awesome Lists containing this project

README

Eurostreaming Unofficial Telegram BOT & Mini App