$ show VoxDroid/KemonoDownloader
KemonoDownloader is a cross-platform Python desktop application built with PyQt6 for downloading content from websites like Kemono.cr, Coomer.st, and Pawchive.pw, which aggregate content from platforms such as Patreon, Fanbox, and Gumroad. The application features a tabbed interface including modules for post downloading, creator archiving, settings management, and a built-in thumbnail downloader. It supports concurrent downloads, file deduplication via a hash database, proxy and Tor integration for anonymity, customizable file naming and folder structures, and multi-language support (English, Japanese, Korean, Chinese). A companion browser extension adds download buttons directly to the supported sites' web pages. The architecture employs a modular, tab-based design with each tab encapsulating specific functionality. Core operations such as API requests, file detection, and downloads are handled in background threads using QThread to maintain UI responsiveness. The application utilizes a SQLite-based hash database (HashDB) for efficient duplicate detection, implements robust HTTP request handling with retry mechanisms and exponential backoff, and provides thread-local session management to avoid SSL conflicts on Windows. Settings are persisted using QPlatform-specific storage, and the user interface updates dynamically for language or theme changes without requiring a restart. While the application is highly functional and demonstrates strong engineering practices in areas like concurrency control and error handling, its complexity arises from the intricate threading model and deep integration with the specific APIs of the target websites. This introduces a maintenance risk should those websites change their structure or availability. Nevertheless, the codebase exhibits clear separation of concerns, comprehensive test coverage, and reusable patterns such as the HashDB deduplication system, which could be adapted for use in other projects requiring reliable duplicate file detection.
The LLM identified 1 files worth highlighting for reuse:
A thread-safe SQLite-based hash database for file deduplication. It provides an isolated, self-contained mechanism to store and check file hashes (MD5) to prevent re-downloading the same file. The component can be extracted and used in another project with minimal modification (e.g., changing the table name) as it has no GUI or application-specific dependencies beyond standard library modules.