A CLI tool for converting .cbr files to .cbz files in parallel
updated license
added build badge
Fixed buildfile


browse  log 



You can also use your local clone with git send-email.


License builds.sr.ht status


The .cbr (comic book rar) file format is proprietary and doesn't play well with all comic book readers. This script will recurse a directory and convert each .cbr file found to .cbz. We divide up the work by directory and use gnu parallel to execute on each folder. After the work is complete we cleanup the old cbr files and move them to the trash folder. This tool is meant to be a one-shot to convert your whole collection. Spaces in directories or filenames are anticipated and OK 👍.


Simply run:

git clone https://git.sr.ht/~voidraven/cbr-convert
cd cbr-convert
make install      #(as root)

# to uninstall
make uninstall    #(as root)


In order to use this tool, you will need these things installed (some are likely already present on your system):


cbr-convert ./MyComicsDir    # convert all cbr files found in this directory (and subdirectories)
cbr-convert -j 8 ./Deadpool  # convert using 8 threads
cbr-convert -h               # show this help message
cbr-convert -v               # show version

( After conversion .cbr files are moved to trash )

#Video Example



Dataset = 22GB
CPU = 4th Gen i7 Quad Core
Storage = 250 Sata III SSD

-j 1 (sequential)      -j 8 (multithreaded)
real	18m34.91s     real	5m49.69s

This tool by default uses half the available cores, if possible specify a higher -j value to help speed things up.


  • Change log location (-l flag)
  • Silent mode (-s flag)
  • Possibly disable recursion by default.

#License / Disclaimer

This project is licensed under the ISC license. (See LICENSE.md)