A powerful Stremio addon that enhances your streaming experience with TMDB metadata

• Multi-language Support: Get metadata in your preferred language
• Extended Catalog: Access titles not available in Stremio's default catalog
• Rich Metadata: High-quality posters, backgrounds, and detailed information
• TMDB Integration: Connect with your TMDB account for personalized experience
• Integrations: Watchlist Sync, Rating Support, Custom Lists
• Modern UI: Beautiful and intuitive configuration interface
• IMDb Support: Full compatibility with IMDb-based addons
• Proxy Support: Optional proxy configuration to bypass regional blocks (e.g., India)

This addon now supports optional proxy configuration to bypass regional blocks where TMDB is blocked (such as in India). The proxy is only used for TMDB API calls, keeping all other requests direct.

# Enable proxy
TMDB_PROXY_ENABLED=true
TMDB_PROXY_HOST=127.0.0.1
TMDB_PROXY_PORT=40000
TMDB_PROXY_PROTOCOL=socks5

1. Visit the TMDB Addon Configuration Page
2. Configure your preferences
3. Click "Install"
4. Approve the installation in Stremio

Choose from any language supported by TMDB for your metadata.

Customize which catalogs appear on your Stremio:

• Movies
  • Popular
  • Year
  • Language
  • Trending
• TV Shows
  • Popular
  • Year
  • Language
  • Trending

• TMDB Account Connection
• Watchlist Sync
• Rating Posters Support
• Custom Lists

For detailed instructions on hosting your own instance, check our Self-Hosting Guide.

docker run -d \
  --name tmdb-addon \
  -p 1337:1337 \
  -e MONGODB_URI=your_mongodb_uri \
  -e FANART_API=your_fanart_key \
  -e TMDB_API=your_tmdb_key \
  -e HOST_NAME=http://your_domain:1337 \
  mrcanelas/tmdb-addon:latest

docker run -d \
  --name tmdb-addon \
  -p 1337:1337 \
  -e TMDB_API=your_tmdb_key \
  -e TMDB_PROXY_ENABLED=true \
  -e TMDB_PROXY_HOST=127.0.0.1 \
  -e TMDB_PROXY_PORT=40000 \
  -e TMDB_PROXY_PROTOCOL=socks5 \
  mrcanelas/tmdb-addon:latest

For complete proxy setup with Cloudflare WARP, see docker-compose.proxy.yml.

• Self-Hosting Guide - Complete instructions for hosting your own instance
• Development Guide - Guide for developers and contributors
• Contributing Guide - How to contribute to the project
• API Documentation - Complete API reference
• Proxy Implementation - Guide for proxy configuration

We welcome contributions! Please read our Contributing Guide to get started.

# Clone the repository
git clone https://github.com/mrcanelas/tmdb-addon.git

# Install dependencies
npm install

# Start development servers
npm run dev:server  # Backend
npm run dev         # Frontend

This project is licensed under the MIT License - see the LICENSE file for details.

• TMDB for providing the metadata
• Fanart.tv for additional artwork
• Stremio for the amazing streaming platform
• All our contributors

The metadata is provided by TMDB and is subject to change. We cannot guarantee data validity and are not responsible for any inconveniences caused by invalid or inappropriate metadata.

Made with ❤️ by the Stremio community