https://github.com/firedogs2x/houdoku-2
Based off of Houdoku-2.16.0 (https://github.com/xgi/houdoku)
https://github.com/firedogs2x/houdoku-2
comics comics-reader electron manga manga-reader react reactjs
Last synced: about 1 month ago
JSON representation
Based off of Houdoku-2.16.0 (https://github.com/xgi/houdoku)
- Host: GitHub
- URL: https://github.com/firedogs2x/houdoku-2
- Owner: Firedogs2x
- License: mit
- Created: 2025-11-16T17:47:26.000Z (7 months ago)
- Default Branch: main
- Last Pushed: 2026-02-18T12:43:33.000Z (4 months ago)
- Last Synced: 2026-02-18T17:00:36.533Z (4 months ago)
- Topics: comics, comics-reader, electron, manga, manga-reader, react, reactjs
- Language: TypeScript
- Homepage:
- Size: 3.2 MB
- Stars: 1
- Watchers: 0
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
## Houdoku is a free and open source manga reader for the desktop.
Download Houdoku from [GitHub releases page](https://github.com/Firedogs2x/houdoku/releases).
## Home Page
New:
1) Set the color of the scroll bar slider.
## Series Page
New:
1) Added the ability to add and display two alternate titles.
2) Added Series rating, 0 - 10, selectable drop-down menu, displayed on Series Card.
3) The abilty to select multiple check boxes in column one using "Shift + Left Mouse Button".
4) New column called "Skip". Allows you to select chapters that you wish to skip while reading.
5) Now only the chapter list scrolls instead of the whole page.
## Series Card
The Series card has some new features.
In the upper right corner the number of unread chapters and the total numbers are shown (unread chapters only was visible in older version) (See note below).
Indicator positioned just below the total number of chapters has two functions.
1) Shows that no chapters have been read in that series.
2) Shows new chapters have been added after the last time a chapter was read in that series.
Series Rating is shown inside of the star located in the lower left corner. To set the rating goto the Series page.
Below the title is the date showing the last time a chapter in that series was read and the date showing the last time a new chapter was added.
Bottom left corner a Ratings count with a star icon.
The following items now have the ability to have a custom set color:
1) Chapter count background.
2) Chapter count font.
3) Rating star fill.
4) Rating star font.
NOTE: The total number of chapters may show up wrong. This is because some websites allow multiple chapters with the same number to be upload to website.
(Example: Currently the program sees Vol. 1 Ch. 1 the same as Ch 1).
## Features
- Semi-automated Series loader. Button located on Add Series page. Must have Settings / Folder tab filled out for option to work.
- Read manga from popular websites or import ones from your filesystem, all in one place.
- Customizable reader interface with multiple layouts and settings.
- The ability to set custom colors.
- Download chapters for offline reading.
- Tagging and filtering support to easily browse and manage large libraries.
- Cross-platform!
## Documentation
User guides and documentation are available on
[houdoku.org](https://houdoku.org).
## 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.) use [Radix primitives](https://www.radix-ui.com/primitives) and were designed by [shadcn](https://ui.shadcn.com).
**State**: [Recoil](https://recoiljs.org) 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](https://github.com/xgi/tiyo) repo. Dynamic loading is handled by [aki-plugin-manager](https://github.com/xgi/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](https://github.com/Firedogs2x/houdoku/blob/master/LICENSE.txt)