TMDB Player

TMDB Player is a browser extension designed to enhance your movie and TV show experience on the TMDB website. This extension adds a custom play button to TMDB pages, allowing you to stream movies and TV shows for free from various video streaming servers.

Note: Extension in Chrome Web Store is currently disabled. For Chrome and other Chromium (Brave, Opera, etc) browsers please follow these steps.

---

Features

• Custom Play Button: Automatically adds a custom play button next to the existing TMDB "Play Trailer" button when viewing a movie or TV show page.
• Free Streaming: Opens a new tab with a webpage to stream the selected movie or TV show.
• Multiple Streaming Servers: Choose from different video streaming servers to ensure the best possible streaming experience.
• Minimal Ads: While the TMDB site and certain servers on the player webpage are ad-free, others may display minimal ads. For an uninterrupted experience, using an ad blocker is recommended.

---

Installation

Install from available Stores

Note: Other Chromium-based browsers like Opera, Brave, etc., can also install the extension from the Chrome Web Store. But since the extension is currently disabled in this store, for Chrome and other Chromium (Brave, Opera, etc) browsers please follow these steps.

For iPhone (iOS) and iPad (iPadOS)

1. Install the Orion Browser from the App Store:
   
   Orion Browser allows you to install add-ons from both the Chrome and Firefox stores.
2. Open the Orion Browser and navigate to the Firefox Add-ons Store.
3. Search for TMDB Player and install the extension.
4. (Optional/Recommendation) You can also install uBlock Origin or other adblock of your liking from these stores.

Note: Extensions in the Orion Browser do not update automatically when a new release is available. To ensure you have the latest version of the TMDB Player extension, revisit the TMDB Player Add-ons page and reinstall the extension.

For Android

1. Install Firefox Browser from the Google Play Store:
   
2. Open the Firefox Browser and navigate to the Firefox Add-ons Store.
3. Search for TMDB Player and install the extension.
4. (Optional/Recommendation) You can also install uBlock Origin or other adblock of your choice from the Firefox Add-ons Store.
5. (Optional) For a more app-like experience, you can add the TMDB homepage to your device's home screen.

Manual Installation

For Chromium-based Browsers (Chrome, Edge, Brave, Opera, etc.)

1. Download the tmdb_player-chromium-x.x.x.crx file from the Releases page. You might see a warning saying, "We can't add apps, extensions, or user scripts from this website." However, the .crx file will still be downloaded.
2. Open your browser and navigate to the extensions page:
   • Chrome: Type chrome://extensions/ in the address bar.
   • Edge: edge://extensions/ in the address bar.
3. Enable Developer mode.
4. Drag and drop the downloaded tmdb_player-chromium-x.x.x.crx onto the extensions page.
5. The TMDB Player extension will be added to your browser. Once installed, you can disable Developer mode if you desire.

Note: When using this method, the extension will not update automatically when a new version is released. To ensure you have the latest version of the TMDB Player extension, repeat the steps above whenever a new release is available.

For Firefox

1. Download the tmdb_player-firefox-x.x.x-signed.xpi file from the Releases page.
2. Open Firefox and navigate to about:addons.
3. Click on the gear icon and select Install Add-on From File.
4. Choose the downloaded .xpi file to install the extension.

---

How to Use

1. Visit any movie or TV show page on TMDB.
2. A custom "Play" button will appear next to the "Play Trailer" button.
3. Click the "Play" button.
4. A new tab will open with a webpage where you can stream the selected movie or TV show.
5. Choose a streaming server:
   • Server Recommendations: The webpage provides specific recommendations for servers based on factors like recently released movies, 4K availability, or general best quality.
   • You may also explore other servers to find the one that best suits your needs, particularly for specific subtitle options, audio language or better streaming quality.
   • If a server is unavailable or not functioning properly, try switching to another server until you find a suitable option.

---

Tips and Tricks

Here are some handy tips and tricks to enhance your experience with the extension:

1. Quick Access to TMDB Website

• The extension popup includes a button to quickly open the TMDB website for easy navigation.

2. Control How Streaming Pages Open

• By default, the streaming webpage opens in a new tab. If you prefer it to open in the same tab as the TMDB page, simply switch off the "Open movie/tv show in new tab" toggle button in the extension popup.

3. Choose Your Default Streaming Server

• Customize your experience by selecting your preferred default server in the extension popup. This ensures your streaming webpage always opens with your chosen server.

4. Quick Navigation Back to TMDB

• Clicking on the movie/tv show title on the streaming webpage will redirect you to the corresponding TMDB page, making it easier to switch between these two.

5. Android: App-Like Experience

• For a more seamless, app-like experience on Android, add the TMDB homepage to your device’s home screen. This allows quick access without opening a browser.

6. Edge: Install TMDB as an App

• On Microsoft Edge, you can install TMDB as a standalone app for a more immersive experience. Here’s how:
  1. Go to the TMDB website.
  2. Click on the three dots (settings) in the top-right corner.
  3. Select Apps and then click Install The Movie Database.
• Important: Don’t forget to switch off the "Open movie/tv show in new tab" toggle button in the extension popup to ensure the streaming page opens in the app.

---

Recommendations

• Ad Blocker: While some servers are ad-free and others feature minimal ads, it is highly recommended to use an ad blocker for a smoother and uninterrupted streaming experience. For the best results, consider using uBlock Origin.
• Feedback and Support: If you encounter any issues or have suggestions for improvement, please don't hesitate to reach out.

---

License

This project is licensed under the MIT License. Feel free to use, modify, and distribute it.

---

Contact

If you have any questions, encounter issues, or have suggestions for improvements, please don't hesitate to reach out! You can contact the repository maintainer by opening an issue in the Issues tab. Your feedback is highly appreciated!

---

Screenshots

Example: Custom Play Button

Example: Streaming Page

Popup: