A Telegram bot that allows users to search for movies or TV shows using the TMDb API and returns posters, backdrops, and details in an interactive format.
Developed by Saikat
- Search for movies and TV shows using TMDb API
- Display posters and backdrops with high-resolution options
- Multilingual metadata support
- Interactive button-based navigation
- Create an account on The Movie Database
- Go to your account settings
- Click on "API" in the left sidebar
- Follow the steps to request an API key for a "Developer" application
- Once approved, you'll receive an API key (v3 auth)
- Start a chat with @BotFather on Telegram
- Send the command
/newbotand follow the instructions - Once created, you'll receive a token for your bot
The config.py file contains important settings for the bot:
- API Keys: Loaded from environment variables
- TMDb URLs: Base URLs for the TMDb API and image server
- Image Sizes: Different resolution options for posters and backdrops
- Supported Languages: Currently supports English, Hindi, Tamil, Telugu, and Bengali
You can modify this file to add more languages or change image size preferences.
- Clone this repository
- Install dependencies:
pip install -r requirements.txt - Create a
.envfile with your API keys (see.env.example) - Run the bot:
python bot.py
Click the button below to deploy to Heroku:
For detailed deployment instructions, see DEPLOYMENT.md
/start- Welcome message and instructions/tmdb <movie or show name>- Search for movies or TV shows/trndb <movie or show name>- Alternative search command (works the same as/tmdb)
This project is maintained by Saikat. See the LICENSE file for details.