Thanks to visit codestin.com
Credit goes to github.com

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

25 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

Packages

No packages published