CoomerDL/README.md

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

• coomer.su
• kemono.su
• erome.com
• bunkr-albums.io
• simpcity.su
• jpg5.su

---

Screenshots / usage

1. Launch the application
2. Paste a supported URL
3. Select your download folder
4. Choose the content types you want
5. 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

1. Fork the repository
2. Create a new translation file by copying en.json
3. Rename it to your language code, for example:
   • fr.json
   • ja.json
   • pt_br.json
4. Translate the values, but keep the keys unchanged
5. Register the language inside languages.json
6. 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