{"id":17268204,"url":"https://github.com/gen2brain/comic-utils","last_synced_at":"2025-02-24T23:31:10.891Z","repository":{"id":1278168,"uuid":"1217549","full_name":"gen2brain/comic-utils","owner":"gen2brain","description":"Comic book archive utils","archived":true,"fork":false,"pushed_at":"2012-02-13T23:27:27.000Z","size":920,"stargazers_count":6,"open_issues_count":0,"forks_count":0,"subscribers_count":4,"default_branch":"master","last_synced_at":"2025-02-12T14:32:12.782Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":"https://github.com/gen2brain/comic-utils","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"gpl-3.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/gen2brain.png","metadata":{"files":{"readme":"README.markdown","changelog":null,"contributing":null,"funding":null,"license":"COPYING","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null}},"created_at":"2011-01-03T20:54:32.000Z","updated_at":"2024-01-18T13:57:32.000Z","dependencies_parsed_at":"2022-08-16T12:55:07.455Z","dependency_job_id":null,"html_url":"https://github.com/gen2brain/comic-utils","commit_stats":null,"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/gen2brain%2Fcomic-utils","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/gen2brain%2Fcomic-utils/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/gen2brain%2Fcomic-utils/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/gen2brain%2Fcomic-utils/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/gen2brain","download_url":"https://codeload.github.com/gen2brain/comic-utils/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":240575608,"owners_count":19823234,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":[],"created_at":"2024-10-15T08:12:47.287Z","updated_at":"2025-02-24T23:31:10.440Z","avatar_url":"https://github.com/gen2brain.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"Comic Utils\n===========\n\nAuthor: Milan Nikolic\nLicense: GPL-3\n\nIntroduction\n============\n\nThis is a simple tool for editing [comic book archives](http://en.wikipedia.org/wiki/Comic_Book_Archive_file) .\nIncluded are scripts that I use daily to rescale/convert images in archives, convert cbr to cbz and to create thumbnails by [freedesktop](http://www.freedesktop.org/wiki/) standards to be used in file managers.\nOnly cbr and cbz archives are supported.\n\nNote: Windows users can download zip package from downloads. Package doesn't contain rar.exe, you must copy that file to comic-utils/bin/rar.exe. File can be found on http://www.rarlab.com or if you already have winrar installed you can find it in Program Files.\n\nDependencies\n=====\n\n[ImageMagick](http://www.imagemagick.org) , [Netpbm](http://netpbm.sourceforge.net/) and [RAR](http://www.rarlab.com/)\n\nUsing\n=====\n\n### comic-convert\n\n    Usage: comic-convert \u003coptions\u003e \u003cfile or dir\u003e\n\n    Options:\n      -h, --help                show this help message and exit\n      -s \u003carg\u003e, --scale=\u003carg\u003e   image geometry (default 100%)\n      -q \u003carg\u003e, --quality=\u003carg\u003e image quality (default 0)\n      -l \u003carg\u003e, --level=\u003carg\u003e   adjust the level of image contrast\n      -o \u003carg\u003e, --outdir=\u003carg\u003e  output directory (default is _converted in proccesed directory)\n      -m \u003carg\u003e, --size=\u003carg\u003e    process only files larger then size (in MB)\n      -b, --bmp-4               convert images to 4bit BMP format\n      -c, --cover               convert cover to 8bit BMP instead of 4bit (used with --bmp-4)\n      -n, --no-cover            exclude cover\n      -g, --no-rgb              exclude images with RGB colorspace\n      -e \u003carg\u003e, --exclude=\u003carg\u003e list of images to exclude (0,2,13)\n      -B, --bmp-8               convert images to 8bit BMP format\n      -j, --jpeg                convert images to JPEG format\n      -p, --png                 convert images to PNG format\n      -r, --rar                 convert archive to RAR format\n      -z, --zip                 convert archive to ZIP format\n      -S, --suffix              add suffix to file basename\n      -R, --recursive           process subdirectories recursively\n      -P, --print               print filenames only\n      -v, --verbose             verbose (default)\n      -Q, --quiet               quiet\n\nExamples:\n\n    comic-convert --recursive --scale 1200 --size 60 /mnt/media/comics/BradBarron/\n\nThis example will rescale images to 1200px for all comic archive files in directory with size larger then 60MB. You can also use percents for --scale, for example 80%.\n\n    comic-convert --bmp-4 --cover --zip /mnt/media/comics/BradBarron/Brad_Barron_01 - Neljudi.cbr\n\nThis example will convert all images except comicbook cover to 4bit BMP image, cover will be 8bit BMP in 256 colors. Also, archive is converted to zip format so you get as a result .cbz file in _converted directory.\n\n[BMP](http://en.wikipedia.org/wiki/BMP_file_format) format is uncompressed, for black\u0026white pages very good choice, zip and rar can compress him very well, archive size can be smaller 2-3x and will be readable by comic readers.\n\nIf you start comic-convert without any options or arguments, you will get gui:\n\n![comic-convert.png](http://goo.gl/ZKSJB)\n\n\n### comic-thumbnails\n\n    Usage: comic-thumbnails \u003coptions\u003e \u003cfile or dir\u003e\n\n    Options:\n      -h, --help                show this help message and exit\n      -s \u003carg\u003e, --size=\u003carg\u003e    thumbnail size (default 512)\n      -o \u003carg\u003e, --outdir=\u003carg\u003e  output directory (default is ~/thumbnails/normal)\n      -q \u003carg\u003e, --quality=\u003carg\u003e quality filter, 0 = NEAREST (default), 1 = BILINEAR, 2 = BICUBIC, 3 = ANTIALIAS\n      -f, --force               overwrite (default)\n      -n, --no-clobber          do not overwrite existing file\n      -t \u003carg\u003e, --type=\u003carg\u003e    type, 0 = freedesktop (default), 1 = normal, 2 = Rodent Filemanager\n      -R, --recursive           process subdirectories recursively\n\nExamples:\n\n    comic-thumbnails --quality=3 --force /mnt/media/comics\n\nThis example will generate thumbnails by freedesktop standards in ~/.thumbnails/normal directory for whole comics collection.\nThumbnails will be 512px but since Gnome nautilus doesn't care about large directory we put those in normal so we can have nice and large thumbnails when we zoom in. Once comic-utils are installed you can make symlink like this:\n\n    ln -s /usr/bin/comics-thumbnails ~/.gnome2/nautilus-scripts/comics-thumbnails\n\nand have script available on right click in nautilus. Downside to this is that after thumbnails are created you have to reload nautilus, it's not possible to do that from script.\nFor XFCE Thunar file manager you can create [custom action](http://thunar.xfce.org/plugins.html#thunar-uca) .\n\n    comic-thumbnails -t 1 -o /tmp/thumbs\n\nThis example will create thumbnails with \"normal\" name, means archivename.png in /tmp/thumbs directory.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fgen2brain%2Fcomic-utils","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fgen2brain%2Fcomic-utils","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fgen2brain%2Fcomic-utils/lists"}