This repository contains extensions for Houdoku, a manga reader for the desktop. Houdoku users can install and load extensions at runtime independent of the client version.
The authoritative list of available extensions is the @houdoku scope on the npm registry.
Definitions for functions that extensions should implement are in the houdoku-extension-lib repo.
In particular, see the interface source, which has full method documentation.
The testing workflow is intended both for development and for identifying when source websites introduce breaking changes. Therefore tests do not mock internet responses and are erratic.
# Run all tests for all extensions (may take a while)
npm run test
# Run all tests for a specific extension
npm run test-base -- test/extensions/guya.test.ts
# Run specific tests for a specific extension
npm run test-base -- test/extensions/guya.test.ts --grep "directory has"An additional way to test is by building extensions and copying them into the Houdoku
plugin directory, making them usable as if they were installed from the app.
Utility scripts are provided in /scripts:
# Clean build artifacts
./scripts/clean-all.sh
# Build all extensions (may take a while)
./scripts/build-all.sh
# Build a specific extension
./scripts/build-one.sh guya
# Manually install extensions into Houdoku for testing
# - unbuilt extensions are automatically skipped
# - INSTALL_DIR is Houdoku's userData directory,
# e.g. C:/Users/user/AppData/Roaming/Electron
# If the app is currently running, reload the extensions:
# Extensions->View Installed Extensions->Reload Extensions
./scripts/manual-install-all.sh INSTALL_DIR