A Rust-based tool for renaming TV series files with CLI and GTK3 interfaces, supporting custom templates and TVDB integration.
TV Renamer is a tool that renames TV series video files based on season and episode information. It helps organize media libraries by automatically detecting video files, applying custom naming templates, and optionally fetching episode titles from TheTVDB. The tool supports both command-line and graphical interfaces for flexibility.
Users who manage local TV series collections and want to automate file renaming for better organization, such as media enthusiasts or home server administrators.
Developers choose TV Renamer for its dual interface options, Rust-based reliability, and TVDB integration, which together provide a fast, customizable, and automated solution for media file management without relying on proprietary software.
Mirror of https://gitlab.com/mmstick/tv-renamer
Open-Awesome is built by the community, for the community. Submit a project, suggest an awesome list, or help improve the catalog on GitHub.
Offers both CLI and GTK3 GUI, allowing users to choose based on preference or automation needs, as shown in the README's separate manuals for each interface.
Supports templates with tokens like ${Series} and ${TVDB_Title}, enabling precise control over filenames, as demonstrated in the CLI examples with user-defined formats.
Automatically fetches episode titles from TheTVDB to enrich filenames, reducing manual input and improving organization, referenced in the template tokens and examples.
Written in Rust for safety and efficiency, ensuring reliable batch processing without crashes, as highlighted in the features list and build status.
Episode numbers are derived from file alphabetical order, not content, which can fail if files are misordered or named inconsistently, as warned in the GTK3 manual.
The GUI requires GTK3, making it less portable to non-Linux systems and potentially cumbersome for users on Windows or macOS without proper setup.
Relies solely on /etc/mime.types for video detection, which may exclude uncommon formats or be absent on some systems, as noted in the features list.