/pyhwa

Small python application for reading manhwa/manhua/manga.

Primary LanguageHTMLGNU Affero General Public License v3.0AGPL-3.0

Logo

PyHwa

PyHwa is a lightweight Python application for reading manhwa, manhua, and manga across devices on your local network. Pleasant design, tracks your reading progress, and allows customization with multiple themes.

Note

The use of HakuNeko is highly recommended for rapid organization.

Features

  • Automatically displays content for playback
  • Keeps track of where you stopped
  • Keeps track of your theme choices
  • Displays in Manhwa or Manga mode (and remembers)
  • Records where you stopped
  • Responsive
  • User-friendly
  • pleasant interface
  • multiple themes (coming soon)
  • Automatic metadata search
  • Automatic retrieval of manhwa/manhua/manga information
  • separates what is read, finished and not yet read

Preview

Computer

Phone

How to install

If you want to create a shortcut on your desktop, you can create a shortcut to PyHwa.exe

Note

You need to have Python (for the server) and NodeJS (for the front-end) installed on your machine!

Quick installation

  • Click on the file PyHwa.exe. the file will take care of installing the dependencies and also the required NPM packages. If this has already been done, it will just launch the server.

Manual installation

  1. Clone repository 
    git clone https://github.com/kerogs/PyHwaer.git
  2. Installing NPM packages (at the root and in the static folder) 
    npm i;cd static; npm i
  3. download python requirements 
    pip

How to use

With exe

  • Click on the file PyHwa.exe.

With CLI

py .\app.py

How to add manhwa/manhua/manga

Everything must be put in the /static/content folder.

You must respect this tree structure for it to work properly

  • /static/content/[manga]/[chapter]/[allImage]

Example :

📦content
 ┣ 📂Arafoo Otoko no Isekai Tsuhan Seikatsu
 ┃ ┣ 📂Chapter 1
 ┃ ┃ ┣ 📜01.jpg
 ┃ ┃ ┣ 📜02.jpg
 ┃ ┃ ┣ 📜03.jpg
 ┃ ┃ ┣ 📜04.jpg
 ┃ ┃ ┣ ...
 ┃ ┣ 📂Chapter 2
 ┃ ┃ ┣ 📜01.jpg
 ┃ ┃ ┣ 📜02.jpg
 ┃ ┃ ┣ 📜03.jpg
 ┃ ┃ ┣ 📜04.jpg
 ┃ ┃ ┗ ...
 ┃ ...
 ┗ 📜 .gitkeep

Note

For the chapter numbering, you can name it as you wish, but it's highly recommended to keep to the format used in the example for the moment.

Configuration file

The configuration file is located in the root directory and is called pyhwa.ini.

default configuration

  • port = 5113
  • allow_local_network = true
  • server_requires_login = true (not currently in use)
  • admin_requires_login = true (not currently in use)
  • auto_meta_source = mangadex (only mangadex for the moment)
  • index_autometa = true
  • data_path = static/content (not support change for the moment)
  • meta_path = static/meta (not support change for the moment)
  • logs_enable = false (recommend to keep false)

Future updates to come.

  • More themes.
  • Able to record where you stop (scroll for manhwa and image for manga)
  • Modification directly on the site