elie/cbconvert
1
0
Fork 0
mirror of https://github.com/gen2brain/cbconvert synced 2025-10-14 10:38:51 +02:00
Code Issues Packages Projects Releases Wiki Activity

Update README.md

Browse Source
This commit is contained in:
Milan Nikolic
2022-09-05 18:16:27 +02:00
parent 1fdc1610f5
commit 2e03350437
1 changed files with 17 additions and 15 deletions
Download Patch File Download Diff File Expand all files Collapse all files

32
README.md
View File

@@ -8,18 +8,18 @@ It can convert comics to different formats to fit your various devices.
### Features ### Features
 - reads RAR, ZIP, 7Z, CBR, CBZ, CB7, CBT, PDF, EPUB, and plain directory * reads RAR, ZIP, 7Z, CBR, CBZ, CB7, CBT, PDF, EPUB, and plain directory
 - always saves processed comics in CBZ (ZIP) archive format * always saves processed comics in CBZ (ZIP) archive format
 - images can be converted to JPEG, PNG, TIFF, WEBP, or 4-Bit BMP (16 colors) file format * images can be converted to JPEG, PNG, TIFF, WEBP, or 4-Bit BMP (16 colors) file format
 - rotate, flip, adjust brightness/contrast, adjust levels (Photoshop-like) or grayscale images * rotate, flip, adjust brightness/contrast, adjust levels (Photoshop-like) or grayscale images
 - resize algorithms (NearestNeighbor, Box, Linear, MitchellNetravali, CatmullRom, Gaussian, Lanczos) * resize algorithms (NearestNeighbor, Box, Linear, MitchellNetravali, CatmullRom, Gaussian, Lanczos)
 - export covers from comics * export covers from comics
 - create thumbnails from covers by [FreeDesktop](http://www.freedesktop.org/wiki/) specification * create thumbnails from covers by [FreeDesktop](http://www.freedesktop.org/wiki/) specification
### Download ### Download
 - [Windows](https://github.com/gen2brain/cbconvert/releases/download/0.7.0/cbconvert-0.7.0.zip) * [Windows](https://github.com/gen2brain/cbconvert/releases/download/0.7.0/cbconvert-0.7.0.zip)
 - [Linux](https://github.com/gen2brain/cbconvert/releases/download/0.7.0/cbconvert-0.7.0.tar.gz) * [Linux](https://github.com/gen2brain/cbconvert/releases/download/0.7.0/cbconvert-0.7.0.tar.gz)
### Using cbconvert in file managers to generate FreeDesktop thumbnails ### Using cbconvert in file managers to generate FreeDesktop thumbnails
@@ -39,6 +39,7 @@ This is what it looks like in the PCManFM file manager:
### Using command line app ### Using command line app
```
    Usage: cbconvert <command> [<flags>] [file1 dir1 ... fileOrDirN]     Usage: cbconvert <command> [<flags>] [file1 dir1 ... fileOrDirN]
@@ -141,33 +142,34 @@ This is what it looks like in the PCManFM file manager:
            Process subdirectories recursively (default "false")             Process subdirectories recursively (default "false")
        --quiet         --quiet
            Hide console output (default "false")             Hide console output (default "false")
```
### Examples ### Examples
Rescale images to 1200px for all supported files found in a directory with a size larger than 60MB: Rescale images to 1200px for all supported files found in a directory with a size larger than 60MB:
    cbconvert --recursive --width 1200 --size 60 /media/comics/Thorgal/ `cbconvert --recursive --width 1200 --size 60 /media/comics/Thorgal/`
Convert all images in pdf to 4bit BMP images and save the result in ~/comics directory: Convert all images in pdf to 4bit BMP images and save the result in ~/comics directory:
    cbconvert --bmp --outdir ~/comics /media/comics/Garfield/Garfield_01.pdf `cbconvert --bmp --outdir ~/comics /media/comics/Garfield/Garfield_01.pdf`
[BMP](http://en.wikipedia.org/wiki/BMP_file_format) format is a very good choice for black&white pages. Archive size can be smaller 2-3x and the file will be readable by comic readers. [BMP](http://en.wikipedia.org/wiki/BMP_file_format) format is a very good choice for black&white pages. Archive size can be smaller 2-3x and the file will be readable by comic readers.
Generate thumbnails by [freedesktop specification](http://specifications.freedesktop.org/thumbnail-spec/thumbnail-spec-latest.html) in ~/.cache/thumbnails/normal directory with width 512: Generate thumbnails by [freedesktop specification](http://specifications.freedesktop.org/thumbnail-spec/thumbnail-spec-latest.html) in ~/.cache/thumbnails/normal directory with width 512:
    cbconvert thumbnail --width 512 --outdir ~/.cache/thumbnails/normal /media/comics/GrooTheWanderer/ `cbconvert thumbnail --width 512 --outdir ~/.cache/thumbnails/normal /media/comics/GrooTheWanderer/`
Extract covers to ~/covers dir for all supported files found in the directory, Lanczos algorithm is used for resizing: Extract covers to ~/covers dir for all supported files found in the directory, Lanczos algorithm is used for resizing:
    cbconvert cover --outdir ~/covers --filter=7 /media/comics/GrooTheWanderer/ `cbconvert cover --outdir ~/covers --filter=7 /media/comics/GrooTheWanderer/`
### Compile ### Compile
Install ImageMagick development packages, e.g. on Ubuntu: Install ImageMagick development packages, e.g. on Ubuntu:
    apt-get install libmagickcore-dev libmagickwand-dev `apt-get install libmagickcore-dev libmagickwand-dev`
Install to GOBIN: Install to GOBIN:
    go install github.com/gen2brain/cbconvert/cmd/cbconvert@latest `go install github.com/gen2brain/cbconvert/cmd/cbconvert@latest`