A powerful Stremio addon that enhances your streaming experience with TMDB metadata
- Multi-language Support: Get metadata in your preferred language (200+ languages supported)
- 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
- 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)
- AI-Powered Search: Enhanced search with AI (Gemini and Groq)
- Multiple Integrations: Support for Trakt, MDBList, RPDB, and more
Sync your TMDB lists (favorites and watchlist) to discover new movies and TV shows.
Add ratings and scores to your movies and TV shows posters.
Set up your streaming services to see content availability. Based on rleroi/Stremio-Streaming-Catalogs-Addon.
Integrate your MDBList lists to expand your content library.
Improve your searches using Google Gemini's artificial intelligence.
Ultra-fast AI search using Groq (Llama 3).
Track what you watch and sync your progress with Trakt.tv.
This addon 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=socks5For more details, see the Proxy Documentation.
- Visit the TMDB Addon Configuration Page
- Configure your preferences
- Click "Install"
- Approve the installation in Stremio
- Open Stremio
- Go to Addons
- Scroll to the bottom and click +
- Paste the manifest URL:
https://94c8cb9f702d-tmdb-addon.baby-beamup.club/manifest.json - Click Add
Choose any language supported by TMDB for your metadata. 200+ languages available!
Customize which catalogs appear on your Stremio:
Movies:
- Popular
- By Year
- By Language
- Trending
- Search
- AI Search
TV Shows:
- Popular
- By Year
- By Language
- Trending
- Search
- AI Search
- TMDB Account Connection: Sync your TMDB favorites and watchlist
- Trakt Integration: Sync your Trakt watchlist and get personalized recommendations
- Watchlist Sync: Keep your watchlists synchronized across platforms
- Rating Posters Support: Display ratings on posters (RPDB integration)
- Custom Lists: Import custom lists from MDBList
- Streaming Catalogs: See which streaming services have the content available
- AI Search: Use AI to improve your searches (Gemini or Groq)
For detailed instructions on hosting your own instance, check our Self-Hosting Guide.
The easiest way to deploy this addon is using Vercel's one-click deploy. After clicking the button above:
- Import the repository to your Vercel account
- Configure environment variables (see below)
- Deploy - Vercel will automatically build and deploy your addon
Required Environment Variables for Vercel:
TMDB_API- Your TMDB API keyFANART_API- Your Fanart.tv API keyHOST_NAME- Your Vercel deployment URL (will be set automatically, but you can override it)
Optional Environment Variables:
TRAKT_CLIENT_ID- For Trakt integrationTRAKT_CLIENT_SECRET- For Trakt integrationREDIS_URL- For distributed caching (recommended for production)GEMINI_API_KEY- For AI searchGROQ_API_KEY- For AI searchMDBLIST_API_KEY- For MDBList integrationRPDB_API_KEY- For RPDB integration
Note: The
vercel.jsonfile is already configured. Vercel will automatically detect it and use the correct build settings.
docker run -d \
--name tmdb-addon \
-p 1337:1337 \
-e FANART_API=your_fanart_key \
-e TMDB_API=your_tmdb_key \
-e HOST_NAME=http://your_domain:1337 \
-e TRAKT_CLIENT_ID=your_trakt_client_id \
-e TRAKT_CLIENT_SECRET=your_trakt_client_secret \
mrcanelas/tmdb-addon:latestdocker 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:latestFor complete proxy setup with Cloudflare WARP, see docker-compose.proxy.yml.
| Variable | Description |
|---|---|
TMDB_API |
TMDB API key |
FANART_API |
Fanart.tv API key |
HOST_NAME |
Public URL of your addon (e.g., http://your_domain:1337) |
| Variable | Description | Default |
|---|---|---|
PORT |
Server port | 1337 |
TRAKT_CLIENT_ID |
Trakt OAuth Client ID | - |
TRAKT_CLIENT_SECRET |
Trakt OAuth Client Secret | - |
TMDB_PROXY_ENABLED |
Enable proxy for TMDB requests | false |
TMDB_PROXY_HOST |
Proxy host | 127.0.0.1 |
TMDB_PROXY_PORT |
Proxy port | 1080 |
TMDB_PROXY_PROTOCOL |
Proxy protocol (http, https, socks5) | http |
REDIS_URL |
Redis URL for distributed cache (optional) | - |
GEMINI_API_KEY |
Google Gemini API key (for AI search) | - |
GROQ_API_KEY |
Groq API key (for AI search) | - |
MDBLIST_API_KEY |
MDBList API key | - |
RPDB_API_KEY |
RPDB API key | - |
Note: Starting from v3.1.6, MongoDB is no longer required. The addon uses in-memory caching by default, with optional Redis support for distributed caching. See issue #1215 for more details.
- 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
cd tmdb-addon
# Install dependencies
npm install
# Start development servers
npm run dev:server # Backend (port 1337)
npm run dev # Frontend (port 5173)npm run dev # Start frontend development server
npm run dev:server # Start backend development server
npm run build # Build project for production
npm run lint # Run linter
npm start # Start production server
npm run test:proxy # Test proxy configuration- Backend: Node.js, Express
- Frontend: React, TypeScript, Vite, Tailwind CSS
- Cache: Redis (optional), cache-manager (in-memory by default)
- APIs: TMDB, Fanart.tv, Trakt, MDBList, RPDB, Gemini, Groq
- Containerization: Docker
tmdb-addon/
├── addon/ # Backend server code
│ ├── lib/ # Main modules (getMeta, getCatalog, etc.)
│ ├── utils/ # Utilities (httpClient, imageProcessor, etc.)
│ └── static/ # Static files (translations, catalog types)
├── configure/ # Frontend configuration UI
│ ├── src/
│ │ ├── components/ # React components
│ │ ├── pages/ # Application pages
│ │ ├── integrations/ # Integration components
│ │ └── contexts/ # React contexts
├── docs/ # Documentation
├── public/ # Public files (images, favicon)
└── package.json # Project configuration
This project is licensed under the Apache-2.0 License - see the LICENSE file for details.
- TMDB for providing the metadata
- Fanart.tv for additional artwork
- Stremio for the amazing streaming platform
- rleroi for the Streaming Catalogs addon
- 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.
- Issues: GitHub Issues
- Discussions: GitHub Discussions
Made with ❤️ by the Stremio community