Limpiador y Organizador de Descargas Inteligente

Una herramienta que monitorea tu carpeta de Descargas y organiza automáticamente los archivos según su tipo.

🚀 Características

• Monitoreo en tiempo real: Detecta nuevos archivos en la carpeta de Descargas
• Organización automática: Mueve archivos a carpetas según su extensión
• Interfaz web: Panel de control para configurar reglas y categorías
• Historial: Registro de todos los archivos organizados
• Reglas personalizables: Define tus propias categorías y extensiones

📋 Requisitos

• Python 3.8+
• pip (gestor de paquetes de Python)

🔧 Instalación

1. Crear y activar un entorno virtual (recomendado):

# Windows
python -m venv venv
venv\Scripts\activate

# Linux/Mac
python3 -m venv venv
source venv/bin/activate

2. Instalar dependencias:

pip install -r requirements.txt

3. Ejecutar migraciones de base de datos:

python manage.py migrate

4. Cargar datos iniciales (categorías y reglas predefinidas):

python setup_inicial.py

5. (Opcional) Crear usuario administrador:

python manage.py createsuperuser

🖥️ Uso

Iniciar el servidor web (interfaz de configuración)

python manage.py runserver

Abre tu navegador en: http://localhost:8000

Iniciar el monitor de descargas

En una terminal separada:

python manage.py monitor

El monitor se ejecutará en segundo plano observando la carpeta de Descargas.

📁 Estructura del proyecto

limpiador_descargas/
├── manage.py                 # Script de gestión de Django
├── requirements.txt          # Dependencias del proyecto
├── setup_inicial.py          # Script para cargar datos iniciales
├── limpiador_descargas/      # Configuración del proyecto Django
│   ├── settings.py
│   ├── urls.py
│   └── wsgi.py
├── organizador/              # Aplicación principal
│   ├── models.py             # Modelos de datos
│   ├── views.py              # Vistas web
│   ├── urls.py               # URLs de la aplicación
│   ├── services.py           # Servicio de monitoreo (watchdog)
│   ├── admin.py              # Panel de administración
│   └── management/
│       └── commands/
│           └── monitor.py    # Comando para ejecutar el monitor
└── templates/                # Plantillas HTML
    ├── base.html
    └── organizador/
        ├── dashboard.html
        ├── configuracion.html
        ├── categorias.html
        ├── reglas.html
        └── historial.html

🎯 Categorías predefinidas

Categoría	Extensiones	Destino
🖼️ Imágenes	jpg, png, gif, webp, svg...	~/Pictures
📄 Documentos	pdf, doc, docx, xls, xlsx, csv, txt, md...	~/Documents
💿 Instaladores	exe, msi, dmg, deb...	~/Downloads/Instaladores
📦 Comprimidos	zip, rar, 7z, tar, gz...	~/Downloads/Comprimidos
🎵 Música	mp3, wav, flac, aac...	~/Music
🎬 Videos	mp4, mkv, avi, mov...	~/Videos
💻 Código	py, js, html, css, json...	~/Downloads/Codigo
🐟 Mermaids	mmd, mermaid...	~/Downloads/Mermaids
📋 Logs	log	~/Downloads/Log

⚙️ Configuración

Desde la interfaz web puedes:

1. Cambiar la carpeta monitoreada: Configura qué carpeta observar
2. Crear categorías: Define nuevas categorías con sus carpetas destino
3. Agregar reglas: Asocia extensiones de archivo a categorías
4. Ver historial: Consulta el registro de archivos organizados
5. Controlar el monitor: Inicia/detén el monitoreo desde el panel

🔒 Notas de seguridad

• Esta herramienta está diseñada para uso local
• No expongas el servidor Django a internet sin las configuraciones de seguridad adecuadas
• Los archivos se mueven (no copian) a sus destinos

📝 Licencia

MIT License - Libre para uso personal y comercial.