Welcome to Kemono Downloader, 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.
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.
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.
- 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.
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."
- Important Notices
- Community Standards
- Features
- Installation
- Usage
- Screenshots
- Releases
- Support
- Contributing
- Security
- License
- Dependencies
- 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 (play, pause, seek, volume).
- Multilingual Support: Switch between English, Japanese, and Korean languages dynamically.
- Automatic Updates: Check for new versions on startup with optional notifications.
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.
- Ensure you have Python 3.9+ installed on your system (Windows, macOS, Linux).
- Clone this repository:
git clone https://github.com/VoxDroid/KemonoDownloader.git cd KemonoDownloader - Install Briefcase and dependencies:
pip install briefcase pip install -r requirements.txt
- Initialize the Briefcase project (if not already set up):
briefcase create
- Build the application:
- Windows:
briefcase build windows - macOS:
briefcase build macos - Linux:
briefcase build linux
- Windows:
- Run the application:
- Windows:
briefcase run windows - macOS:
briefcase run macos - Linux:
briefcase run linux - Note: An internet connection is required to fetch content from Kemono.su.
- Windows:
- 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.
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.
- 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.
- Purpose: Download files from individual Kemono.su posts.
- How to Use:
- Enter a post URL (e.g.,
https://kemono.su/patreon/user/123456789/post/123456789) in the "Enter post URL" field. - Click "Add to Queue" to add it to the list.
- Click the eye icon to view files, filter by type (e.g., JPG, ZIP), and select files to download.
- Click "Download" to start, and monitor progress with the progress bars and console.
- Enter a post URL (e.g.,
- Purpose: Bulk download content from a creator's profile.
- How to Use:
- Enter a creator URL (e.g.,
https://kemono.su/patreon/user/123456789) in the "Enter creator URL" field. - Click "Add to Queue" to add it to the list.
- Click the eye icon to fetch posts, configure options (Main File, Attachments, Content Images), and select posts.
- Click "Download" to begin, and track progress via the interface.
- Enter a creator URL (e.g.,
- Purpose: Customize the application’s behavior.
- How to Use:
- Set the folder name and save directory for downloads.
- Adjust simultaneous downloads (1-10) using the slider or spinbox.
- Click "Apply Changes" to save.
- Purpose: Access the embedded user manual.
- How to Use: Navigate to the Help tab to read detailed guides, examples, and support information.
Here are previews of the main tabs in Kemono Downloader:
Post Downloader Tab |
Creator Downloader Tab |
Settings Tab |
- Windows: Pre-compiled
.exeavailable 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.
For ways to get help, report issues, or support the project’s development, please see the Support page.
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.
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.
This project is licensed under the MIT License. Use, modify, and distribute it freely per the license terms.
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.
Developed by VoxDroid
GitHub | Ko-fi
