Sign inSign up

pegtsaymyname/movie-telegram-bot

By pegtsaymyname

•Updated 4 months ago

Telegram bot to search movies and TV series by title, rating, genre, and budget.

Image
0

781

pegtsaymyname/movie-telegram-bot repository overview

⁠Python Movie & TV Series Search Bot

A lightweight Python-based Docker container for a bot that helps users discover movies and TV shows using advanced filtering.

⁠🚀 Features

  • Search by Title: Instantly find specific movies or TV series.
  • Filter by Rating: Discover top-rated content or hidden gems.
  • Genre Selection: Browse by action, comedy, drama, sci-fi, and more.
  • Budget Filter: Search for blockbusters or low-budget indie films.
  • Search History: Automatically saves user search history, which can be viewed directly inside Telegram.
  • Favorites List: Users can add movies to their personal favorites and manage their custom watchlists.

⁠⚙️ Environment Variables

Before running the container, ensure you have the necessary tokens. Configure the bot by passing these environment variables:

VariableDescriptionRequired
BOT_TOKENYour Telegram bot API token (from BotFather)Yes
KINOPOISK_API_KEYAPI key from KinoPoisk.dev⁠Yes

⁠📦 Deployment via Docker Compose

Alternatively, you can deploy using docker-compose.yml:

  • Create a project folder and navigate into it.
  • Create a .env file inside this folder to store your secret tokens.
  • Add the following content to the .env file (replace with your real data):
BOT_TOKEN=your_bot_token_here
MOVIE_API_KEY=your_api_key_here
  • Create a docker-compose.yml file in the same folder and paste the following configuration:
services:
  bot:
    image: pegtsaymyname/movie-telegram-bot:latest
    container_name: movie-search-bot
    restart: always
    env_file:
      - .env
  • Start the bot in the backgrounds:
docker compose up -d

Tag summary

Content type

Image

Digest

sha256:17b86a7f2…

Size

51.4 MB

Last updated

4 months ago

docker pull pegtsaymyname/movie-telegram-bot