ShokoBridge v4.2: The Solution to Plex's Dropped Scanner Support (Inaugural Release)

Welcome to the first public release of ShokoBridge! This project was born out of necessity. When Plex removed support for third-party scanners and agents, it broke the beloved Shoko Metadata plugin, leaving many users—especially those on locked-down platforms like the Nvidia Shield—unable to integrate their anime libraries correctly.

ShokoBridge is the purpose-built solution to that problem. Instead of relying on a plugin, it works externally to create a perfect, Plex-compatible library structure that Plex's native scanner can understand. It intelligently renames and links your files based on TMDb's season/episode format, giving you a perfectly organized and scannable library without any manual effort.

✨ Key Features of the Initial Release

• 🧠 Intelligent Two-Tiered Matching: At the heart of v4.2 is a powerful matching system that guarantees the highest possible accuracy.

  • Primary Match: Uses the direct TMDb Episode ID from Shoko for a perfect, 1:1 match.
  • Fallback Match: If a direct ID is missing, the script intelligently falls back to comparing the Shoko episode title with TMDb titles, finding the best match based on a configurable similarity score. This ensures even partially linked series are organized correctly.

• 🔗 Your Files, Your Way: Flexible File Operations: You have complete control over how your library is built. Choose the method that best suits your storage setup in the config.json file.

  • symlink (Default): The perfect solution for network shares or cross-drive setups.
  • hardlink: The most space-efficient option, ideal when your source and destination are on the same filesystem.
  • copy: Creates a full duplicate of your files, ensuring maximum compatibility and a separate, managed library.
  • move: Migrates your collection entirely into the new Plex-compatible structure.

• 🛡️ Safe and Stateful Management: We've built in a suite of tools to ensure you can manage your library with confidence.

  • Stateful Database: A local SQLite database tracks every processed file, preventing duplicates and ensuring the script only works on new additions.
  • --dry-run Mode: See exactly what the script will do without it touching a single file.
  • --cleanup Mode: Safely removes dead links and empty folders from your destination, keeping your library pristine.
  • Unmatched Reports: Generates a clear report of any files that couldn't be processed, so you know exactly what needs attention in Shoko.

• 🧩 Built for Complex Setups:

  • Path Mapping: Solves the "split-brain" problem where Plex and the script see different paths to your media (e.g., Docker, WSL, or NAS environments).
  • Cross-Platform: Works seamlessly on Windows, Linux, and WSL.

• ⚙️ Robust Foundation:

  • Centralized config.json: All settings in one easy-to-edit file.
  • Smart Caching: Minimizes TMDb API calls for faster subsequent runs.
  • Detailed Logging: Comprehensive logs with a --debug flag make troubleshooting a breeze.

This release transforms ShokoBridge into a truly "set it and forget it" solution for any serious anime collector using Plex. We're excited to share it with the community and look forward to your feedback!