alex/mangle
1
Fork 0
Code Releases 1 Activity

Update README

Browse Source
This commit is contained in:
Alex Yatskov 2021-04-04 12:12:09 -07:00
parent c57901ce67
commit dfcd7a2d39
1 changed files with 7 additions and 16 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

23
README.md
View File

@ -1,4 +1,4 @@
# Mangle # # Mangle
Mangle is a cross-platform image converter and optimizer built for reading Manga on the Amazon Kindle and other E-ink Mangle is a cross-platform image converter and optimizer built for reading Manga on the Amazon Kindle and other E-ink
devices written in Python. With this application you can easily: devices written in Python. With this application you can easily:
@ -8,19 +8,12 @@ devices written in Python. With this application you can easily:
* Downsample and rotate images for optimal viewing on Kindle, convert to grayscale to save space and improve contrast. * Downsample and rotate images for optimal viewing on Kindle, convert to grayscale to save space and improve contrast.
* Automatically generate book meta-data so that your Manga is always properly detected and viewable in-order. * Automatically generate book meta-data so that your Manga is always properly detected and viewable in-order.
### Screenshots ###
[![Main window](https://foosoft.net/projects/mangle/img/main-thumb.png)](https://foosoft.net/projects/mangle/img/main.png)
[![Options dialog](https://foosoft.net/projects/mangle/img/options-thumb.png)](https://foosoft.net/projects/mangle/img/options.png)
### On the Kindle... ###
[![](https://foosoft.net/projects/mangle/img/kindle1-thumb.png)](https://foosoft.net/projects/mangle/img/kindle1.png) [![](https://foosoft.net/projects/mangle/img/kindle1-thumb.png)](https://foosoft.net/projects/mangle/img/kindle1.png)
[![](https://foosoft.net/projects/mangle/img/kindle2-thumb.png)](https://foosoft.net/projects/mangle/img/kindle2.png) [![](https://foosoft.net/projects/mangle/img/kindle2-thumb.png)](https://foosoft.net/projects/mangle/img/kindle2.png)
[![](https://foosoft.net/projects/mangle/img/kindle3-thumb.png)](https://foosoft.net/projects/mangle/img/kindle3.png) [![](https://foosoft.net/projects/mangle/img/kindle3-thumb.png)](https://foosoft.net/projects/mangle/img/kindle3.png)
[![](https://foosoft.net/projects/mangle/img/kindle4-thumb.png)](https://foosoft.net/projects/mangle/img/kindle4.png) [![](https://foosoft.net/projects/mangle/img/kindle4-thumb.png)](https://foosoft.net/projects/mangle/img/kindle4.png)
## Motivation ## ## Motivation
Many years ago I received an Amazon Kindle as a gift. I immediately began playing around with it and reading about Many years ago I received an Amazon Kindle as a gift. I immediately began playing around with it and reading about
certain undocumented features that the Kindle has to offer. After a couple of hours I discovered it to be the perfect certain undocumented features that the Kindle has to offer. After a couple of hours I discovered it to be the perfect
@ -54,7 +47,7 @@ However... The Kindle's image viewer does have certain shortcomings:
Mangle was born out of my annoyance with these issues. The program name is a portmanteau of "Manga" and "Kindle"; I Mangle was born out of my annoyance with these issues. The program name is a portmanteau of "Manga" and "Kindle"; I
thought it was pretty clever at the time. thought it was pretty clever at the time.
## Usage ## ## Usage
1. Add the desired images and image directories to the current book. 1. Add the desired images and image directories to the current book.
2. Re-order the images as needed (files pre-sorted alphabetically). 2. Re-order the images as needed (files pre-sorted alphabetically).
@ -63,20 +56,18 @@ thought it was pretty clever at the time.
5. Export your images, selecting the `pictures` directory you just created. 5. Export your images, selecting the `pictures` directory you just created.
6. Enjoy your Manga (if it doesn't show up, press <kbd>Alt</kbd> + <kbd>Z</kbd> while on the home menu). 6. Enjoy your Manga (if it doesn't show up, press <kbd>Alt</kbd> + <kbd>Z</kbd> while on the home menu).
## Dependencies ## ## Dependencies
* [PyQt4](https://riverbankcomputing.com/software/pyqt/download) * [PyQt4](https://riverbankcomputing.com/software/pyqt/download)
* [Python 2.7](http://www.python.org/download/releases/2.7/) * [Python 2.7](http://www.python.org/download/releases/2.7/)
* [Pillow (PIL)](https://pypi.org/project/Pillow/) * [Pillow (PIL)](https://pypi.org/project/Pillow/)
* [ReportLab](https://pypi.org/project/reportlab/) * [ReportLab](https://pypi.org/project/reportlab/)
## Installation ## ## Installation
Pre-build binaries are available for the platforms listed below. I don't have the means to make MacOS X releases myself, Pre-build binaries are available for the platforms listed below. I don't have the means to make MacOS X releases myself,
so I am providing the old (and unsupported) package built by Rob White instead. Linux users should run Mangle directly so I am providing the old (and unsupported) package built by Rob White instead. Linux users should run Mangle directly
from source. from source.
* [mangle\_win.zip](https://foosoft.net/projects/mangle/dl/mangle_win.zip) * [Windows](https://foosoft.net/projects/mangle/dl/mangle_win.zip)
* [mangle\_osx.zip](https://foosoft.net/projects/mangle/dl/mangle_osx.zip) (quite old) * [MacOS X](https://foosoft.net/projects/mangle/dl/mangle_osx.zip)
Check [INSTALL.md](INSTALL.md) for build instructions.