Coomer-cli

Coomer-cli is a Python command-line tool for downloading media (images, videos, documents, compressed files, and more) from sites like Coomer and Kemono. It features configurable download modes (concurrent or sequential), file naming strategies, rate limiting, checksum verification, and more.

Features

• Multi-type Downloads: Supports images, videos, documents, compressed files, etc.
• Profile Downloading: Download an entire profile (all pages) or a single page.
• Only-New Mode: Option to download only new posts, stopping or skipping already downloaded files.
• Download Modes:
  • Concurrent: Multiple files are downloaded in parallel.
  • Sequential: Files are downloaded one by one (useful for video downloads on Coomer to avoid incomplete files).
• Custom File Naming: Choose from several file naming modes.
• Checksum Verification: Optionally calculate and verify SHA256 checksums for file integrity.
• Rate Limiting & Domain Concurrency: Controls the rate of requests to the same domain.

Installation

1. Clone the repository:

   git clone https://github.com/Emy69/Coomer-cli.git

2. Change to the project directory:

   cd Coomer-cli

3. (Optional) Create and activate a virtual environment, then install dependencies:

   python -m venv venv
   source venv/bin/activate   # On Windows: venv\Scripts\activate
   pip install -r requirements.txt

Cookies

Some websites may require cookies for access. You can provide your cookies in two ways:

1. Using a cookies.txt file:

• Export your cookies to a cookies.txt file (using browser extensions like "Get cookies.txt" or "Cookie Quick Manager")
• Place the file in the project directory
• The tool will automatically detect and use it

2. Directly via command line:

• Copy the cookie string from your browser's dev tools
• Pass it using the -ck or --cookies option

Usage

Run the CLI tool by specifying the URL of the profile you wish to download media from along with the desired options. If no arguments are provided, the script will display the help message explaining all options.

python coomer.py URL [options]

Examples

• Download images from a profile:

  python coomer.py https://coomer.su/onlyfans/user/12345 -t images

• Download videos in sequential mode (recommended for Coomer):

  python coomer.py https://coomer.su/onlyfans/user/12345 -t videos -sv

• Download only new posts from a profile:

  python coomer.py https://kemono.party/fanbox/user/67890 -n

• Download using cookies from a file:

  # Place cookies.txt in project directory, then:
  python coomer.py https://coomer.su/onlyfans/user/12345

• Download using cookies via command line:

  python coomer.py https://coomer.su/onlyfans/user/12345 -ck "cf_clearance=abc123; sessionid=xyz789"

• Download the entire profile with 5 workers:

  python coomer.py https://coomer.su/onlyfans/user/12345 -e -w 5

Command-Line Options

Required

• url
  The complete URL to download media from.
  Example: https://coomer.su/onlyfans/user/12345

Download Options

• -d, --download-dir
  Download directory (default: ./downloads).

• -t, --file-type
  File type to filter downloads. Options:

  • all (default)
  • images
  • videos
  • documents
  • compressed
  • others

• -p, --post-ids
  Comma-separated list of post IDs to download.
  Example: 123,124,125

• -e, --entire-profile
  Download the entire profile (all pages) instead of a single post or page.

• -n, --only-new
  Download only new posts. Stops at the first existing file unless the next option is used.

• -x, --continue-existing
  In only-new mode, skip existing files instead of stopping.

• -k, --verify-checksum
  Calculate and verify SHA256 checksums of downloaded files.

• -sv, --sequential-videos
  Force sequential mode for videos (recommended for Coomer to ensure complete downloads).

Performance & Networking Options

• -w, --workers
  Maximum number of threads for parallel downloads (default: 5).

  Note: In sequential mode (or if sequential mode is forced via -sv), this option is ignored.

• -r, --rate-limit
  Minimum interval (in seconds) between requests to the same domain (default: 2.0).

• -c, --concurrency
  Maximum number of concurrent requests per domain (default: 2).

• -ck, --cookies Cookie string for authentication. Example: "cf_clearance=abc123; sessionid=xyz789" |

• -dm, --download-mode Choose between:

  • concurrent for parallel downloads (default)
  • sequential for single sequential downloads

• -fn, --file-naming-mode
  File naming mode options:

  • 0: Original name + index
  • 1: Post title + index + short MD5 hash
  • 2: Post title - postID_index
    (default: 0).

Miscellaneous Options

• -v, --verbose
  Enable debug logging.

Contributing

Contributions are welcome! Feel free to fork the repository and submit pull requests for improvements or bug fixes.

Contributers

Support My Work

If you find this tool helpful, please consider supporting my efforts: