🌉 SeerrBridge is a browser automation tool that integrates Jellyseer/Overseerr with Debrid Media Manager. It listens to movie requests via Overseerr webhook. It automates the torrent search and download process using Debrid Media Manager via browser automation, which in turn, gets sent to Real-Debrid. This streamlines your media management, making it fast and efficient.
🛠️ Why SeerrBridge?
SeerrBridge eliminates the need to set up multiple applications like Radarr, Sonarr, Jackett, FlareSolverr, and other download clients. With SeerrBridge, you streamline your media management into one simple, automated process. No more juggling multiple tools—just request and download!
Simply put, I was too lazy to set up all of these other applications (arrs) and thought.... I want this instead.
Example:
ElfHosted is your friendly neighborhood open-source PaaS, handling the geeky heavy-lifting (hosting, security, updates, you name it!) so you can focus on syncing your lists!
Important
ElfHosted 💜 SeerrBridge & ListSync!
SeerrBridge and its awesome companion ListSync are fully supported and integrated into the ElfHosted ecosystem, you can already get them pre-configured in the bundles below, with a $1, 7-day trial!
Tip
ElfHosted Streaming Bundles: Your Turn-Key Streaming Powerhouse! 💹
Want SeerrBridge without the DIY setup? 🎉 These ElfHosted bundles come pre-wired with RealDebrid, SeerrBridge and ListSync, and your choice of media server. Get the ultimate hassle-free, automated infinite streaming experience:
📊 Flowchart (Rectangle of Life)
🔑 Key Features
-
Automated Movie Requests: Automatically processes movie requests from Overseerr and fetches torrents from Debrid Media Manager.
-
TV Show Subscriptions: Subscribes to ongoing/currently airing TV shows and automatically tracks individual episode releases.
- Automatically fetches individual episodes when complete season packs are unavailable.
- Tracks previously missed or failed episodes and retries processing them.
- Continuously polls on a defined interval to automatically detect and fetch new episodes as they are released.
- Fully integrated with Debrid Media Manager and Real-Debrid.
-
Debrid Media Manager Integration: Uses DMM to automate (via browser) torrent search & downloads.
-
Persistent Browser Session: Keeps a browser session alive using Selenium, ensuring faster and more seamless automation.
-
Queue Management: Handles multiple requests with an asynchronous queue, ensuring smooth processing.
-
Error Handling & Logging: Provides comprehensive logging and error handling to ensure smooth operation.
-
Setting Custom Regex / Filter in Settings: Upon launch, the script automates the addition of a regex filter which can be updated in code.
🌉 BridgeBoard (SeerrBridge Dashboard) - NEW FEATURE🌟
BridgeBoard is a sleek, modern web dashboard that complements the SeerrBridge application, providing a visual interface to monitor and manage your media automation:
- Status Monitoring: View the current status of SeerrBridge and your movie / TV show requests.
- TV Show Subscription Tracking: Monitor your subscribed shows, their episode status, and unsubscribe.
- Log Configurator: Manage how SeerrBridge logs are displayed within the dashboard, and where. you can create custom log types, regex patterns, and fully manage how logs are processed in the app. The app comes with a preset logs_config.json, but you can configure logs anyway you like. We may adjust this from time to time.
- Request History: Access historical data of all processed requests and logs via the Log Configurator.
- Notifications: Monitor SeerrBridge processing within Discord via a webhook notification.
- Environment Variable Management: You can manage variables within the application settings and save directly to your .env.
- Preset & Custom Regex: Within settings, you can select from pre-defined regex patterns, make custom ones, and or use the regex builder to create a new custom regex based on your preferences.
BridgeBoard connects directly to your SeerrBridge instance via API, providing a user-friendly way to interact with and monitor your media automation without having to check logs or use command line tools.
To access BridgeBoard, navigate to http://localhost:3777 after starting both containers with Docker Compose, or running it manually.
📊 Compatibility
| Service | Status | Notes |
|---|---|---|
| List Sync | ✅ | Our other Seerr app for importing lists |
| Jellyseerr | ✅ | Main integration. Supports movie requests via webhook |
| Overseerr | ✅ | Base application Jellyseerr is based on |
| Debrid Media Manager | ✅ | Torrent fetching automation |
| Real-Debrid | ✅ | Unrestricted (torrent) downloader |
| AllDebrid | ❌ | Not Supported |
| TorBox | ❌ | Not Supported |
| SuggestArr | ✅ | Automatically grab related content and send to Jellyseerr/Overseerr |
| Windows & Linux x86-64 | ✅ | Tested and working in both Windows & Linux environments |
⚙ Requirements
Before you can run this script, ensure that you have the following prerequisites:
-
SeerrBridge should be running on the same machine that Jellyseerr / Overseerr is running on.
-
You will need the API key for your .env file.
-
For notifications, navigate to Settings > Notifications > Webhook > Turn it on, and configure as shown below
http://localhost:8777/jellyseer-webhook/
Ensure your JSON payload is the following
{
"notification_type": "{{notification_type}}",
"event": "{{event}}",
"subject": "{{subject}}",
"message": "{{message}}",
"image": "{{image}}",
"{{media}}": {
"media_type": "{{media_type}}",
"tmdbId": "{{media_tmdbid}}",
"tvdbId": "{{media_tvdbid}}",
"status": "{{media_status}}",
"status4k": "{{media_status4k}}"
},
"{{request}}": {
"request_id": "{{request_id}}",
"requestedBy_email": "{{requestedBy_email}}",
"requestedBy_username": "{{requestedBy_username}}",
"requestedBy_avatar": "{{requestedBy_avatar}}",
"requestedBy_settings_discordId": "{{requestedBy_settings_discordId}}",
"requestedBy_settings_telegramChatId": "{{requestedBy_settings_telegramChatId}}"
},
"{{issue}}": {
"issue_id": "{{issue_id}}",
"issue_type": "{{issue_type}}",
"issue_status": "{{issue_status}}",
"reportedBy_email": "{{reportedBy_email}}",
"reportedBy_username": "{{reportedBy_username}}",
"reportedBy_avatar": "{{reportedBy_avatar}}",
"reportedBy_settings_discordId": "{{reportedBy_settings_discordId}}",
"reportedBy_settings_telegramChatId": "{{reportedBy_settings_telegramChatId}}"
},
"{{comment}}": {
"comment_message": "{{comment_message}}",
"commentedBy_email": "{{commentedBy_email}}",
"commentedBy_username": "{{commentedBy_username}}",
"commentedBy_avatar": "{{commentedBy_avatar}}",
"commentedBy_settings_discordId": "{{commentedBy_settings_discordId}}",
"commentedBy_settings_telegramChatId": "{{commentedBy_settings_telegramChatId}}"
},
"{{extra}}": []
}
Notification Types should also be set to "Request Automatically Approved", and your user should be set to automatic approvals.
- You will need a valid Real-Debrid account to authenticate and interact with the Debrid Media Manager.
- The Debrid Media Manager Access token, Client ID, Client Secret, & Refresh Tokens are used and should be set within your .env file. Grab this from your browser via Inspect >
This is what you want to copy from your local storage and set in your .env:
RD_ACCESS_TOKEN={"value":"your_token","expiry":123}
RD_CLIENT_ID=YOUR_CLIENT_ID
RD_CLIENT_SECRET=YOUR_CLIENT_SECRET
RD_REFRESH_TOKEN=YOUR_REFRESH_TOKEN
- Create a Trakt.tv account. Navigate to Settings > Your API Apps > New Application
- You can use https://google.com as the redirect URI
- Save the Client ID for your .env file.
- The bot requires Python 3.10.11 or higher. You can download Python from here.
- You can install the required libraries by running:
pip install -r requirements.txt
Create a .env (or rename the example .env) file in the root directory of the project and add the following environment variables:
RD_ACCESS_TOKEN={"value":"YOUR_TOKEN","expiry":123456789}
RD_REFRESH_TOKEN=YOUR_REFRESH_TOKEN
RD_CLIENT_ID=YOUR_CLIENT_ID
RD_CLIENT_SECRET=YOUR_CLIENT_SECRET
TRAKT_API_KEY=YOUR_TRAKT_TOKEN
OVERSEERR_API_KEY=YOUR_OVERSEERR_TOKEN
OVERSEERR_BASE=https://YOUR_OVERSEERR_URL.COM
HEADLESS_MODE=true
ENABLE_AUTOMATIC_BACKGROUND_TASK=false
ENABLE_SHOW_SUBSCRIPTION_TASK=false
REFRESH_INTERVAL_MINUTES=120
TORRENT_FILTER_REGEX=^(?!.*【.*?】)(?!.*[\u0400-\u04FF])(?!.*\[esp\]).*
MAX_MOVIE_SIZE=0
MAX_EPISODE_SIZE=0🛠️ Getting Started
Configure your webhook as mentioned above so SeerrBridge can ingest and process approval requests.
- Clone the repository:
git clone https://github.com/Woahai321/SeerrBridge.git cd SeerrBridge - Install dependencies:
pip install -r requirements.txt
- Run the application:
python seerrbridge.py
To run the BridgeBoard dashboard locally:
-
Ensure you have Node.js v20 or newer installed:
node --version # Should show v20.x.x or higherIf you need to install or update Node.js, visit nodejs.org.
-
Navigate to the project directory:
cd SeerrBridge -
Install Node.js dependencies:
npm install
-
Build the dashboard:
npm run build
-
Start the BridgeBoard dashboard:
npm start
-
Access the dashboard at http://localhost:3777
SeerrBridge consists of two components: the main application (seerrbridge) and an optional dashboard (bridgeboard). The recommended way to run them is using Docker Compose with the pre-built images.
- Docker and Docker Compose installed on your system
- A
.envfile with your configuration
- Create a docker-compose.yml file:
services:
seerrbridge:
image: ghcr.io/woahai321/seerrbridge:latest
container_name: seerrbridge
ports:
- "8777:8777"
env_file:
- ./.env
volumes:
- shared_logs:/app
- ./.env:/app/.env
restart: unless-stopped
command: >
sh -c "
cat /app/.env > /dev/null &&
echo 'Starting SeerrBridge with refreshed env' &&
uvicorn main:app --host 0.0.0.0 --port 8777
"
networks:
- seerrbridge_network
bridgeboard:
image: ghcr.io/woahai321/bridgeboard:latest
container_name: bridgeboard
ports:
- "3777:3777"
env_file:
- ./.env
volumes:
- shared_logs:/app
- ./.env:/app/.env
environment:
- SEERRBRIDGE_URL=http://seerrbridge:8777
- SEERRBRIDGE_LOG_PATH=/logs/seerrbridge.log
entrypoint: >
sh -c "
npm start
"
restart: unless-stopped
depends_on:
- seerrbridge
networks:
- seerrbridge_network
volumes:
shared_logs:
networks:
seerrbridge_network:
driver: bridge- Create or edit your
.envfile:
RD_ACCESS_TOKEN={"value":"YOUR_TOKEN","expiry":123456789}
RD_REFRESH_TOKEN=YOUR_REFRESH_TOKEN
RD_CLIENT_ID=YOUR_CLIENT_ID
RD_CLIENT_SECRET=YOUR_CLIENT_SECRET
TRAKT_API_KEY=YOUR_TRAKT_TOKEN
OVERSEERR_API_KEY=YOUR_OVERSEERR_TOKEN
OVERSEERR_BASE=https://YOUR_OVERSEERR_URL.COM
HEADLESS_MODE=true
ENABLE_AUTOMATIC_BACKGROUND_TASK=true
ENABLE_SHOW_SUBSCRIPTION_TASK=true
REFRESH_INTERVAL_MINUTES=120
TORRENT_FILTER_REGEX=^(?!.*【.*?】)(?!.*[\u0400-\u04FF])(?!.*\[esp\]).*
MAX_MOVIE_SIZE=0
MAX_EPISODE_SIZE=0- Ensure you get the latest image:
docker compose pull- Start the containers:
docker compose up -d- Access the applications:
- SeerrBridge API: http://localhost:8777
- BridgeBoard Dashboard: http://localhost:3777
- Volumes: The configuration creates a
configdirectory to persist SeerrBridge data - Networks: Both containers are placed on the same network so they can communicate
- Environment Variables: The bridgeboard container is configured to connect to the seerrbridge container using the internal Docker network
- Restart Policy: Containers will restart automatically unless manually stopped
IF YOU ARE USING OVERSEERR IN DOCKER AND SEERRBRIDGE IN DOCKER, YOUR WEBHOOK IN OVERSEERR NEEDS TO BE THE DOCKER CONTAINER IP
To find the IP of the SeerrBridge Docker container do the following:
docker psYou will see the container and ID
Grab the ID and do
docker inspect YOUR-IDYou will see the ID in the response:
This will determine your Overseerr Webhook URL i.e. HTTP://DOCKER-CONTAINER-IP:8077/jellyseer-webhook/
-
Check Container Networks: Run the following command to list the containers and their associated networks:
docker ps --format '{{ .ID }} {{ .Names }} {{ json .Networks }}'This will display the container IDs, names, and the networks they are connected to.
-
Disconnect the Container from Its Current Network: Use the following command to disconnect a container from its current network:
docker network disconnect NETWORK_NAME CONTAINER_ID
Replace
NETWORK_NAMEwith the name of the network the container is currently on, andCONTAINER_IDwith the ID of the container. -
Connect the Container to the Desired Network: Use the following command to connect the container to the target network:
docker network connect TARGET_NETWORK_NAME CONTAINER_ID
Replace
TARGET_NETWORK_NAMEwith the name of the network you want the container to join (e.g.,overseerr), andCONTAINER_IDwith the ID of the container. -
Verify the Changes: Run the
docker ps --format '{{ .ID }} {{ .Names }} {{ json .Networks }}'command again to confirm that both containers are now on the same network.
To move a container with ID abc123 from its current network to the overseerr network:
docker network disconnect current_network abc123
docker network connect overseerr abc123- Ensure both containers are connected to the same network after completing the steps.
- If the containers are still not communicating, double-check the network configuration and ensure no firewall rules are blocking the connection.
That's it! Your SeerrBridge container should now be up and running. 🚀
🛤️ Roadmap
- Faster Processing: Implement concurrency to handle multiple requests simultaneously.
- TV Show Support: Extend functionality to handle TV series and episodes.
- DMM Token: Ensure access token permanence/refresh
- Jellyseer/Overseer API Integration: Direct integration with Jellyseer/Overseer API for smoother automation and control.
- Title Parsing: Ensure torrent titles/names are properly matched and handle different languages.
- Docker Support: Allow for Docker / Compose container.
🔍 How It Works
- Seerr Webhook: SeerrBridge listens for movie requests via the configured webhook.
- Automated Search: It uses Selenium to automate the search for movies on Debrid Media Manager site.
- Torrent Fetching: Once a matching torrent is found, SeerrBridge automates the Real-Debrid download process.
- Queue Management: Requests are added to a queue and processed one by one, ensuring smooth and efficient operation.
If you want to see the automation working in real-time, you can edit the .env and set it to false
This will launch a visible Chrome browser. Be sure not to mess with it while it's operating or else you will break the current action/script and need a re-run.
Example:
📺 TV Show Subscription Feature
SeerrBridge now includes an exciting TV Show Subscription feature that enhances its functionality for ongoing and currently airing TV shows! With this new addition, SeerrBridge takes automated media fetching to the next level:
- Episode-Level Automation: Automatically tracks and fetches individual episodes for ongoing TV shows, especially when a complete season pack is unavailable.
- Smart Subscription System:
- Tracks currently airing episodes and checks for new releases on a defined interval.
- Handles previously missed or failed episode downloads, ensuring nothing gets left behind.
- Seamless Integration: Works flawlessly with Debrid Media Manager and Real-Debrid, providing uninterrupted automation and caching requested episodes instantly when available.
- Fully Automated: Once subscribed to a show, SeerrBridge manages all episodes for you. No need to manually check for new episodes!
- Never Miss an Episode: Perfect for keeping up with currently airing shows where season packs are rare or unavailable during release cycles.
- Optimized for Real-Debrid: Ensures episodes are downloaded as soon as torrents are cached and accessible in your debrid account.
- Retry Mechanism: Any failed episode attempts are logged and automatically retried during the next interval check.
🎉 This feature ensures you stay up to date on your favorite series—all fully automated!
📁 Movie and Show File Sizes
For movies, possible values are:
| Value | Description |
|---|---|
| 0 | Biggest Size Possible |
| 1 | 1 GB |
| 3 | 3 GB |
| 5 | 5 GB (Default) |
| 15 | 15 GB |
| 30 | 30 GB |
| 60 | 60 GB |
For episodes, possible values are:
| Value | Description |
|---|---|
| 0 | Biggest Size Possible |
| 0.1 | 100 MB |
| 0.3 | 300 MB |
| 0.5 | 500 MB |
| 1 | 1 GB (Default) |
| 3 | 3 GB |
| 5 | 5 GB |
🎯 Custom Regex Filtering
This script includes support for custom regex filtering, allowing you to filter out unwanted items and refine the results based on specific patterns. The regex is automatically added when the script runs, and you can customize it directly in the code.
The currently used regex is:
^(?!.*【.*?】)(?!.*[\u0400-\u04FF])(?!.*\[esp\]).*- Exclude Items with
【...】:(?!.*【.*?】)removes items with formatted text in this style. - Exclude Cyrillic Characters:
(?!.*[\u0400-\u04FF])removes items containing characters from Cyrillic scripts (e.g., Russian text). - Exclude Items with
[esp]:(?!.*\[esp\])removes items explicitly marked as[esp](often denoting Spanish content). - Match All Other Content:
.*ensures the filter applies to the rest of the string.
This is a broad exclusion-based filter that removes unwanted patterns without requiring specific inclusions.
If you'd like to refine the filter further to only match items containing 1080p or 2160p, you can use the following optional regex:
^(?=.*(1080p|2160p))(?!.*【.*?】)(?!.*[\u0400-\u04FF])(?!.*\[esp\]).*- Include Only Items with
1080por2160p:(?=.*(1080p|2160p))ensures that only items with these resolutions are processed. - The rest of the filter (exclude
【...】, Cyrillic characters, or[esp]) works the same as in the default regex.
To switch between the default and optional regex, simply update the .env file:
-
Default Regex:
^(?!.*【.*?】)(?!.*[\u0400-\u04FF])(?!.*\[esp\]).*
-
Optional Regex:
^(?=.*(1080p|2160p))(?!.*【.*?】)(?!.*[\u0400-\u04FF])(?!.*\[esp\]).*
This gives you flexibility to define what gets filtered, based on your preferred criteria.
Below is a categorized list of regex patterns for different filtering possibilities.
^(?!.*【.*?】)(?!.*[\u0400-\u04FF])(?!.*\[esp\]).*^(?=.*(1080p|2160p))(?!.*【.*?】)(?!.*[\u0400-\u04FF])(?!.*\[esp\]).*^(?=.*(Remux|BluRay|BDRip|BRRip))(?!.*【.*?】)(?!.*[\u0400-\u04FF])(?!.*\[esp\]).*^(?=.*(1080p|2160p))(?=.*(Remux|BluRay|BDRip|BRRip))(?!.*【.*?】)(?!.*[\u0400-\u04FF])(?!.*\[esp\]).*^(?=.*(1080p|2160p)).*^(?=.*(Remux|BluRay|BDRip|BRRip)).*^(?=.*(1080p|2160p))?(?=.*(Remux|BluRay|BDRip|BRRip))?(?!.*【.*?】)(?!.*[\u0400-\u04FF])(?!.*\[esp\]).*By selecting one of these patterns, you can tailor the regex filter to fit your exact needs.
Have any questions or need help? Feel free to open an issue or connect with us on LinkedIn.
We welcome contributions! Here’s how you can help:
- Fork the repository on GitHub.
- Create a new branch for your feature or bug fix.
- Commit your changes.
- Submit a pull request for review.
If you find SeerrBridge useful and would like to support its development, consider becoming a sponsor:
Thank you for your support!
 Kevin 💻 🐛 |
 Shivam Naik 💻 |
 jacobmejilla 💻 🤔 |
 David Young 📖 |
This project is licensed under the MIT License.
📜 Legal Disclaimer
This repository and the accompanying software are intended for educational purposes only. The creators and contributors of this project do not condone or encourage the use of this tool for any illegal activities, including but not limited to copyright infringement, illegal downloading, or torrenting copyrighted content without proper authorization.
- SeerrBridge is designed to demonstrate and automate media management workflows. It is the user's responsibility to ensure that their usage of the software complies with all applicable laws and regulations in their country.
- The tool integrates with third-party services which may have their own terms of service. Users must adhere to the terms of service of any external platforms or services they interact with.
- The authors and contributors of this project are not liable for any misuse or claims that arise from the improper use of this software. You are solely responsible for ensuring that your use of this software complies with applicable copyright laws and other legal restrictions.
- We do not provide support or assistance for any illegal activities or for bypassing any security measures or protections.
This tool is provided as-is, for educational purposes, and to help users automate the management of their own legally obtained media. It is not intended to be used for pirating or distributing copyrighted material without permission.
If you are unsure about the legality of your actions, you should consult with a legal professional before using this software.
![@allcontributors[bot]](https://avatars.githubusercontent.com/in/23186?s=64&v=4){kind=small}
