Initial commit: Manga Mass Downloader Chrome Extension
✨ Features: - Multi-selection checkboxes on manga listings - Batch download selected manga or all manga from page - Optimized parallel downloading (20ms delays, 5 concurrent) - Visual progress tracking - Popup UI for easy control - Fixed duplicate checkbox issue with deduplication logic 📁 Files: - manifest.json: Extension configuration - content.js: Checkbox injection & manga detection - background.js: Optimized download engine - popup.html/js: User interface - README.md: Complete documentation
This commit is contained in:
107
README.md
Normal file
107
README.md
Normal file
@@ -0,0 +1,107 @@
|
||||
# Manga Mass Downloader
|
||||
|
||||
Chrome Extension para descarga masiva de manga desde listados de e-hentai.org
|
||||
|
||||
## ✨ Características
|
||||
|
||||
- ✅ **Selección múltiple**: Agrega checkboxes a cada miniatura de manga
|
||||
- ✅ **Descarga individual**: Selecciona 5-10 manga y descárgalos uno por uno
|
||||
- ✅ **Descarga masiva**: Descarga TODOS los manga de una página de una vez
|
||||
- ✅ **Basado en addon optimizado**: Utiliza el motor de descarga paralelo ultra-rápido
|
||||
- ✅ **Barra de progreso**: Visualiza el progreso en tiempo real
|
||||
- ✅ **Interfaz intuitiva**: Popup con controles fáciles de usar
|
||||
|
||||
## 🚀 Cómo usar
|
||||
|
||||
### 1. Instalación
|
||||
- Ve a `chrome://extensions/`
|
||||
- Activa "Modo de desarrollador"
|
||||
- Carga la carpeta del addon
|
||||
|
||||
### 2. Seleccionar Manga
|
||||
- Ve a https://e-hentai.org/?f_cats=1019&f_search=spanish (o cualquier listado)
|
||||
- Las miniaturas tendrán un checkbox "Descargar" en la esquina superior izquierda
|
||||
- Haz clic para seleccionar los manga que quieres
|
||||
- Usa el botón "Seleccionar Todos" en la esquina inferior izquierda
|
||||
|
||||
### 3. Descargar
|
||||
- Haz clic en el ícono del addon en la barra de herramientas
|
||||
- **Opción 1**: "Descargar Seleccionados" - Descarga solo los marcados
|
||||
- **Opción 2**: "Descargar TODOS de la Página" - Descarga todos los manga visibles
|
||||
- **Opción 3**: "Limpiar Selección" - Deselecciona todo
|
||||
|
||||
## 📁 Estructura del proyecto
|
||||
|
||||
```
|
||||
mass-downloader/
|
||||
├── manifest.json # Configuración de la extensión
|
||||
├── content.js # Content script para detectar miniaturas
|
||||
├── background.js # Service worker para descargas (optimizado)
|
||||
├── popup.html # Interfaz del popup
|
||||
├── popup.js # Lógica del popup
|
||||
├── jszip.min.js # Librería para crear archivos ZIP
|
||||
└── README.md # Este archivo
|
||||
```
|
||||
|
||||
## 🎯 Funcionamiento
|
||||
|
||||
### Content Script (`content.js`)
|
||||
- Detecta miniaturas de manga en la página
|
||||
- Agrega checkboxes interactivos
|
||||
- Extrae metadata (título, ID, token, URL)
|
||||
- Permite selección múltiple
|
||||
|
||||
### Background Script (`background.js`)
|
||||
- Descarga imágenes en lotes paralelos (5 simultáneas)
|
||||
- Delay fijo de 20ms entre descargas
|
||||
- Crea archivos ZIP optimizados
|
||||
- Basado en el addon original ultra-optimizado
|
||||
|
||||
### Popup (`popup.html` + `popup.js`)
|
||||
- Contador de manga seleccionados
|
||||
- 3 botones principales de descarga
|
||||
- Barra de progreso visual
|
||||
- Feedback de estado en tiempo real
|
||||
|
||||
## ⚡ Optimizaciones
|
||||
|
||||
- **Velocidad extrema**: Descarga en paralelo con delays mínimos
|
||||
- **Rate limiting controlado**: 20ms delay fijo
|
||||
- **Validación robusta**: Filtra imágenes válidas
|
||||
- **Compresión ZIP**: Nivel 6 DEFLATE para mejor ratio
|
||||
- **Nombres limpios**: Sanitización de títulos
|
||||
|
||||
## 🔧 Diferencias con el addon original
|
||||
|
||||
| Característica | Manga Downloader | Manga Mass Downloader |
|
||||
|---|---|---|
|
||||
| **Página objetivo** | Páginas de galería (`/g/`) | Listados de manga |
|
||||
| **Selección** | Un manga a la vez | Múltiples manga |
|
||||
| **Descarga** | Individual | Individual y masiva |
|
||||
| **UI** | Botón flotante | Popup + checkboxes |
|
||||
| **Scope** | Manga específico | Lista de manga |
|
||||
|
||||
## 📝 Notas
|
||||
|
||||
- Solo funciona en e-hentai.org y exhentai.org
|
||||
- Requiere credenciales de sesión (cookie de login)
|
||||
- Cada descarga abre un diálogo de "Guardar como"
|
||||
- Las descargas se procesan secuencialmente para evitar saturar el servidor
|
||||
|
||||
## 🐛 Solución de problemas
|
||||
|
||||
**No aparecen los checkboxes:**
|
||||
- Recarga la página
|
||||
- Verifica que estés en una página de listado (no en `/g/`)
|
||||
|
||||
**Error al descargar:**
|
||||
- Verifica que estés logueado en e-hentai
|
||||
- Revisa la consola (F12) para logs detallados
|
||||
|
||||
**Descarga muy lenta:**
|
||||
- Es normal, se procesa secuencialmente
|
||||
- Las primeras descargas tardan más
|
||||
|
||||
## 📄 Licencia
|
||||
|
||||
MIT License - Uso personal
|
||||
Reference in New Issue
Block a user