KaviGo is a simple Go-based CLI tool that automatically renames files to match the naming conventions required by Kavita, helping you keep your manga library better organized.
Kavita is easily one of my favorite open-source projects, but the only downside I had with it was that I had to manually copy files over to the correct directory on the server. Additionally, if I wanted to use Volumes, I had to manually rename hundreds of files. So it seamed like a really good excuse to learn Go, I'm not much of a programmer (my favorite language is YAML) but I'm really proud of the end result even though the code is kind of a mess.
KaviGo renames manga chapters to a standardized naming convention. This ensures Kavita can properly parse the volume and chapter numbers, and even handle special chapters (see "Known Limitations" for more details).
I mostly get my manga from the Haku Neko Mangasee123 connector. If you're using a different source with a different naming convention, this tool may not work as expected. However, if your manga chapters are organized in a directory with the manga's name and the chapter filenames include a number representing the chapter, it should work fine.
Download the binary and run it using the following command:
./kavigo -d /path/to/source -o /path/to/destination -r /path/to/ranges.file -v -p| Flag | Description | Required |
|---|---|---|
-d |
Path to the source directory containing manga chapters (directory name should be the name of the manga) | Yes |
-o |
Path to the destination directory. If not provided, files will remain in the source directory | Optional |
-r |
Path to the Volume ranges file (comma-delimited). Why? , example | Yes |
-v |
Verbose output | Optional |
-p |
Preserve original files | Optional |
-s |
Mark special chapters as special. See Special Chapters for more info. | Optional |
Since I couldn't find an easily accessible API that provides the volume number for each chapter, I decided on a manual approach. You must provide a comma-delimited file that specifies the first and last chapters of each volume, along with the corresponding volume number. Use the -r (ranges) flag to specify the location of this file. See example
Kavita handles special chapters weirdly or I didn't grasp the idea of how to use them(). My expectation was that if I named the file like manga_name_v4_chp24.5_SP1.cbz, it would be added to both the fourth volume to the end and the "Special" tab as well, showing the volume and chapter number along with the special chapter number. Unfortunately, this wasn't the case.
The most "acceptable" solution I could think of was to set both the chapter (chp) and special episode (SP) numbers to the same value, that way it's added to the special tab and it indicates the chapter number. Special episodes will only be generated if you use the -s flag, but I don't recommend it.