mirror of https://github.com/Viren070/tmdb-addon.git synced 2025-12-01 23:18:11 +01:00

Files

T

mrcanelas f1c1071d09 feat: add proxy support to bypass TMDB regional blocks (India)

- Add HTTP client with proxy support for TMDB API calls
- Create TMDBClient wrapper extending moviedb-promise with proxy integration
- Update all TMDB API modules to use new proxy-enabled client
- Add proxy configuration via environment variables:
  * TMDB_PROXY_ENABLED - Enable/disable proxy
  * TMDB_PROXY_HOST - Proxy host address
  * TMDB_PROXY_PORT - Proxy port
  * TMDB_PROXY_PROTOCOL - Proxy protocol (http, https, socks4, socks5)
  * TMDB_PROXY_AUTH - Enable proxy authentication
  * TMDB_PROXY_USERNAME - Proxy username
  * TMDB_PROXY_PASSWORD - Proxy password

- Add proxy status endpoint (/api/proxy/status) for monitoring
- Create test script (npm run test:proxy) for proxy verification
- Add comprehensive documentation:
  * PROXY_SETUP.md - User guide for proxy configuration
  * docs/proxy-implementation.md - Technical implementation details (English)
  * env.example - Environment variables template (English)
  * docker-compose.proxy.yml - Docker setup with Cloudflare WARP

- Update README.md with proxy support section
- Add logging when proxy is used for TMDB requests
- Support selective proxy usage (only TMDB domains use proxy)
- Maintain backward compatibility with existing configurations
- Translate all Portuguese text to English for international consistency

This resolves the issue where TMDB is blocked at network level in India,
allowing users to host the addon on Indian VPS providers while accessing
TMDB through a proxy. Based on similar implementation in AIOStreams.

Closes: Optional proxy for TMDB API calls (workaround for Indian VPS block) #1208

2025-08-13 15:38:30 -03:00

4.1 KiB

Raw Permalink Blame History

TMDB Addon for Stremio

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

🌟 Features

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)

🌐 Proxy Support

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.

Quick Proxy Setup

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

📥 Installation

Quick Install

Visit the TMDB Addon Configuration Page
Configure your preferences
Click "Install"
Approve the installation in Stremio

⚙️ Configuration

Language Settings

Choose from any language supported by TMDB for your metadata.

Catalog Options

Customize which catalogs appear on your Stremio:

Movies
- Popular
- Year
- Language
- Trending
TV Shows
- Popular
- Year
- Language
- Trending

Integration Features

TMDB Account Connection
Watchlist Sync
Rating Posters Support
Custom Lists

🛠️ Self-Hosting

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

Quick Start with Docker

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 with Proxy Support

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.

📚 Documentation

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

🤝 Contributing

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

Development Setup

# 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

⚖️ License

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

🙏 Acknowledgments

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

⚠️ Disclaimer

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

4.1 KiB Raw Permalink Blame History