An open API service indexing awesome lists of open source software.

https://github.com/puff-dayo/simple-manga-viewer

Manga viewer, touchscreen-optimized, cross-platform.
https://github.com/puff-dayo/simple-manga-viewer

anime4k cross-platform manga-reader pyside6 python

Last synced: 2 months ago
JSON representation

Manga viewer, touchscreen-optimized, cross-platform.

Awesome Lists containing this project

README

          

# Simple Manga Viewer

## Features

- Open manga image folders or PDF manga files
- Switch paging direction from LTR and RTL
- Built-in image post-processing algorithms (image smoothing, Anime4K upscale, etc.)
- Touch screen long press and tap to flip support

> [!TIP]
> A much smaller LITE version without numpy&opencv upscale stuff is available. See below.

## Control

**Page flipping**: Click/touch the left/right half of the screen, mouse wheel, or keyboard arrow keys.

**Show menu**: Click/touch and hold anywhere on the screen for 2 seconds.

(Does not support touch swipe gestures; does not support saving image post-processing preferences)

## How to use

Tested on Windows11 21H2 and Debian 12 (GNOME Wayland), both touchscreen and keyboard.

### Use precomplied binary

Click to download :D

Windows:
- Full version (313MB) - [Download](https://github.com/puff-dayo/Simple-Manga-Viewer/releases/download/v1.0.0/SimpleMangaViewer_Windows_Full.7z)
- LITE version (30MB) - [Download](https://github.com/puff-dayo/Simple-Manga-Viewer/releases/download/v1.0.0/SimpleMangaViewer_Windows_Lite.7z)

Debian/Ubuntu: WIP...

### Run from source

Click to expand

--------------

Python 3.10.14 is recommended. X86_64 CPU is required.

Remember to manually remove numpy, opencv-python and pyanime4K from `requirements.txt` if you only need to run/compile a LITE version.

```bash
python -m pip install --upgrade pip
pip install -r requirements.txt
cd .\src
python -m SimpleMangaViewer.py
```

and for the LITE version:

```bash
python -m SimpleMangaViewerLITE.py
```

### Compile your own

Click to expand

-------------

Step 1:

```bash
python -m pip install --upgrade pip
pip install -r requirements.txt
pip install nuitka
cd .\src
nuitka --standalone --show-progress --disable-console --include-package=pyanime4k --plugin-enable=pyside6 --windows-icon-from-ico="path_to_icon-512.ico" --output-dir=build_output SimpleMangaViewer.py
```

and for the LITE version:

```bash
nuitka --standalone --show-progress --disable-console --onefile --plugin-enable=pyside6 --windows-icon-from-ico="path_to_icon-512.ico" --output-dir=build_output SimpleMangaViewerLITE.py
```

Check pyanime4K repo for the installation script on linux.

Step 2: Copy the `pyanime4K` folder from `Lib\site-packages` into `SimpleMangaViewer.dist` folder if not LITE version.

Step 3: Copy `icon-512.png` into the same folder as well. (optional)

Step 4: Run the `.exe` file in folder `SimpleMangaViewer.dist`.