Rename simple subtitle files into user friendly names for Jellyfin. Also rename mkv files in folders with more than 1 mkv files into appropriate names for Jellyfin to recognize. Include additional features such as subtitle extraction, UTF-8 and traditional Chinese fix, subtitle synchronization, and subtitle cleanup.
python3 -m venv your-venv # optionalactivate the virtual environment
pip install -r requirement.txtWhen running the python script, if a virtual environment is used, make sure to use the venv python.
Simply run start.bat and input the folder accordingly.
This is for use in webtop, an isolated environment for media management in a docker containers. The isolated Docker container comes with challenges:
- applications and dependencies are not persistent on container recreation
- Python and its requirements
python3,pipand other dependencies in a virtual environment are very large in size and can become bloated
To overcome these, OliveTin API and SSH commands are used. This offload processing that require python or large dependencies to the host machine where programs and configurations are persistent, and python is already installed. The webtop container will only need to call the API or SSH commands.
The dependencies are now tracked in another git repository, built as a Linuxserver Docker Mods. For Docker deployment of webtop, need to add this line to the docker-compose.yml file.
- DOCKER_MODS=vttc08/docker-mods-webtop:latestUpon deployment, all dependencies will be installed. All configurations will be inherited from the ~/docker/webtop/config directory so ensure these are backed up before redeployment.
Use the mover script to move all the .sh files to the correct location.
The SpaceFM Custom Actions are as follows:
Ctrl-Shift-S - api.sh - Calls the script that removed marker file, and sends the folder to OliveTin API which calls the python script to process the folder of subtitles; if the folder is not located on the HDD(s) containing the movie folders (eg. at a NVMe data or cache drive), the script will prompt user to select the destination and move the files to it via rsync with tracking progress.
Ctrl-Shift-A - ffp.sh - Calls the script that runs ffprobe and prompt user to enter track number to extract subtitles from mkv file if needed.
Ctrl-Shift-D - rmass.sh - Calls the cleanup script that remove bad subtitles and unused .ass files.
Ctrl-Shift-Z - zht2s.sh - Calls the script that send files and the directory as input over SSH which will process and overwrite the files with UTF-8 encoding and traditional Chinese to simplified Chinese conversion. OliveTin is not used because tracking the progress is needed.
Ctrl-Shift-X - ffs.sh - Calls the script that send files and the directory as input over SSH to ffsubsync which will process and synchronize the subtitles against a reference file a user selected via fzf.
Shift-Z - rmads.sh - Calls the script that remove ads from subtitles, not implemented yet.
Manual Right Click - Manual action that create a marker file in .drc format with string 中英文字幕 as file name. This is used for MKVToolNix VNC container where it's difficult to copy and paste Chinese characters into it, it's difficult in the program to write Chinese on systems without Chinese input method. .drc is recognized by MKVToolNix so user can utilize the folder dialog box to copy Chinese characters. The marker file is removed by the api.sh script.
This project is licensed under the MIT License.