Files
cbconvert/README.md
2015-11-05 07:59:07 +01:00

6.4 KiB

CBconvert

Introduction

CBconvert is a Comic Book converter.

It allows you to convert individual comics or bulk convert comics to different formats to fit your various devices.

Features

  • reads RAR, ZIP, 7Z, GZ, BZ2, CBR, CBZ, CB7, CBT, PDF, EPUB, XPS and plain directory
  • always saves processed comic in CBZ (ZIP) archive format
  • images can be converted to JPEG, PNG, GIF, TIFF or 4-Bit BMP (16 colors) file format
  • rotate, flip, adjust brightness/contrast or grayscale images
  • choose resize algorithm (NearestNeighbor, Box, Linear, MitchellNetravali, CatmullRom, Gaussian, Lanczos)
  • export covers from comics
  • create thumbnails from covers by freedesktop specification

Download

Using

usage: cbconvert [<flags>] <command> [<args> ...]

Comic Book convert tool.

Flags:
  --help           Show context-sensitive help (also try --help-long and --help-man).
  --version        Show application version.
  --outdir="."     Output directory
  --size=0         Process only files larger then size (in MB)
  --recursive      Process subdirectories recursively
  --quiet          Hide console output

Args:
  <args>  filename or directory

Commands:
  help [<command>...]
    Show help.


  convert [<flags>] <args>...
    Convert archive or document (default command)

    --width=0        Image width
    --height=0       Image height
    --fit            Best fit for required width and height
    --quality=75     JPEG image quality
    --filter=2       0=NearestNeighbor, 1=Box, 2=Linear, 3=MitchellNetravali, 4=CatmullRom, 6=Gaussian, 7=Lanczos
    --png            Encode images to PNG instead of JPEG
    --bmp            Encode images to 4-Bit BMP (16 colors) instead of JPEG
    --gif            Encode images to GIF instead of JPEG
    --tiff           Encode images to TIFF instead of JPEG
    --rgb            Convert images that have RGB colorspace (use --no-rgb if you only want to convert grayscale images)
    --nonimage       Leave non image files in archive (use --no-nonimage to remove non image files from archive)
    --grayscale      Convert images to grayscale (monochromatic)
    --rotate=0       Rotate images, valid values are 0, 90, 180, 270
    --flip="none"    Flip images, valid values are none, horizontal, vertical
    --brightness=0   Adjust brightness of the images, must be in range (-100, 100)
    --contrast=0     Adjust contrast of the images, must be in range (-100, 100)
    --suffix=SUFFIX  Add suffix to file basename

  cover [<flags>] <args>...
    Extract cover

    --width=0     Image width
    --height=0    Image height
    --fit         Best fit for required width and height
    --quality=75  JPEG image quality
    --filter=2    0=NearestNeighbor, 1=Box, 2=Linear, 3=MitchellNetravali, 4=CatmullRom, 6=Gaussian, 7=Lanczos

  thumbnail [<flags>] <args>...
    Extract cover thumbnail (freedesktop spec.)

    --width=0   Image width
    --height=0  Image height
    --fit       Best fit for required width and height
    --filter=2  0=NearestNeighbor, 1=Box, 2=Linear, 3=MitchellNetravali, 4=CatmullRom, 6=Gaussian, 7=Lanczos

man page is also available:

cbconvert --help-man | man /dev/stdin

Examples

Rescale images to 1200px for all supported files found in directory with size larger then 60MB:

cbconvert --recursive --width 1200 --size 60 /media/comics/Thorgal/

Convert all images in pdf to 4bit BMP image and save result in ~/comics directory:

cbconvert --bmp --outdir ~/comics /media/comics/Garfield/Garfield_01.pdf

BMP format is very good choice for black&white pages. Archive size can be smaller 2-3x and file will be readable by comic readers.

Generate thumbnails by freedesktop specification in ~/.thumbnails/normal directory with width 512:

cbconvert thumbnail --width 512 --outdir ~/.thumbnails/normal /media/comics/GrooTheWanderer/

Extract covers to ~/covers dir for all supported files found in directory, Lanczos algorithm is used for resizing:

cbconvert cover --outdir ~/covers --filter=7 /media/comics/GrooTheWanderer/

Compile

Install imagemagick dev packages:

apt-get install libmagickcore-dev libmagickwand-dev

Compile latest MuPDF:

git clone git://git.ghostscript.com/mupdf.git && cd mupdf
git submodule update --init --recursive
curl -L https://gist.githubusercontent.com/gen2brain/7869ac4c6db5933f670f/raw/1619394dc957ae10bcd73c713760993466b4bfea/mupdf-openssl-curl.patch | patch -p1
sed -e "1iHAVE_X11 = no" -e "1iWANT_OPENSSL = no" -e "1iWANT_CURL = no" -i Makerules
HAVE_X11=no HAVE_GLFW=no HAVE_GLUT=no WANT_OPENSSL=no WANT_CURL=no HAVE_MUJS=yes HAVE_JSCORE=no HAVE_V8=no make && make install

Compile unarr library:

git clone https://github.com/zeniko/unarr && cd unarr
mkdir lzma920 && cd lzma920 && curl -L http://www.7-zip.org/a/lzma920.tar.bz2 | tar -xjvp && cd ..
curl -L http://zlib.net/zlib-1.2.8.tar.gz | tar -xzvp
curl -L http://www.bzip.org/1.0.6/bzip2-1.0.6.tar.gz | tar -xzvp
curl -L https://gist.githubusercontent.com/gen2brain/89fe506863be3fb139e8/raw/8783a7d81e22ad84944d146c5e33beab6dffc641/unarr-makefile.patch | patch -p1
CFLAGS="-DHAVE_7Z -DHAVE_ZLIB -DHAVE_BZIP2 -I./lzma920/C -I./zlib-1.2.8 -I./bzip2-1.0.6" make
cp build/debug/libunarr.a /usr/lib64/ && cp unarr.h /usr/include

Install dependencies:

go get github.com/cheggaaa/pb
go get github.com/disintegration/imaging
go get github.com/gen2brain/go-fitz
go get github.com/gen2brain/go-unarr
go get github.com/gographics/imagick/imagick
go get github.com/hotei/bmp
go get github.com/skarademir/naturalsort
go get golang.org/x/image/tiff
go get golang.org/x/image/webp    
go get gopkg.in/alecthomas/kingpin.v2

Install go package:

go get github.com/gen2brain/cbconvert
go install github.com/gen2brain/cbconvert