https://github.com/serpapps/coomer-downloader
Coomer Downloader Browser Extension (Chrome, Firefox, Edge, Opera, Brave)
https://github.com/serpapps/coomer-downloader
coomer-downloader coomer-video-downloader
Last synced: 5 months ago
JSON representation
Coomer Downloader Browser Extension (Chrome, Firefox, Edge, Opera, Brave)
- Host: GitHub
- URL: https://github.com/serpapps/coomer-downloader
- Owner: serpapps
- Created: 2025-11-08T05:10:37.000Z (7 months ago)
- Default Branch: main
- Last Pushed: 2026-01-09T00:39:53.000Z (5 months ago)
- Last Synced: 2026-01-12T17:21:35.666Z (5 months ago)
- Topics: coomer-downloader, coomer-video-downloader
- Homepage: https://serp.ly/coomer-downloader
- Size: 8.79 KB
- Stars: 0
- Watchers: 0
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- Funding: .github/FUNDING.yml
Awesome Lists containing this project
README
# Coomer Downloader Browser Extension (Chrome, Firefox, Edge, Opera, Brave)
## Related
---
Research
# How to Download Coomer Videos: Technical Analysis of Stream Patterns, CDNs, and Download Methods
*A comprehensive research document analyzing Coomer's video infrastructure, embed patterns, stream formats, and optimal download strategies using modern tools*
**Authors**: SERP Apps
**Date**: December 2025
**Version**: 1.0
---
- [Coomer Downloader gist](https://gist.github.com/devinschumacher/e86dd22a135ca854743214392117ae01)
## Abstract
This document covers Coomer's API endpoints for post metadata and the direct file URLs used for attachments, including video files.
## Table of Contents
1. [Introduction](#1-introduction)
2. [Coomer Video Infrastructure Overview](#2-coomer-video-infrastructure-overview)
3. [URL Patterns and Detection](#3-url-patterns-and-detection)
4. [Stream Formats and CDN Analysis](#4-stream-formats-and-cdn-analysis)
5. [yt-dlp Implementation Strategies](#5-yt-dlp-implementation-strategies)
6. [FFmpeg Processing Techniques](#6-ffmpeg-processing-techniques)
7. [Alternative Tools and Backup Methods](#7-alternative-tools-and-backup-methods)
8. [Coomer API Integration](#8-coomer-api-integration)
9. [Implementation Recommendations](#9-implementation-recommendations)
10. [Troubleshooting and Edge Cases](#10-troubleshooting-and-edge-cases)
11. [Conclusion](#11-conclusion)
---
## 1. Introduction
Coomer aggregates creator posts and exposes attachments via a public API. Downloads focus on attachments rather than stream manifests.
### 1.1 Research Scope
- Coomer creator and post API endpoints
- Attachment URLs under /data/
- Batch downloads via gallery-dl
### 1.2 Methodology
- Query API endpoints for post metadata
- Extract attachment URLs from JSON
- Download files directly with yt-dlp or aria2c
---
## 2. Coomer Video Infrastructure Overview
### 2.1 Video Hosting Types
- Direct file attachments (MP4, images)
### 2.2 CDN Architecture
- coomer.su (API and content)
- coomer.party (alternative mirror)
### 2.3 Video Processing Pipeline
1. Client requests API for creator posts
2. API returns attachment file paths
3. Client downloads files from /data/
### 2.4 Access Control and Authentication
- Public API endpoints
- Some services may require rate limiting
---
## 3. URL Patterns and Detection
### 3.1 Watch Page URL Patterns
```
https://coomer.su//user/
```
### 3.2 Embed URL Patterns
```
https://coomer.su/data//
```
### 3.3 Direct Media and CDN URL Patterns
```
https://coomer.su/data//.mp4
https://coomer.su/data//.jpg
```
### 3.4 Regex Patterns for URL Extraction
```regex
coomer\\.su/(?:\\w+)/user/(\\d+)
/data/[^\\s\\\"']+\\.(mp4|jpg|png)
```
### 3.5 Command-line URL Extraction
```bash
grep -oE "https?://coomer\\.su/data/[^'\" ]+\.(mp4|jpg|png)" data.json | sort -u
```
---
## 4. Stream Formats and CDN Analysis
### 4.1 Stream Formats
| Format | Extension | Notes |
|--------|-----------|-------|
| MP4 | .mp4 | Direct attachment downloads |
| Images | .jpg/.png | Gallery attachments |
### 4.2 Typical Quality Ladder
| Quality | Typical Resolution | Notes |
|---------|--------------------|-------|
| Low | 360p - 480p | Fast preview streams or mobile variants |
| Medium | 720p | Common default for web playback |
| High | 1080p+ | Available when source uploads are higher quality |
### 4.3 CDN URL Construction and Query Parameters
- Attachments are direct file URLs under /data/
- No HLS manifests observed
### 4.4 Validation and Inspection Commands
```bash
ffprobe -hide_banner -show_streams "file.mp4"
```
---
## 5. yt-dlp Implementation Strategies
yt-dlp can download direct MP4 URLs. For bulk, use gallery-dl or aria2c with URL lists.
### 5.1 Basic Usage
```bash
yt-dlp [OPTIONS] [--] URL [URL...]
yt-dlp -F "https://example.com/watch/123"
```
### 5.2 Authentication and Cookies
- Authentication generally not required for API access
### 5.3 Format Selection and Output Templates
```bash
yt-dlp -f bestvideo+bestaudio/best "URL"
yt-dlp -o "%(title)s.%(ext)s" "URL"
yt-dlp --download-archive archive.txt "URL"
```
### 5.4 Site-Specific Examples
```bash
yt-dlp "https://coomer.su/data//.mp4"
```
### 5.5 Batch and Archive Mode
```bash
yt-dlp -a urls.txt --download-archive archive.txt
yt-dlp --no-overwrites --continue "URL"
```
### 5.6 Error Handling Patterns
- Use --retries for intermittent 5xx responses
---
## 6. FFmpeg Processing Techniques
FFmpeg is only required for validation or remuxing if files are fragmented.
### 6.1 Inspect and Validate Streams
```bash
ffprobe -hide_banner -i "file.mp4"
```
### 6.2 Common Remux and Repair Patterns
```bash
ffmpeg -i "playlist.m3u8" -c copy output.mp4
ffmpeg -i input.mp4 -c copy -movflags +faststart output.mp4
ffprobe -hide_banner -show_streams output.mp4
```
---
## 7. Alternative Tools and Backup Methods
### 7.1 Streamlink
```bash
streamlink "https://coomer.su/data//.mp4" best -o output.mp4
```
### 7.2 aria2c
```bash
aria2c -i urls.txt -j 4
```
### 7.3 gallery-dl
```bash
gallery-dl "https://coomer.su//user/"
```
### 7.4 Browser DevTools
- Use API JSON to build URL lists
---
## 8. Coomer API Integration
### 8.1 Known Endpoints
- GET https://coomer.su/api/v1/creators
- GET https://coomer.su/api/v1//user//posts
### 8.2 Example Requests
```bash
curl https://coomer.su/api/v1//user//posts
```
### 8.3 Token and Session Handling
- Attachment paths returned in the JSON response
---
## 9. Implementation Recommendations
### 9.1 Detection Hierarchy
- Call API to list posts
- Extract attachment URLs
### 9.2 Site-Specific Notes
- Batch download attachments with gallery-dl
- Use download archive to prevent duplicates
### 9.3 Storage and Naming Strategy
- Group downloads by creator and post ID
---
## 10. Troubleshooting and Edge Cases
- Large creator libraries may require pagination
---
## 11. Conclusion
Coomer exposes direct file attachments via a public API. Implementations should query the API, extract attachment URLs, and download with gallery-dl, aria2c, or yt-dlp for MP4 files.
| Tool | Best Use Case | Notes |
|------|---------------|-------|
| yt-dlp | Primary downloader for MP4/HLS | Supports cookies, format selection, retries |
| ffmpeg | Remuxing and validation | Useful for HLS to MP4 conversion |
| streamlink | Live/HLS fallback | Streams to file or pipes into ffmpeg |
| aria2c | Multi-connection HTTP/HLS downloads | Good for large files and retries |
| gallery-dl | Image-first or gallery-heavy sites | Best for gallery or attachment extraction |
---
## Disclaimer and Ethical Use
This document is provided for lawful, personal, or authorized use cases only. Always respect the site terms of service, content creator rights, and applicable laws. If DRM or explicit access controls are present, do not attempt to bypass them; use official downloads or creator-provided access instead.
## Last Updated
December 2025
## Next Review
90 days from last update or when site playback changes are observed.
## Related
- SERP Apps research index (internal)
- SERP extension downloaders (internal)