comic-list.py - Output a list of owned/missing issues of a comic book series in a single folder
pip install comic-list
comic-list will print a list of owned and missing issue numbers given a folder which contains comic book files with issue number in the file name.
Default supported extensions are: CBZ, CBR, CB7, CBA, CBT
When run no arguments it will use the following defaults:
- Get file names from current directory matching supported extensions
- Get the issue number immediately succeeding the
#symbol - Use the first and last issue numbers in the directory as the total range
You can view the arguments by running comic-list --help
positional arguments:
dir Input folder
optional arguments:
-h, --help show this help message and exit
--start START, -s START
Starting number
--end END, -e END Ending number
--digit-group [DIGIT_GROUP], -d [DIGIT_GROUP]
Nth digit group in file name that contains issue
number
--filetype FILETYPE, -f FILETYPE
Custom file extension to check for
By default the script will use the lowest and highest issue number from the files in the folder as the starting and ending points for the range. If the folder is missing the first and last issue in a series, manually specify these numbers.
By default the script will use regex to get the issue number from a file name immediately succeeding the # symbol.
If your file names do not contain the # symbol, you can call --digit-group with no arguments to grab the first set of digits in the file name as the issue number.
If the first set of digits in the file name is not the issue number, for example if the year preceeds the issue number in the file name, you can supply a number to --digit-group to specify which Nth group of digits in the file name is the issue number.
View the examples folder for example output for each argument type