manga2pdf 0.0.2

Convert manga/comic files(zip, epub, etc.) or directory containing image files (jpg, png, etc.) to PDF.

manga2pdf

Overview

This Python script is specifically designed to convert manga and comic files, including various formats such as zip, epub, and directories containing image files, to PDF format.

The resulting PDF files are optimized to resemble Japanese manga in terms of page layout and direction. By default, the script uses a "TwoPageRight" page layout that displays two pages side-by-side for a spread view, and a "R2L" (right-to-left) reading direction that is commonly used in Japanese manga.

Requirement

The script uses the Python libraries img2pdf and pikepdf to do the conversion. Moreover, it uses BeautifulSoup to read the EPUB files and rarfile to read the RAR archive files.

It requires the installation of these packages in order to work properly.

Note

• This script can only handle DRM-free fixed-layout EPUB files.
• Please ensure that the image files you input are named in numerical order according to their page sequence. For example, page_01.jpg, page_02.jpg, page_03.jpg, and so on, or 001.jpg, 002.jpg, 003.jpg, and so on. This will ensure that the pages are converted and compiled in the correct order.

Usage

This script can take input in the form of zip, cbz, rar, cbr, epub files or directories containing images (jpg, jpeg, png, gif, bmp) of manga or comic pages.

The program can be executed from the command line with the following options:

• The input_path argument represents the path to the input file. To execute the Python script correctly, specify the input_path argument as the path to the input file containing manga or comic images in any of the supported formats, such as zip, cbz, rar, cbr, epub, or a directory containing images in formats such as jpg, jpeg, png, gif, or bmp.
• The output_path argument is the path to the output PDF file. To use the script, simply run the Python script with the path to the input file or directory as the argument. If the --output option is not specified, the output file name will be automatically generated based on the name of the input file or directory.
• The pagelayout argument is the page layout of the PDF file. The pagelayout parameter can take in the following values:
  • SinglePage -> Single page display
  • OneColumn -> Enable scrolling
  • TwoPageLeft -> Spread view
  • TwoColumnLeft -> Spread view with scrolling
  • (default) TwoPageRight -> Separate Cover, Spread View
  • TwoColumnRight -> Separate Cover, Scrolling Spread View
• The direction argument is the reading direction of the PDF file. The direction parameter can take in the following values:
  • L2R -> Left Binding
  • (default) R2L -> Right Binding

By default, the page layout is set to TwoPageRight and the reading direction to R2L, which are suitable for Japanese manga.

Note

• Any images in formats other than .jpg or .jpeg will be converted to .jpg format and compressed during the conversion process.

There is a possibility that the script may not be able to handle files in unexpected formats correctly, which may result in errors or unexpected output.

Installation

To install the package by cloning the Git repository, follow these steps:

$ git clone https://github.com/mashu3/manga2pdf.git
$ cd manga2pdf/
$ pip install .

To install the package directly from the git repository, you can use the following command:

$ pip install git+https://github.com/mashu3/manga2pdf.git

Examples

• To convert my_manga.zip to my_manga.pdf using the default settings:

$ manga2pdf my_manga.zip

• To convert my_manga.epub to my_manga_spread.pdf with a spread view and right binding:

$ manga2pdf my_manga.epub -o my_manga_spread.pdf

• To convert my_comic.epub to my_comic.pdf with a TwoPage view and left binding:

$ manga2pdf my_comic.epub -o my_comic.pdf -p TwoPageLeft -d L2R

Author

mashu3