Repository navigation
ShokoBridge v4.4.0: Supplemental Files & Transactional Operations
This is a major feature release that significantly enhances the script's robustness and file handling capabilities. ShokoBridge now fully manages supplemental files (like subtitles) and ensures that all file operations are atomic, preventing an incomplete or corrupt library structure.
✨ Major New Features
-
📂 Supplemental File Support: The script now automatically discovers and processes related files (e.g.,
.srt,.ass,.nfo) that share the same base name as the primary video file. When a video file is moved, copied, or linked, its sidecar files are brought along with it, ensuring your subtitles and other metadata are always where they need to be. -
🛡️ Transactional File Groups: All file operations for a media item and its supplemental files are now treated as a single, atomic transaction. If any part of the operation fails (e.g., a subtitle file can't be linked), all changes for that group are automatically rolled back. This prevents partial entries and ensures your destination library remains clean and consistent.
-
🧹 Enhanced Cleanup: The
--cleanupfunctionality has been greatly improved. It now correctly identifies and removes not only the stale media link but also all of its associated supplemental files. Furthermore, it will clean up any empty parent directories that are left behind after removing links, keeping your library tidy.
🛠️ Other Improvements
- 🏗️ Code Refactoring: The main script logic has been refactored into more focused functions (
run_add_new,run_cleanup) to improve readability and make future development easier. - 📝 Documentation: The
README.mdhas been extensively updated to reflect all new features, provide a clearer feature list, and correct minor errors.
This update makes ShokoBridge more reliable and powerful for managing complex anime libraries. As always, please report any issues you encounter on the GitHub repository.