# manga2pdf
[](https://opensource.org/licenses/MIT)
[](https://pypi.org/project/manga2pdf)
[](https://github.com/mashu3/manga2pdf/releases)
[](https://pypi.org/project/manga2pdf/)
[](https://pepy.tech/project/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](https://pypi.org/project/img2pdf/)** and **[pikepdf](https://pypi.org/project/pikepdf/)** to do the conversion.
Moreover, it uses **[lxml](https://pypi.org/project/lxml/)** to read the EPUB files and **[rarfile](https://pypi.org/project/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` 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 `pagemode` parameter can take in the following values:
- (default) `UseNone` -> Neither document outline nor thumbnail images visible
- `UseOutlines` -> Document outline visible
- `UseThumbs` -> Thumbnail images visible
- `FullScreen` -> Full-screen mode
- `UseOC` -> Optional content group panel visible
- `UseAttachments` -> Attachments panel visible
- 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.
The `-j` or `--jpeg` option converts images to JPEG format before including them in the output PDF file, resulting in a smaller file size. Similarly, the `-g` or `--grayscale` option can be used to convert images to grayscale and reduce the size of the resulting PDF file. The program outputs the converted image in the specified format and compresses the PDF file accordingly.
**Note**
- When the original image is already in the JPEG format, using the `-j` or `--jpeg` option will have no effect. Similarly, if the original image is already grayscale, using the `-g` or `--grayscale` option will have no effect. Also, if none of these options are used, the resulting PDF file will not be compressed.
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
### Installing from PyPI
To install the latest version of the package from PyPI, run the following command:
```
$ pip install manga2pdf
```
### Installing directly from the Git repository
To install the package directly from the Git repository, run the following command:
```
$ pip install git+https://github.com/mashu3/manga2pdf.git
```
### Installing by cloning the Git repository
To install the package by cloning the Git repository, follow these steps:
```
$ git clone https://github.com/mashu3/manga2pdf.git
$ cd manga2pdf/
$ pip install .
```
**Note**
- It is recommended to install the package from PyPI, but if you want to try out the latest changes, you can install it from the Git repository.
## 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
```
## GUI
To launch the graphical user interface:
```
$ manga2pdf -gui
```
The interface supports English and Japanese, and all settings that can be specified via the command line are available.
The GUI is currently under development and additional features are planned for future updates.
## Author
[mashu3](https://github.com/mashu3)
[](https://github.com/mashu3/manga2pdf/graphs/contributors)
Raw data
{
"_id": null,
"home_page": "https://github.com/mashu3/manga2pdf",
"name": "manga2pdf",
"maintainer": "",
"docs_url": null,
"requires_python": "",
"maintainer_email": "",
"keywords": "manga comic pdf converter",
"author": "mashu3",
"author_email": "",
"download_url": "https://files.pythonhosted.org/packages/e1/84/9b0ccbc7483d7fe147161bebf2f1101cced50cf2c71d6540d9d9f56418d8/manga2pdf-0.2.5.tar.gz",
"platform": null,
"description": "# manga2pdf\n[](https://opensource.org/licenses/MIT)\n[](https://pypi.org/project/manga2pdf)\n[](https://github.com/mashu3/manga2pdf/releases)\n[](https://pypi.org/project/manga2pdf/)\n[](https://pepy.tech/project/manga2pdf)\n\n## Overview\nThis 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.\n\nThe 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.\n\n## Requirement\nThe script uses the Python libraries **[img2pdf](https://pypi.org/project/img2pdf/)** and **[pikepdf](https://pypi.org/project/pikepdf/)** to do the conversion.\nMoreover, it uses **[lxml](https://pypi.org/project/lxml/)** to read the EPUB files and **[rarfile](https://pypi.org/project/rarfile/)** to read the RAR archive files.\n\nIt requires the installation of these packages in order to work properly.\n\n**Note**\n- This script can only handle DRM-free fixed-layout EPUB files.\n- 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.\n\n## Usage\nThis 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.\n\nThe program can be executed from the command line with the following options:\n- 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`.\n- 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.\n- The `pagelayout` parameter can take in the following values:\n - `SinglePage` -> Single page display\n - `OneColumn` -> Enable scrolling\n - `TwoPageLeft` -> Spread view\n - `TwoColumnLeft` -> Spread view with scrolling\n - (default) `TwoPageRight` -> Separate Cover, Spread View\n - `TwoColumnRight` -> Separate Cover, Scrolling Spread View\n- The `pagemode` parameter can take in the following values:\n - (default) `UseNone` -> Neither document outline nor thumbnail images visible\n - `UseOutlines` -> Document outline visible\n - `UseThumbs` -> Thumbnail images visible\n - `FullScreen` -> Full-screen mode\n - `UseOC` -> Optional content group panel visible\n - `UseAttachments` -> Attachments panel visible\n- The `direction` parameter can take in the following values:\n - `L2R` -> Left Binding\n - (default) `R2L` -> Right Binding\n\nBy default, the page layout is set to `TwoPageRight` and the reading direction to `R2L`, which are suitable for Japanese manga.\n\nThe `-j` or `--jpeg` option converts images to JPEG format before including them in the output PDF file, resulting in a smaller file size. Similarly, the `-g` or `--grayscale` option can be used to convert images to grayscale and reduce the size of the resulting PDF file. The program outputs the converted image in the specified format and compresses the PDF file accordingly.\n\n**Note**\n- When the original image is already in the JPEG format, using the `-j` or `--jpeg` option will have no effect. Similarly, if the original image is already grayscale, using the `-g` or `--grayscale` option will have no effect. Also, if none of these options are used, the resulting PDF file will not be compressed.\n\nThere 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.\n\n## Installation\n### Installing from PyPI\nTo install the latest version of the package from PyPI, run the following command:\n```\n$ pip install manga2pdf\n```\n### Installing directly from the Git repository\nTo install the package directly from the Git repository, run the following command:\n```\n$ pip install git+https://github.com/mashu3/manga2pdf.git\n```\n### Installing by cloning the Git repository\nTo install the package by cloning the Git repository, follow these steps:\n```\n$ git clone https://github.com/mashu3/manga2pdf.git\n$ cd manga2pdf/\n$ pip install .\n```\n**Note**\n- It is recommended to install the package from PyPI, but if you want to try out the latest changes, you can install it from the Git repository.\n\n## Examples\n- To convert `my_manga.zip` to `my_manga.pdf` using the default settings:\n```\n$ manga2pdf my_manga.zip\n```\n- To convert `my_manga.epub` to `my_manga_spread.pdf` with a spread view and right binding:\n```\n$ manga2pdf my_manga.epub -o my_manga_spread.pdf\n```\n- To convert `my_comic.epub` to `my_comic.pdf` with a TwoPage view and left binding:\n```\n$ manga2pdf my_comic.epub -o my_comic.pdf -p TwoPageLeft -d L2R\n```\n\n## GUI\nTo launch the graphical user interface:\n```\n$ manga2pdf -gui\n``` \nThe interface supports English and Japanese, and all settings that can be specified via the command line are available.\nThe GUI is currently under development and additional features are planned for future updates.\n\n## Author\n[mashu3](https://github.com/mashu3)\n\n[](https://github.com/mashu3/manga2pdf/graphs/contributors)\n",
"bugtrack_url": null,
"license": "MIT",
"summary": "Convert manga/comic files(zip, epub, etc.) or directory containing image files (jpg, png, etc.) to PDF.",
"version": "0.2.5",
"project_urls": {
"Homepage": "https://github.com/mashu3/manga2pdf"
},
"split_keywords": [
"manga",
"comic",
"pdf",
"converter"
],
"urls": [
{
"comment_text": "",
"digests": {
"blake2b_256": "c33547286f0307253363961f93fb8cec0c2c71706228402c024daa806245f2a5",
"md5": "c5fe6279619866679b90cd9589d19605",
"sha256": "7990e5e1d48489b121689bb6895b77291e852c98acd5a604a2139fd69f6122b0"
},
"downloads": -1,
"filename": "manga2pdf-0.2.5-py3-none-any.whl",
"has_sig": false,
"md5_digest": "c5fe6279619866679b90cd9589d19605",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": null,
"size": 16580,
"upload_time": "2024-02-03T10:00:48",
"upload_time_iso_8601": "2024-02-03T10:00:48.330899Z",
"url": "https://files.pythonhosted.org/packages/c3/35/47286f0307253363961f93fb8cec0c2c71706228402c024daa806245f2a5/manga2pdf-0.2.5-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": "",
"digests": {
"blake2b_256": "e1849b0ccbc7483d7fe147161bebf2f1101cced50cf2c71d6540d9d9f56418d8",
"md5": "fd7940bee5fbceb3a9ce9cb06ece2fba",
"sha256": "11e581528cf422f0bb03a388090b44c608c18a444e966160d923223e808c690d"
},
"downloads": -1,
"filename": "manga2pdf-0.2.5.tar.gz",
"has_sig": false,
"md5_digest": "fd7940bee5fbceb3a9ce9cb06ece2fba",
"packagetype": "sdist",
"python_version": "source",
"requires_python": null,
"size": 15934,
"upload_time": "2024-02-03T10:00:50",
"upload_time_iso_8601": "2024-02-03T10:00:50.031955Z",
"url": "https://files.pythonhosted.org/packages/e1/84/9b0ccbc7483d7fe147161bebf2f1101cced50cf2c71d6540d9d9f56418d8/manga2pdf-0.2.5.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2024-02-03 10:00:50",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "mashu3",
"github_project": "manga2pdf",
"travis_ci": false,
"coveralls": false,
"github_actions": false,
"lcname": "manga2pdf"
}
JSON
