Skip to content

Single-Click Automation: Content appears in your media server library (Plex/Emby) within seconds of activation

Notifications You must be signed in to change notification settings

ericvlog/rd_symlink_manager

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

22 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Real-Debrid Symlink + RD Unrestrict Downloader

All-in-One Solution for (Movies|Anime|Shows) - Direct Media Server Integration with Multi-Path Support

Docker Userscript

Features

1. Frontend Userscript (Tampermonkey/Violentmonkey)

🎮 Floating Control Center

  • 🖱️ Real-Debrid Icon with Status Indicators (Instant color changes for RD connectivity/symlink status)
  • 🎥 Auto-Video Detection: Smart file size analysis for optimal caching
  • 🚀 One-Click Actions:
    • Cache Only: Direct Real-Debrid cloud caching
    • Cache + Symlink: Full pipeline (Cache → Clean filenames → Symlink → Media Server Scan)
  • 📌 Persistent Tracking: Visual indicators for previously handled content

2. Task Manager+ Dashboard

📊 Centralized Download Control

  • 🕹️ Live Monitoring:
    • Real-time download speeds
    • Symlink creation status
    • Error tracking with auto-retry
  • 🔄 Smart Queue Management:
    • Concurrent task throttling (MAX_CONCURRENT_TASKS)
    • Status filters: Downloading | Symlinking | Completed
  • 💾 Data Portability:
    • Export/import task history
    • Cross-browser session persistence
  • 🧹 Maintenance Tools:
    • Bulk task removal
    • Cloud+Local cleanup (RD deletion + symlink removal)

3. Backend Engine

⚙️ Automated Processing Core

  • 🔄 Dual Mode Operation:
    • Symlink Mode: Instant media server-ready links
    • Download Mode: Full-file downloads from RD unrestrict links
  • 🧼 Content Sanitization:
    • Automated bad word removal (REMOVE_WORDS list)
    • Filename pattern standardization
  • 🎬 Media Server Integration:
    • Multi-path symlink support
    • Instant Plex/Emby/Jellyfin library scans
  • 📈 Performance Features:
    • Multi-instance support (different ports)
    • Docker-ready configuration

📥 Userscript Installation Guide

1. Browser Extension Setup

Required Extensions (Choose One):

2. Install the Userscript

Install Script

  1. Click the green "Install Userscript" button above
  2. Confirm installation in your userscript manager
  3. First-Time Configuration:
// ==UserScript==
// @name         RD Symlink Manager
// @namespace    http://tampermonkey.net/
// @version      1.1.0
// @description  Real-Debrid integration with direct downloads and symlink management
// @match        *://*/*
// @grant        GM_xmlhttpRequest
// @grant        GM_setClipboard
// @connect      api.real-debrid.com
// @connect      localhost
// ==/UserScript==

const config = {
    instanceName: "Main",          // Unique identifier for multiple instances
    rdApiKey: 'YOUR_API_KEY_HERE', // Get from Real-Debrid settings
    backendUrl: 'http://localhost:5002', // Local server address
    videoExtensions: ['mp4', 'mkv', 'avi'], // Supported file formats
    minFileSize: 50 * 1024 * 1024 // 50MB minimum file size filter
};

3. Verification & First Use

Successful Installation Indicators:

  1. Visit any torrent/magnet link site (e.g., 1337x, RARBG clone)
  2. Look for RD buttons next to magnet links
  3. Click the floating control panel:
    RD

UI Demo

🚀 Quick Start

git clone https://github.com/ericvlog/rd_symlink_manager.git
cd rd_symlink_manager
cp .env.example .env  # Configure with your API tokens/paths
# Create directories from your .env paths
mkdir -p \
    "${SYMLINK_BASE_PATH}" \
    "${DOWNLOAD_INCOMPLETE_PATH}" \
    "${DOWNLOAD_COMPLETE_PATH}"

# Set permissions once
sudo chown -R 1000:1000 \
    "${SYMLINK_BASE_PATH}" \
    "${DOWNLOAD_INCOMPLETE_PATH}" \
    "${DOWNLOAD_COMPLETE_PATH}"

sudo chmod -R 2775 \
    "${SYMLINK_BASE_PATH}" \
    "${DOWNLOAD_INCOMPLETE_PATH}" \
    "${DOWNLOAD_COMPLETE_PATH}"
docker compose up -d --build

📥 Installation Guide

Watch the step-by-step tutorial:
Video Thumbnail
Full Video Link

⚙️ Requirements

  • Essential:

    • Real-Debrid Premium Account (API Key)
    • Mounted Cloud Storage (Zurg + Rclone)
  • Media Stack:

    • Plex/Emby/Jellyfin (Optional but recommended)
    • Linux filesystem (ext4/XFS recommended for symlinks)
  • Browser Environment:

    • Chrome/Edge with Tampermonkey
    • Violentmonkey extension

🔑 Key Benefits

  • 🕒 One-Click Automation - From torrent to streaming in 3 clicks
  • 🔄 Zero Reprocessing - Smart tracking of handled content
  • 🛡️ Failure Resilience:
    • Download resume support
    • Symlink error auto-retry
  • 🎞️ Instant Gratification:
    • Media server-ready files
    • Clean metadata formatting
  • 📡 Hybrid Operation:
    • Mix symlinks and direct downloads
    • Multiple media library paths

Support

Optimized for Linux (Debian/Ubuntu) + Chrome/Edge
Report issues: GitHub Issues

☕ Support Development

If this project helps you, consider supporting Bitcoin (BTC):
1NizzCiosWryLMv51jp118MSjsN7FZQxjC
Bitcoin QR Code

About

Single-Click Automation: Content appears in your media server library (Plex/Emby) within seconds of activation

Topics

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published