Kemono Downloader

A simple, multi-platform GUI application built with PyQt5 to download content from Kemono.su creator pages or specific posts, with options for filtering and organizing downloads.

Features

GUI Interface: Easy-to-use graphical interface.
URL Support: Download from a creator's main page (paginated) or a specific post URL.
Download Location: Select your desired output directory.
Character Filtering: Optionally filter posts and organize downloads into folders based on character names detected in post titles.
Known Characters List: Manage a persistent list of known characters for better folder organization.
File Type Filtering: Download All Files, Images Only (PNG, JPG, JPEG, WEBP, excluding GIFs), or Videos Only (MP4, MOV, MKV, WEBM, including GIFs).
Archive Skipping: Options to skip .zip and .rar files.
Folder Organization: Choose to download files into separate folders (based on character/title) or all into a single selected folder.
Progress Log: View download progress and status messages.
Dark Theme: Built-in dark theme for comfortable use.
Download Cancellation: Ability to cancel an ongoing download.
Skip Current File: Option to skip the specific file currently being downloaded within a larger batch.

Prerequisites

Python 3.6 or higher
pip package installer

Installation

Clone or download this repository to your local machine.
Navigate to the script's directory in your terminal or command prompt.
Install the required Python libraries:
```
pip install PyQt5 requests
```

How to Run

Make sure you have followed the installation steps.
Open your terminal or command prompt and navigate to the script's directory.
Run the script using Python:
```
python main.py
```

How to Use

URL Input: Enter the URL of the Kemono creator page (e.g., https://kemono.su/patreon/user/12345) or a specific post (e.g., https://kemono.su/api/v1/patreon/user/12345/post/67890) into the "Kemono Creator Page or Post URL" field. Note that while the API URL format is shown, the GUI can usually handle the standard web page URL format as well (https://kemono.su/patreon/user/12345 or https://kemono.su/patreon/user/12345/post/67890).
Download Location: Use the "Browse" button to select the root directory where you want to save the downloaded content.
Filter by Character (optional): Enter a character name from your "Known Characters" list to only download posts tagged with that character. If left empty, it will try to find any known character in the title or default to a name derived from the title.
File Type Filter: Select the type of files you want to download (All Files, Images Only, or Videos Only).
Skip Archives: Check "Skip Zip Files" and/or "Skip RAR Files" to prevent downloading these archive formats. These are checked by default.
Folder Organization: Check "Download to Separate Folders" to create subfolders within your download location based on character names or derived titles. Uncheck it to download all files directly into the selected Download Location folder. This is checked by default.
Known Characters: The list on the right shows characters the application knows about (saved in kemono_downloader_config.txt). You can manually add or delete characters here. If a new character is detected in a post title while "Download to Separate Folders" is enabled and is not in your list, the application may prompt you to add it.
Start Download: Click the "Start Download" button to begin fetching and processing content.
Cancel Download: Click "Cancel Download" to stop the process. Note that the current file download might finish before the cancellation takes effect.
Skip Current File: Click "Skip Current File" to immediately stop downloading the file currently in progress and move to the next one. This button is only enabled when a file is actively being downloaded.
Progress Log: Monitor the download status, file saves, and any errors in the "Progress Log" area.

Building an Executable (Optional)

You can create a standalone .exe file for Windows using PyInstaller.

Install PyInstaller: pip install pyinstaller
Obtain an icon file (.ico). Place it in the same directory as main.py.
Open your terminal in the script's directory and run:
```
pyinstaller --onefile --windowed --icon="your_icon_name.ico" --name="Kemono Downloader" main.py
```
Replace "your_icon_name.ico" with the actual name of your icon file.
The executable will be found in the ./dist folder.

Configuration

The application saves your list of known characters to a file named kemono_downloader_config.txt in the same directory as the script (main.py). Each character name is stored on a new line. You can manually edit this file if needed, but be mindful of the format (one name per line).

Dark Theme

The application comes with a simple dark theme applied via stylesheets.

Contributing

Contributions are welcome! If you find a bug or have a feature request, please open an issue on the GitHub repository. If you want to contribute code, please fork the repository and create a pull request.

License

[Specify your license here. E.g., MIT License]

Disclaimer: This tool interacts with kemono.su. Use it responsibly and in accordance with the website's terms of service. The author is not responsible for any misuse.

5.4 KiB Raw Blame History