KemonoDownloader

---

---

---

Welcome to $\color{#546e7a}{\sf{\text{KemonoDownloader}}}$, a versatile Python-based desktop application built with PyQt6, designed to download content from Kemono.cr and Coomer.st. This tool enables users to archive individual posts or entire creator profiles from services like Patreon, Fanbox, and more, supporting a wide range of file types with customizable settings and advanced features.

$\color{#546e7a}{\sf{\text{Important Notices}}}$

$\color{#90a4ae}{\sf{\text{Disclaimer}}}$

KemonoDownloader is a tool designed for personal and educational use only, to assist users in downloading content from Kemono.cr and Coomer.st. The maintainers of this project do not condone or support the unauthorized distribution of copyrighted material. Users are solely responsible for ensuring they have the legal right to access and download content from Kemono.cr and Coomer.st, and for complying with all applicable laws, as well as the terms of service of the original platforms from which the content originates (e.g., Patreon, Pixiv Fanbox, Gumroad).

Misuse of this tool to infringe on creators’ rights, violate copyright laws, or breach terms of service is strictly prohibited. The maintainers are not liable for any misuse of KemonoDownloader or any consequences arising from its use, including but not limited to legal action, financial loss, or damage to third parties.

$\color{#90a4ae}{\sf{\text{Ethical Use Guidelines}}}$

KemonoDownloader interacts with content from Kemono.cr and Coomer.st, which may include material originally posted on paywalled platforms like Patreon, Pixiv Fanbox, and Gumroad. Many creators on these platforms rely on paid subscriptions for their livelihood. Downloading and redistributing their content without permission can harm their ability to continue creating.

We strongly encourage users to:

• Use KemonoDownloader responsibly and only for content you have the legal right to access.
• Support creators directly by subscribing to their official channels on platforms like Patreon, Pixiv Fanbox, or Gumroad.
• Avoid redistributing downloaded content, as this may violate copyright laws and harm creators.

$\color{#90a4ae}{\sf{\text{Risks and Limitations}}}$

• Legal Risks: Downloading content from Kemono.cr and Coomer.st may violate copyright laws or the terms of service of the original platforms. Users assume all legal risks associated with using this tool.
• Dependency on Kemono.cr and Coomer.st: KemonoDownloader relies on Kemono.cr and Coomer.st, which have a history of inconsistent updates and downtime. If these sites become unavailable, this tool will lose its functionality.
• Rate Limits and Errors: Kemono.cr and Coomer.st may impose rate limits or other restrictions that affect download performance. The maintainers cannot guarantee uninterrupted access to these sites' content.

$\color{#546e7a}{\sf{\text{Community Standards}}}$

We are committed to fostering a welcoming and respectful community around KemonoDownloader. Please read our Code of Conduct and Security Policy to understand the standards we expect from all contributors and users. Key points include:

• Respecting the intellectual property rights of creators.
• Refraining from using KemonoDownloader to engage in illegal activities, such as unauthorized distribution of copyrighted material.
• Reporting any violations of the Code of Conduct or security issues to the maintainers via [email protected] or by opening a private issue labeled "Code of Conduct Violation" or "Security Violation."

$\color{#546e7a}{\sf{\text{Table of Contents}}}$

• Important Notices
  • Disclaimer
  • Ethical Use Guidelines
  • Risks and Limitations
• Community Standards
• Features
• Browser Extension
• Installation
• Usage
  • Getting Started
  • Post Downloader Tab
  • Creator Downloader Tab
  • Settings Tab
  • Help Tab
• Screenshots
• Releases
• Support
• Contributing
• Security
• License
• Dependencies
• Special Thanks & Contributors
  • Contributor Profiles
  • Project Star Statistics
  • Star History

$\color{#546e7a}{\sf{\text{Features}}}$

KemonoDownloader offers a comprehensive set of features designed to efficiently download and manage content from Kemono.cr and Coomer.st. Below is a detailed breakdown organized by category.

$\color{#90a4ae}{\sf{\text{Downloading Capabilities}}}$

Feature	Description
Post Downloader	Download files from individual posts using direct URLs. Supports previewing, filtering by file type, and batch selection.
Creator Downloader	Bulk download entire creator profiles or selected posts. Configurable options for main files, attachments, and content images.
File Type Support	Handles images (JPG, PNG, GIF, WebP), videos (MP4, AVI, MOV), archives (ZIP, 7Z, RAR), documents (PDF, TXT), audio (MP3, WAV), and more.
URL Import	Import multiple creator URLs from .txt files for batch processing.

$\color{#90a4ae}{\sf{\text{Performance and Reliability}}}$

Feature	Description
Concurrent Downloads	Adjustable parallel downloads (1-10 threads) for optimal performance.
Retry Mechanisms	Configurable retries for posts fetching, data retrieval, file downloads, and API requests.
File Deduplication	Prevents redundant downloads using URL-based hashing.
Connection Pooling	Efficient HTTP connection management with gzip compression support.

$\color{#90a4ae}{\sf{\text{User Interface and Experience}}}$

Feature	Description
Cross-Platform GUI	Modern PyQt6 interface for Windows, macOS, and Linux.
Multilingual Support	Dynamic language switching between English, Japanese, Korean, and Simplified Chinese.
Media Playback	Built-in video and GIF preview with play/pause/seek/volume controls.
Real-time Logging	In-app console with progress bars and detailed status updates.

$\color{#90a4ae}{\sf{\text{Advanced Features}}}$

Feature	Description
Proxy Support	Tor integration and custom proxy configuration for privacy.
Automatic Updates	Optional version checking with download notifications.
Organized Storage	Automatic directory creation (Downloads, Cache, Other Files) with customizable paths.
User Agent Rotation	Realistic browser user agents to avoid detection.

$\color{#90a4ae}{\sf{\text{Settings and Customization}}}$

$\color{#90a4ae}{\sf{\text{Download Settings}}}$

Setting	Description	Default	Range
Simultaneous Downloads	Number of parallel threads	5	1-10
Creator Posts Max Attempts	Max attempts to fetch posts	200	1-1000
Post Data Max Retries	Retries for post data	7	1-50
File Download Max Retries	Retries for files	50	1-100
API Request Max Retries	Retries for API calls	3	1-10

$\color{#90a4ae}{\sf{\text{Folder Settings}}}$

• Base Directory: Custom root path for downloads
• Folder Name: Configurable app data folder name
• Platform Defaults: Auto-detection of appropriate directories per OS

$\color{#90a4ae}{\sf{\text{Help and Documentation}}}$

Feature	Description
Embedded Help	Comprehensive in-app manual with usage guides
Contextual Guidance	Step-by-step instructions for each feature
Troubleshooting	Built-in solutions for common issues

$\color{#90a4ae}{\sf{\text{Platform Support}}}$

Platform	Support Details
Windows	Native .exe builds, portable and installer options
macOS	Universal binaries for Intel and Apple Silicon
Linux	Packages for Arch, Fedora, Ubuntu, and other distributions

$\color{#90a4ae}{\sf{\text{Security and Privacy}}}$

Feature	Description
Local Storage	All data stored locally with user-specified paths
No Data Collection	No transmission of user data or download history
HTTPS Only	Secure connections to Kemono.cr and Coomer.st APIs
Ethical Design	Promotes legal and responsible content access

$\color{#546e7a}{\sf{\text{Browser Extension}}}$

KemonoDownloader also includes a standalone browser extension that provides an alternative way to download content directly from your browser. This extension works independently from the desktop application and offers a streamlined experience for individual post downloads.

$\color{#90a4ae}{\sf{\text{Core Features}}}$

• Download individual posts or multiple files from Kemono/Coomer pages
• Selective file downloads with checkbox selection
• ZIP compression for multiple files with progress tracking
• Individual downloads for large video files
• Automatic file organization and naming
• Compatible with both kemono.cr and coomer.st

$\color{#90a4ae}{\sf{\text{How It Works}}}$

The extension automatically detects when you're on a Kemono or Coomer post page and provides a download interface. You can select which files to download and choose between ZIP compression or individual file downloads.

Download Options:

• Selective Downloads: Choose specific files using checkboxes
• ZIP Compression: Download multiple files as a single compressed archive
• Individual Files: Download large files separately for better performance
• Progress Tracking: Monitor download progress in real-time

Files are downloaded directly to your browser's default download folder.

$\color{#90a4ae}{\sf{\text{Installation}}}$

1. Download the extension package from the GitHub Releases
2. Extract the ZIP file to a folder on your computer
3. Follow the browser-specific installation instructions:
   • Chrome/Edge: Enable Developer mode and load the unpacked extension
   • Firefox: Use the debugging console to load the temporary add-on

The extension works with Chrome, Edge, and other Chromium-based browsers, as well as Firefox.

$\color{#546e7a}{\sf{\text{Installation}}}$

Kemono Downloader is now packaged using Briefcase, making it easier to run or distribute as a native application across platforms. You can either build from source or use pre-compiled binaries where available.

$\color{#90a4ae}{\sf{\text{Pre-Compiled Binaries - Executable}}}$

Pre-compiled binaries are available through contributions on Ko-fi. If you’d like the convenience of ready-to-run executables instead of building from source, please support the project here: Get binaries on Ko-fi

$\color{#90a4ae}{\sf{\text{Available Binaries}}}$

• Windows:
  • Portable: W-KemonoDownloader-x86_64-Portable.exe
  • Installer: W-KemonoDownloader-x86_64.msi
• macOS:
  • M-KemonoDownloader-arm64.dmg (Apple Silicon)
  • M-KemonoDownloader-x86_64.dmg (Intel)
• Linux:
  • L-KemonoDownloader-x86_64.pkg.tar.zst (Arch-based)
  • L-KemonoDownloader-x86_64.rpm (Fedora/Red Hat based)
  • L-KemonoDownloader-amd64.deb (Debian/Ubuntu based)

Support ongoing development and get access here: Ko-fi Binaries Page

$\color{#90a4ae}{\sf{\text{Building with Briefcase (All Platforms)}}}$

1. Ensure you have Python 3.9+ installed on your system (Windows, macOS, Linux).
2. Clone this repository:

   git clone https://github.com/VoxDroid/KemonoDownloader.git
   cd KemonoDownloader

3. Create and activate virtual environment:

   python -m venv .venv
   .venv/Scripts/activate # Windows 
   source .venv/bin/activate # Linux

4. Install dependencies:

   python -m pip install -r requirements.txt

5. Build the application:
   • Windows: briefcase build windows
   • macOS: briefcase build macos
   • Linux: briefcase build linux
   • General: briefcase build (Recommended)
6. Run the application:
   • Windows: briefcase run windows
   • macOS: briefcase run macos
   • Linux: briefcase run linux
   • General: briefcase dev (Recommended)
   • Note: An internet connection is required to fetch content from Kemono.cr and Coomer.st.

$\color{#546e7a}{\sf{\text{Usage}}}$

Upon launching, you’ll see an introductory screen with a "Launch" button. Click it to enter the main interface, featuring four tabs: Post Downloader, Creator Downloader, Settings, and Help. The in-app Help tab contains a comprehensive user manual.

$\color{#90a4ae}{\sf{\text{Getting Started}}}$

• The application creates default directories (Downloads, Cache, Other Files) in the specified save location.
• Ensure an active internet connection to access Kemono.cr and Coomer.st content.
• Explore the Help tab for detailed instructions and troubleshooting tips.

$\color{#90a4ae}{\sf{\text{Post Downloader Tab}}}$

• Purpose: Download files from individual Kemono.cr and Coomer.st posts.
• How to Use:
  1. Enter a post URL (e.g., https://kemono.cr/patreon/user/123456789/post/123456789 or https://coomer.st/patreon/user/123456789/post/123456789) in the "Enter post URL" field.
  2. Click "Add to Queue" to add it to the list.
  3. Click the eye icon to view files, filter by type (e.g., JPG, ZIP), and select files to download.
  4. Click "Download" to start, and monitor progress with the progress bars and console.

$\color{#90a4ae}{\sf{\text{Creator Downloader Tab}}}$

• Purpose: Bulk download content from a creator's profile.
• How to Use:
  1. Enter a creator URL (e.g., https://kemono.cr/patreon/user/123456789 or https://coomer.st/patreon/user/123456789) in the "Enter creator URL" field.
  2. Click "Add to Queue" to add it to the list.
  3. Click the eye icon to fetch posts, configure options (Main File, Attachments, Content Images), and select posts.
  4. Click "Download" to begin, and track progress via the interface.

$\color{#90a4ae}{\sf{\text{Settings Tab}}}$

• Purpose: Customize the application’s behavior.
• How to Use:
  1. Set the folder name and save directory for downloads.
  2. Adjust simultaneous downloads (1-10) using the slider or spinbox.
  3. Click "Apply Changes" to save.

$\color{#90a4ae}{\sf{\text{Help Tab}}}$

• Purpose: Access the embedded user manual.
• How to Use: Navigate to the Help tab to read detailed guides, examples, and support information.

$\color{#546e7a}{\sf{\text{Screenshots}}}$

Here are previews of the main tabs in Kemono Downloader:

Post Downloader Tab	Creator Downloader Tab
Settings Tab

$\color{#546e7a}{\sf{\text{Releases}}}$

• Windows: Pre-compiled .exe available in the Releases section.
• macOS: Pre-compiled universal .dmg (x86_64 and Apple Silicon) available in the Releases section.
• Linux: Pre-compiled .rpm (for Fedora/Red Hat), .deb (for Debian/Ubuntu), or .pkg.tar.tsz (for Arch/Pacman) available in the Releases page.
• Check release notes for details on new features, bug fixes, and version updates.
• The Briefcase-built Python source remains the primary method, supporting all platforms with proper setup.

$\color{#546e7a}{\sf{\text{Support}}}$

For ways to get help, report issues, or support the project’s development, please see the Support page.

$\color{#546e7a}{\sf{\text{Contributing}}}$

Kemono Downloader is open-source, and contributions are encouraged! Please read our Contributing Guidelines, Code of Conduct, and Security Policy before submitting issues or pull requests. Use the appropriate issue templates for reporting bugs, suggesting features, or other contributions, and the Pull Request template for code submissions.

$\color{#546e7a}{\sf{\text{Security}}}$

If you discover a security vulnerability, please follow our Security Policy by emailing [email protected] or using the Security Report issue template for non-sensitive issues.

$\color{#546e7a}{\sf{\text{License}}}$

This project is licensed under the MIT License. Use, modify, and distribute it freely per the license terms.

$\color{#546e7a}{\sf{\text{Dependencies}}}$

To build from source, install the following Python packages:

• PyQt6 (for the GUI)
• requests (for HTTP requests)
• beautifulsoup4 (for HTML parsing)
• qtawesome (for icons)
• briefcase (for packaging the app)

Create a requirements.txt file with these dependencies and run pip install -r requirements.txt.

---

$\color{#546e7a}{\sf{\text{Special Thanks and Contributors}}}$

We’re incredibly grateful to our amazing contributors who have helped shape Kemono Downloader into what it is today.

$\color{#90a4ae}{\sf{\text{Contributor Profiles}}}$

$\color{#546e7a}{\sf{\text{Project Star Statistics}}}$

Check out how Kemono Downloader is doing in the GitHub community!

$\color{#546e7a}{\sf{\text{Star History}}}$

---

Developed by VoxDroid
GitHub | Ko-fi

---