chimpanzeesweetrolls/overseerrrequestviatelegrambot repository overview

⁠🤖 Overseerr Telegram Bot (v4.0.0)

The ultimate companion for your media requests.

The Overseerr Telegram Bot enables seamless interaction with your Overseerr instance. Search for movies and TV shows, check availability, request new titles, report issues, and manage notifications—all from your Telegram chat.

With Version 4.0.0, the bot has been completely rebuilt for speed (Async/HTTPX) and includes powerful new features like Plex Authentication and Smart Group Chat Integration.

⁠🚨 IMPORTANT UPDATE v4.0.0 (Breaking Changes)

If you are updating from an older version, please note:

1. New Script Name: The main entry point has been renamed from telegram_overseerr_bot_beta.py to main.py.
   • Docker Users: If you use the default command, just pull the new image.
   • NAS/Custom Users: If you defined a custom "Command" or "Entrypoint" in your NAS settings, change it to python main.py.
2. Performance: The bot is now asynchronous. Ensure you restart your container completely after updating.

⁠✨ Key Features

• 🔍 Search & Request: Find movies/shows and request them in 1080p or 4K.
• 🔐 Authentication: Log in via Email/Password or Plex Account (PIN Flow).
• 👥 Smart Group Mode: Securely authenticate in private chats and seamlessly interact within groups. No need to disable Telegram Privacy Mode anymore!
• 🛠️ Issue Reporting: Report audio/video issues directly to Overseerr.
• ⚙️ Admin Dashboard: Manage users, restart notifications, and settings via an interactive inline menu.

⁠📚 Documentation

• Setup Guide: Wiki⁠
• Source Code: GitHub Repository⁠

⁠🐳 Installation via Docker Compose (Recommended)

version: "3.9"
services:
  telegram-bot:
    image: chimpanzeesweetrolls/overseerrrequestviatelegrambot:latest
    container_name: overseerr-bot
    environment:
      OVERSEERR_API_URL: "http://your-overseerr-ip:5055/api/v1"
      OVERSEERR_API_KEY: "your_overseerr_api_key"
      TELEGRAM_TOKEN: "your_telegram_token"
      PASSWORD: "your_password" # Optional: Set a password for bot access
    volumes:
      - ./data:/app/data
    restart: unless-stopped

Start the container:

docker-compose up -d

⁠💻 Installation via CLI (Docker Run)

docker run -d \
    --name telegram-bot \
    -v $(pwd)/data:/app/data \
    -e OVERSEERR_API_URL="http://your-overseerr-ip:5055/api/v1" \
    -e OVERSEERR_API_KEY="your_overseerr_api_key" \
    -e TELEGRAM_TOKEN="your_telegram_token" \
    -e PASSWORD="your_password" \
    chimpanzeesweetrolls/overseerrrequestviatelegrambot:latest

⁠💾 NAS Setup (QNAP / Synology)

Note: If your NAS interface asks for a "Command" or "Entrypoint", ensure it is empty (default) or set to python main.py.