KToolBox

An easy-to-use WebUI, CLI, and Python client for downloading public works from Pawchive.

English | 简体中文 | 繁體中文 | Русский | 日本語 | 한국어 | Français

Warning

KToolBox v1 is a new major version and has not yet received enough real-world validation. Some features may still fail. Please report anything unexpected.

Kemono is no longer available, so KToolBox now uses the Pawchive mirror by default.

Start with the WebUI

The WebUI is the recommended way to use KToolBox. It covers downloads, creator synchronization, automatic schedules, naming, filters, progress, and project configuration without requiring you to edit commands or configuration files first.

1. Install KToolBox with the WebUI:

   pipx install "ktoolbox[webui]"

2. Create a project directory and start it:

   mkdir ktoolbox-project
   cd ktoolbox-project
   ktoolbox webui .

3. The browser opens automatically. Sign in with the username and random password printed in the terminal.

4. Add creators on Creators, then create a synchronization or download task on Tasks.

KToolBox creates ktoolbox.toml when it is missing and downloads to the project's downloads directory by default.

Read the short WebUI guide for the next steps, or open the documentation home to choose a specific workflow.

What the WebUI includes

• Single-work downloads and concurrent synchronization of many creators.
• A reusable creator roster, filters, naming templates, and automatic synchronization plans.
• Persistent task history, live progress, aggregate speed, retries, pause, stop, rerun, and safe cleanup.
• Project-level settings with readable descriptions and filesystem pickers where appropriate.
• Seven interface languages, responsive layouts, light and dark themes, and optional NSFW media previews.
• A built-in MCP service for Codex, Claude, Cursor, VS Code, and compatible clients.

Optional setup

The generated login is convenient for a first run. For a stable password, generate a hash and add it to the project's .env:

ktoolbox webui hash-password

KTOOLBOX_WEBUI__USERNAME=owner
KTOOLBOX_WEBUI__PASSWORD_HASH='$argon2id$...'

For local-only access, start with --host 127.0.0.1. The built-in server uses HTTP, so use a trusted network or an HTTPS reverse proxy for remote access.

Advanced use

The command line remains available for scripts and terminal workflows:

ktoolbox download https://pawchive.pw/fanbox/user/6570768/post/1836570
ktoolbox sync fanbox:123 patreon:456 --length 10

See the CLI guide for commands, the MCP guide for AI clients, and the Python API guide for integrations.

Upgrading from v0

Back up .env, prod.env, and existing downloads before upgrading. WebUI detects legacy naming settings and guides you through configuration and directory conversion. Read the v1 migration guide before changing an existing project; see troubleshooting if a migration or task fails.

Development

poetry install --with test,docs,dev
poetry run pytest --cov
poetry run mkdocs build --strict
cd webui && npm ci && npm run test && npm run build

Default tests are offline and must not contact Pawchive or any other remote service.

License

KToolBox is licensed under the BSD 3-Clause License.