wandish/tmdb-telegram-bot repository overview

⁠🎬 TMDb Telegram Bot

A lightweight Telegram bot that lets you search for movies and TV shows using the TMDb API⁠. It replies with detailed, interactive information like synopsis, genres, runtime, trailers, ratings, and recommendations — all in Spanish 🇪🇸.

Built with Python and python-telegram-bot, and easily deployable via Docker.

⁠🚀 Features

• 🔐 Access control: restrict usage to specific Telegram usernames
• 🔎 Multi-type search: movies and TV shows
• 📌 Interactive UI: Inline keyboard with results and recommendations
• 🎥 YouTube trailer integration
• 🎞 Rich metadata: seasons, episodes, runtime, genres, country of origin, etc.
• 🖼️ Poster image display
• 🧩 Easy environment configuration via .env

⁠🐳 Docker usage

⁠docker-compose.yml

version: "3.8"

services:
  tmdb-bot:
    image: wandish/tmdb-telegram-bot:latest
    container_name: tmdb-telegram-bot
    restart: unless-stopped
    env_file:
      - ./tmdb-telegram-bot_data/.env

⁠.env example

TELEGRAM_TOKEN=your_telegram_token
TMDB_API_KEY=your_tmdb_api_key
ALLOWED_USERS=username1,username2