Overblog Suivre ce blog
Editer la page Administration Créer mon blog
La boîte à fourbi

ComMangaGUI - English tutorial

(french tutorial here) 

 

Download links :

 

ComManga+ComMangaGUI (v1.1) (Windows 64bits)

ComMangaGUI source files (v1.1)

ComManga+ComMangaGUI (v1.0) (Windows 64bits)

ComMangaGUI source files (v1.0)

 

I - What are ComManga and ComMangaGUI?

ComManga is a Python-based executable inspired by the open source Mangle, which purpose is to make a CBZ file out of an image directory. The output .cbz file is then to be read using an eReader (such as Kobo or Kindle) or a tablet app, just like you would read any other ebook - but here, it's about mangas (CBZ is known as "the" comics electronic format).
ComManga behaves quite just like Mangle, but is designed as a command-line executable. Written by F. Gros, its first purpose is to be used for batch CBZ creation, what Mangle does not do (at least right now).
ComMangaGUI, for Graphic User Interface, is a almost-user-friendly way to make batch CBZ using simple naming logic; as a simple layer, ComMangaGUI will call ComManga to make the CBZ. ComMangaGUI is a freeware, written by your humble servitor, Shinkel.

II - What is required to run ComManga and ComMangaGUI?

Basically, not much. ComManga requires some files that are contained in the .zip file. Those files are :
_hashlib.pyd
bz2.pyd
ComManga.exe
library.zip
PIL._imaging.pyd
PIL._imagingft.pyd
python27.dll
select.pyd
unicodedata.pyd
w9xpopen.exe
ComMangaGUI only requires a functional ComManga executable, the only other file being of course :
ComMangaGUI.exe
Just click ComMangaGUI.exe and there you are!

III - Getting started : data to be processed
This chapter is VERY IMPORTANT. If you do not respect that, you might get chaotic CBZ or just no CBZ at all!
III-1 : File types
Images you can convert to CBZ are PNG and JPG, BMP and GIF. The quality matters little, but know that in order to have as light as possible CBZ files, the original files are processed in a lower quality. Fear not, it is made to be readable on eReaders!
III-2 : File tree depth
ComManga can find images in a 1 subdirectory-deep tree. For example :
Treeview.png
In this example, the red arrow is a wrong path, because the images are in a 2-subdirectories depth (Baki 09 > Grappler Baki 73 in this example).
The green arrow is a correct path, for the same reason. Of course, you can also place all the images in a same directory and give the path to this directory to ComManga : the 1 subdirectory depth is a maximum.
III-3 : Directories and file names for chapters and images
ComManga uses the basic alphabetical order to sort the directories and files. Seems simple, but can get surprises when you process in a same CBZ directories and/or files that a have a number with different digits count. For example :
filename.pngOn the left, an incorrect naming : even though Windows is kind and places 9 before 10, a basic alphabetical order will place 10 before 9 (because the first character that differs is 1 in a case and 9 in the other : 1 being lesser than 9, it "Chapter 10" will come out first).
To prevent this from happening, fill with 0's the chapter/image number to have the same digit count as the higher chapter/image in the directory; as you can see in the right part of the image.
There are not much cases in which it can happen : chapter or image number 9 to 10, 99 to 100 and 999 to 1000 (big series!), that's pretty much it.
What will happen if you forget this? I had the case in a volume that contained chapters 97 to 103 that the chapters 100 to 103 started the manga and only after chapter 103 came chapters 97 to 99. Kinda messes up the story ;)
III-4 : Directories names for batch processing
There are no real big deals with the directories naming while using the batch mode (not certain about non-latin characters order, though). Spaces in the naming are taken. Just make sure that the way you named your directories respects the "Directories and file names" part, but for the volumes. If you happen to name "Manga volume 9", then "Manga volume 10", batch mode will fail in creating the cbz for the "low digits" directories (the higher digit count is assumed if the lower and higher volume name differ in their digit count - see further for explanations).

IV - Using ComManga (console)
ComManga by itself can be faster to use compared to ComMangaGUI for one-shot CBZ creation. Just drag and drop on ComManga.exe the directory (respecting the III-2 rule) containing the chapters for the volume to be created and a .cbz file with the same name will be created in the parent directory of the "unassembled" volume. As simple as that!
For virtuosi of the .bat file, you can use the arguments -d <directory name> and -n <output CBZ file name>. Argument -h will remind you of that.
Little reminder though : if you wish to use names containing spaces, do not forget the quotation marks ( " " ) in the command line.

V - Using ComMangaGUI

V-1 : Single CBZ creation
This GUI for ComManga is pretty straightforward now that you have read the previous parts ;). Simply enter a path similar to III-2 in the Volume path edit box and click "Proceed to CBZ creation (single)". The output file path will be written in the lower part of the window (Info).

V-2 : Batch CBZ creation
The main part! But not very tough to understand, also.
batchtree.png

Let's assume the file tree above.
As you can see, the naming process is respected and the naming is logical.
So, if I want to batch process all 4 volumes using ComMangaGUI, here is how I will fill the fields :

filling.png

Remarks :
- The left part and right part of the directory name are optional. You can leave the fields blank and only fill the Number part range field (which is of course the minimum).
- If you have a left and/or right part for the directories name, do not forget the spaces! For example, above, I wrote for the left part : Grappler<space>Baki<space> (and NOT Grappler<space>Baki). For the right part, <space>by<space>Xxxx and NOT by<space>Xxxx . Get the difference?
If you omit this detail, you will get an error while trying to assemble your CBZ files (the directory name will not be found).

Good reading!

Partager cette page

Repost 0