Kemono Downloader

Kemono Downloader

A cross-platform Python app built with PyQt6 to download content from Kemono.su

GitHub Repository

ko-fi

Overview

Kemono Downloader is a versatile Python-based desktop application built with PyQt6, designed to download content from Kemono.su. 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.

Important Notices

Disclaimer

KemonoDownloader is a tool designed for personal and educational use only, to assist users in downloading content from Kemono.su. 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.su, 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.

Ethical Use Guidelines

KemonoDownloader interacts with content from Kemono.su, 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.

Risks and Limitations

  • Legal Risks: Downloading content from Kemono.su 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.su: KemonoDownloader relies on Kemono.su, which has a history of inconsistent updates and downtime. If Kemono.su becomes unavailable, this tool will lose its functionality.
  • Rate Limits and Errors: Kemono.su may impose rate limits or other restrictions that affect download performance. The maintainers cannot guarantee uninterrupted access to Kemono.su's content.

Community Standards

We are committed to fostering a welcoming and respectful community around KemonoDownloader. Please read our Code of Conduct 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 to the maintainers via github, sourceforge or by opening a private issue labeled "Code of Conduct Violation."

Features

Post Downloading

Easily download files from specific Kemono.su posts using their URLs.

Creator Archiving

Bulk download all posts and files from a creator's profile with a single click.

File Type Support

Handle images (JPG, PNG, GIF), videos (MP4), archives (ZIP, 7Z), PDFs, and more.

Concurrent Downloads

Adjust the number of simultaneous downloads (1-10) for optimal performance.

File Deduplication

Prevent redundant downloads using URL hashes.

Image Previews

Preview images before downloading to verify content.

Detailed Logging

Track progress and troubleshoot issues with an in-app console.

Cross-Platform UI

Built with PyQt6 for a modern, intuitive interface compatible with multiple operating systems.

Media Playback

Preview videos and GIFs with built-in playback controls.

Multilingual Support

Switch between English, Japanese, and Korean languages dynamically.

Automatic Updates

Check for new versions on startup with optional notifications.

Customizable Settings

Tailor save directories, folder names, notifications, and themes to your preference.

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.

  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. Install Briefcase and dependencies:
    pip install briefcase
    pip install -r requirements.txt
  4. Initialize the Briefcase project (if not already set up):
    briefcase create
  5. Build the application:
    • Windows: briefcase build windows
    • macOS: briefcase build macos
    • Linux: briefcase build linux
  6. Run the application:
    • Windows: briefcase run windows
    • macOS: briefcase run macos
    • Linux: briefcase run linux
  7. Note: An internet connection is required to fetch content from Kemono.su.

  • Windows: Download the latest .exe (portable) or .msi (installer) tagged with [W] for windows, from the Releases page. Run the msi installer or use the portable version for no-setup runs.
  • macOS: Download the latest universal .dmg (x86_64 and Apple Silicon) tagged with [M] for MacOS, from the Releases page. Open the DMG, drag the app to Applications, and launch it.
  • Linux: Download the latest .rpm (for Fedora/Red Hat), .deb (for Debian/Ubuntu), or .pkg.tar.zst (for Arch/Pacman) tagged with [L] for Linux, from the Releases page. Run the installer and launch the app.

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.

Getting Started

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

Post Downloader Tab

  1. Enter a post URL (e.g., https://kemono.su/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.

Creator Downloader Tab

  1. Enter a creator URL (e.g., https://kemono.su/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.

Settings Tab

  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.

Help Tab

Navigate to the Help tab to read detailed guides, examples, and support information.

Screenshots

Post Downloader Tab

Post Downloader Tab

Creator Downloader Tab

Creator Downloader Tab

Settings Tab

Settings Tab

Screenshot

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.

Support

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

Contributing

Kemono Downloader is open-source, and contributions are encouraged! Please read our Contributing Guidelines for details on how to get involved, submit pull requests, and suggest features. All contributors are expected to adhere to our Code of Conduct.

  1. Fork the repository on GitHub.
  2. Create a branch for your feature or fix.
  3. Submit a pull request with a clear description of your changes.
  4. Adhere to coding standards and test your changes thoroughly.

License

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

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.

Download from SourceForge

Download KemonoDownloader

Download KemonoDownloader

Download KemonoDownloader Download KemonoDownloader Download KemonoDownloader Download KemonoDownloader