• 📂 Channel Indexing: Automatically index video files from public and private Telegram channels.
• ⚡ FastAPI Powered: High-performance REST API for lightning-fast data retrieval and streaming.
• 🔐 Secure Authentication: Optional token-based authentication system to protect your API.
• 📺 Seamless Streaming: Direct stream and download support with HTTP Range (Partial Content) support.
• 🗄️ MongoDB Integration: Efficiently store and manage thousands of indexed files with ease.
• 🎬 TMDb Integration: Automatically fetches rich metadata (titles, posters, plot) via The Movie Database API.
• 🐳 Docker Ready: Deploy in seconds using Docker and Docker Compose.
• 🔄 Backup & Restore: Easily backup your entire database to JSON and restore it whenever needed.

1. Clone the repository:

   git clone https://github.com/Sam-Max/Jackgram.git
   cd Jackgram

2. Configure Environment:

   cp sample_config.env config.env
   # Open config.env and fill in your credentials

3. Deploy:

   docker-compose up -d

1. Install Requirements:

   pip install -r requirements.txt

2. Setup MongoDB: Ensure you have a MongoDB instance running and accessible.

3. Run the application:

   python3 -m jackgram

Fill your config.env with these essential variables. You can get Telegram API credentials from my.telegram.org.

The bot provides a set of admin commands to manage your index:

All API requests require the Authorization: Bearer <token> header if USE_TOKEN_SYSTEM is enabled.

• Series: GET /stream/series/{tmdb_id}:{season}:{episode}.json

  {
    "tmdb_id": "77163",
    "streams": [
      {
        "name": "Telegram",
        "title": "TV Show Title",
        "quality": "720p",
        "size": 263039472,
        "hash": "XXXXXX"
      }
    ]
  }

• Movie: GET /stream/movie/{tmdb_id}.json

  {
    "tmdb_id": "592831",
    "streams": [
      {
        "name": "Telegram",
        "title": "Movie Name",
        "quality": "1080p",
        "size": 1189639567,
        "hash": "XXXXXX"
      }
    ]
  }

• Download: GET /dl?hash={file_hash} (Supports Range headers for seeking)

• Search: GET /search?query={q}&page={n}
• Latest: GET /stream/latest?page={n}
• Raw Files: GET /stream/files?page={n}

• Status: GET /status (Check if server and bot are online)

If you like this project and want to support its development, consider buying me a coffee!

Join our Telegram for updates, support, and discussions:

Index and serve at your own risk. This tool is for educational purposes only and the author is not responsible for what you index.

Distributed under the GNU GPL v3 License.

Disclaimer: This bot should only be used to access movies and TV series not protected by copyright.