🌉 SeerrBridge - Automate Your Media Fetching with DMM 🎬

🚀 What is SeerrBridge?

🌉 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.

📊 Flowchart (Rectangle of Life)

🔑 Key Features

Automated Movie Requests: Automatically processes movie requests from Overseerr and fetches torrents from Debrid Media Manager.
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 with automate the addition of a regex filter which can be updated in code.

📊 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	❌	Coming Soon!
TorBox	❌	Coming Soon!
SuggestArr	✅	Automatically grab related content and send to Jellyseerr/Overseerr
Windows & Linux x86-64	✅	Tested and working in both Windows & Linux environments

(THIS SCRIPT IS STILL IN BETA)

⚙ Requirements

Before you can run this script, ensure that you have the following prerequisites:

1. Jellyseerr / Overseerr API & Notifications

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}}": []
}

2. Real-Debrid Account

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

3. Trakt API / Client ID

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.

4. Python 3.10.11+

The bot requires Python 3.10.11 or higher. You can download Python from here.

5. Required Python Libraries

You can install the required libraries by running:
```
pip install -r requirements.txt
```

Example `.env` File

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
REFRESH_INTERVAL_MINUTES=120
TORRENT_FILTER_REGEX=^(?!.*【.*?】)(?!.*[\u0400-\u04FF])(?!.*\[esp\]).*

🛠️ Getting Started

Sending Notifications to SeerrBridge from Jellyseerr / Overseerr

Configure your webhook as mentioned above so SeerrBridge can ingest and process approval requests.

Python Environment

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
```

🐳 Docker Support

Option 1: Using Docker Compose

Clone the repository:

git clone https://github.com/Woahai321/SeerrBridge.git
cd SeerrBridge

Copy the example .env file and update it with your specific configuration:

cp .env.example .env

Example .env:

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
REFRESH_INTERVAL_MINUTES=120
TORRENT_FILTER_REGEX=^(?!.*【.*?】)(?!.*[\u0400-\u04FF])(?!.*\[esp\]).*

Start the container:

docker compose build
docker compose up -d

Access the app at: http://localhost:8777.

Option 2: Using Docker Run

Skip Compose and run the container directly:

docker run -d \
  --name seerrbridge \
  -p 8777:8777 \
  -v $(pwd)/config:/app/config \
  -e RD_ACCESS_TOKEN={"value":"YOUR_TOKEN","expiry":123456789} \
  -e RD_REFRESH_TOKEN=YOUR_REFRESH_TOKEN \
  -e RD_CLIENT_ID=YOUR_CLIENT_ID \
  -e RD_CLIENT_SECRET=YOUR_CLIENT_SECRET \
  -e TRAKT_API_KEY=YOUR_TRAKT_TOKEN \
  -e OVERSEERR_API_KEY=YOUR_OVERSEERR_TOKEN \
  -e OVERSEERR_BASE=https://YOUR_OVERSEERR_URL.COM \
  -e HEADLESS_MODE=true \
  -e ENABLE_AUTOMATIC_BACKGROUND_TASK=true \
  -e REFRESH_INTERVAL_MINUTES=120 \
  -e TORRENT_FILTER_REGEX=^(?!.*【.*?】)(?!.*[\u0400-\u04FF])(?!.*\[esp\]).* \
  ghcr.io/woahai321/seerrbridge:main

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 ps

You will see the container and ID

Grab the ID and do

docker inspect YOUR-ID

You will see the ID in the response:

This will determine your Overseerr Webhook URL i.e. HTTP://DOCKER-CONTAINER-IP:8077/jellyseer-webhook/

Docker Network Configuration

Steps to Align Containers on the Same Network

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_NAME with the name of the network the container is currently on, and CONTAINER_ID with 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_NAME with the name of the network you want the container to join (e.g., overseerr), and CONTAINER_ID with 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.

Example

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

Notes

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.
Login With AllDebrid: Support for users on AllDebrid.
Login With TorBox: Support for users on TorBox.
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:

🎯 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.

Default Regex

The currently used regex is:

^(?!.*【.*?】)(?!.*[\u0400-\u04FF])(?!.*\[esp\]).*

What It Does:

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.

Optional Regex (Filtering by Resolution)

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\]).*

What It Does:

Include Only Items with 1080p or 2160p: (?=.*(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.

How to Use

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.

📜 List of Regex Examples

Below is a categorized list of regex patterns for different filtering possibilities.

1. Current Filter

^(?!.*【.*?】)(?!.*[\u0400-\u04FF])(?!.*\[esp\]).*

2. Current Filter with Resolutions

^(?=.*(1080p|2160p))(?!.*【.*?】)(?!.*[\u0400-\u04FF])(?!.*\[esp\]).*

3. Current Filter with Torrent Types

^(?=.*(Remux|BluRay|BDRip|BRRip))(?!.*【.*?】)(?!.*[\u0400-\u04FF])(?!.*\[esp\]).*

4. Filter with Both Types and Resolutions

^(?=.*(1080p|2160p))(?=.*(Remux|BluRay|BDRip|BRRip))(?!.*【.*?】)(?!.*[\u0400-\u04FF])(?!.*\[esp\]).*

5. Filter for Specific Resolution Only

^(?=.*(1080p|2160p)).*

6. Filter for Specific Torrent Types Only

^(?=.*(Remux|BluRay|BDRip|BRRip)).*

7. Customizable Regex Template

^(?=.*(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.

📞 Contact

Have any questions or need help? Feel free to open an issue or connect with us on LinkedIn.

🤝 Contributing

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.

💰 Donations

If you find SeerrBridge useful and would like to support its development, consider making a donation:

BTC (Bitcoin): bc1qxjpfszwvy3ty33weu6tjkr394uq30jwkysp4x0
ETH (Ethereum): 0xAF3ADE79B7304784049D200ea50352D1C717d7f2

Thank you for your support!

📄 License

This project is licensed under the MIT License.

Star History

Contributors 🌟

_Kevin
💻 🐛

📜 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.

Usage of the Software:

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.

No Liability:

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.

Educational Purpose:

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.

Files

README.md

Latest commit

History

README.md

File metadata and controls

🌉 SeerrBridge - Automate Your Media Fetching with DMM 🎬

🚀 What is SeerrBridge?

📊 Flowchart (Rectangle of Life)

🔑 Key Features

📊 Compatibility

(THIS SCRIPT IS STILL IN BETA)

⚙ Requirements

1. Jellyseerr / Overseerr API & Notifications

2. Real-Debrid Account

3. Trakt API / Client ID

4. Python 3.10.11+

5. Required Python Libraries

Example .env File

🛠️ Getting Started

Sending Notifications to SeerrBridge from Jellyseerr / Overseerr

Python Environment

🐳 Docker Support

Option 1: Using Docker Compose

Option 2: Using Docker Run

Docker Network Configuration

Steps to Align Containers on the Same Network

Example

Notes

🛤️ Roadmap

🔍 How It Works

🎯 Custom Regex Filtering

Default Regex

What It Does:

Optional Regex (Filtering by Resolution)

What It Does:

How to Use

📜 List of Regex Examples

1. Current Filter

2. Current Filter with Resolutions

3. Current Filter with Torrent Types

4. Filter with Both Types and Resolutions

5. Filter for Specific Resolution Only

6. Filter for Specific Torrent Types Only

7. Customizable Regex Template

📞 Contact

🤝 Contributing

💰 Donations

📄 License

Star History

Contributors 🌟

📜 Legal Disclaimer

Usage of the Software:

No Liability:

Educational Purpose:

Example `.env` File