xgi / houdoku

Manga reader and library manager for the desktop
https://houdoku.org
MIT License
790 stars 41 forks source link
comics electron manga manga-reader react reactjs ts typescript

Houdoku Header

houdoku.org GitHub release GitHub Workflow Status

Houdoku is a free and open source manga reader for the desktop.


Features


Screenshots1 Screenshots2


Download

Download Houdoku from the official website.

Alternatively, you can download manually from the GitHub releases page.

Documentation

User guides and documentation are available on houdoku.org.

Development

Install dependencies:

pnpm i

Start the app in the dev environment:

pnpm dev

Stack

Application: This is an Electron application. The majority of the functionality is performed in the renderer thread. Exceptions are for cases like accessing the window class (i.e. to support minimizing the window), locating application directories, and for working with extensions. The renderer can invoke these functions through ipc.

UI: The interface uses React components. Most base components (text, buttons, links, etc.) come from Mantine.

State: Recoil is used for state management. Hooks are used for small non-shared behavior.

Storage: Library data and settings are saved with localStorage. Thumbnails are stored in the user-data path.

Plugins/Extensions: See the Tiyo repo. Dynamic loading is handled by aki-plugin-manager.

Content Sources

Houdoku allows users to import manga from their filesystem (e.g. as zip files or folders of images). To read manga from 3rd-party "content sources", the Tiyo plugin can be installed from the Plugins tab in the client.

To learn about Tiyo or request a new content source, please go to https://github.com/xgi/tiyo

License

MIT License