Topics

#bunkr-downloader #coomer #coomer-downloader #coomer-party #coomer-su #downloader #erome-downloader #kemono-downloader #kemono-party #kemono-su #nsfw #python #simpcity

Language breakdown

Python 100.0%

▸ Files click to expand

README

Downloads

CoomerDL

CoomerDL is a Python desktop downloader for supported media pages such as Coomer, Kemono, Erome, Bunkr, SimpCity, and JPG5.

The app now uses a PySide6 / Qt interface. The old Tkinter / CustomTkinter UI is no longer the active desktop UI.

Features

Modern PySide6 desktop interface
Download images, videos, and compressed files from supported sites
Multithreaded downloads with configurable limits
Per-file and global progress tracking
Exportable logs
Cookies support for SimpCity
SQLite download database
Configurable naming modes
Configurable folder structure
English and Spanish included by default
Community/fork-friendly translation system

Supported file types

Videos

.mp4, .mkv, .webm, .mov, .avi, .flv, .wmv, .m4v

Images

.jpg, .jpeg, .png, .gif, .bmp, .tiff

Documents

.pdf, .doc, .docx, .xls, .xlsx, .ppt, .pptx

Compressed

.zip, .rar, .7z, .tar, .gz

Supported sites

Screenshots / usage

Launch the application
Paste a supported URL
Select your download folder
Choose the content types you want
Click Download

https://github.com/user-attachments/assets/f11a4681-4c6f-4797-a8a5-8eabe5e2cdfa

Installation

1. Clone the repository

git clone https://github.com/Emy69/CoomerDL.git
cd CoomerDL

2. Create and activate a virtual environment

Windows (PowerShell)

python -m venv .venv
.venv\Scripts\Activate.ps1

Windows (CMD)

python -m venv .venv
.venv\Scripts\activate.bat

3. Install dependencies

pip install -r requirements.txt

4. Run the app

python main.py

Requirements

Python 3.10+
Windows 10 or Windows 11

Settings overview

The Settings window currently includes:

General: language selection
Downloads: max downloads, retries, retry interval, naming mode, folder structure
Cookies: SimpCity cookies import/save/clear
Database: browse, export, and manage download records

Language support

Officially maintained in this repository:

English
Español

Other languages can be added by the community through forks.

Translation file structure

Translations are loaded from locale JSON files. The project uses stable translation keys instead of using full text strings as keys.

Example structure:

resources/config/i18n/
    languages.json
    en.json
    es.json

How to add a new language in a fork

Fork the repository
Create a new translation file by copying en.json
Rename it to your language code, for example:

- fr.json - ja.json - pt_br.json

Translate the values, but keep the keys unchanged
Register the language inside languages.json
Run the app and test the new language from Settings > General

Example languages.json:

{
  "official": [
    { "code": "en", "name": "English" },
    { "code": "es", "name": "Español" }
  ],
  "community": [
    { "code": "fr", "name": "Français" }
  ]
}

Translation rules

Do not change translation keys
Only translate the values
Keep placeholders unchanged, for example:

- {url} - {error} - {path} - {version}

If a key is missing in a community language, the app should fall back to English

Fork guide

If you want to customize the project:

1. Fork on GitHub

Use the GitHub Fork button on the repository page.

2. Clone your fork

git clone https://github.com/YOUR_USERNAME/CoomerDL.git
cd CoomerDL

3. Add the original repository as upstream

git remote add upstream https://github.com/Emy69/CoomerDL.git

4. Keep your fork updated

git fetch upstream
git checkout main
git merge upstream/main

5. Create your own branch

git checkout -b my-changes

SimpCity cookies

SimpCity may require cookies for access depending on the content or session state.

The app includes a Cookies tab where you can:

paste cookies JSON
import cookies from a file
save cookies
clear saved cookies

These cookies are only intended for SimpCity support inside the app.

Download database

CoomerDL stores downloaded file records in a local SQLite database so it can:

avoid re-downloading known files
export database records
manage entries from the Settings window

Default database location:

resources/config/downloads.db

Logs

The app keeps exportable logs and uses a domain-aware log format in the UI.

Example:

bunkr: Resolving /f/ URL ...
coomer: Fetching user posts ...
erome: Processing album URL ...
system: Download settings were applied successfully.

Default logs folder:

resources/config/logs/

CLI projects

If you prefer command-line tools, check these related projects:

Coomer CLI
SimpCity CLI

Support

If this project helps you, you can support it here:

Community

Join the Discord server:

Downloads

You can find the latest public builds on the GitHub Releases page:

Releases

🔗 More in this category