Español | English

DeskMate 🚀

DeskMate es una herramienta diseñada para mantener tu escritorio organizado automáticamente. Clasifica y mueve archivos a carpetas predefinidas según su tipo, y registra todas estas acciones en un archivo de texto (log) para que siempre tengas un historial detallado de la organización de tu espacio de trabajo.

Demostración

Aquí puedes ver la herramienta en acción a través de GIFs y capturas de pantalla.

GIF de la Herramienta en Funcionamiento

Una rápida demostración del flujo de trabajo principal de DeskMate, mostrando sus características clave.

Capturas de Pantalla Clave

Escritorio desordenado.

Ejecutamos la herramienta para ordenar el escritorio.

Una vez confirmada la ejecución de la herramienta veremos el escritorio ordenado.

Logs generados por la herramienta.

---

📝 Funcionamiento de DeskMate

El uso de DeskMate es directo y se centra en la interacción inicial para comenzar la organización de tu espacio digital.

1. Iniciar la Aplicación: Ejecuta DeskMate.py (o DeskMate.exe si has generado el ejecutable) desde tu terminal o haciendo doble clic, según tu sistema.

   # Para ejecutar desde script Python
   python3 DeskMate.py

2. Confirmar Operación: Al iniciar, la herramienta te solicitará confirmación para proceder con los cambios. Es crucial que aceptes para que DeskMate pueda comenzar su tarea de organización.

3. Resultado de la Organización: Una vez confirmada la ejecución, DeskMate procederá a:

   • Clasificar tu Escritorio: Moverá los archivos a sus respectivas carpetas predefinidas.
   • Generar Archivos de Registro: Creará y actualizará los archivos de texto (log) que detallan todas las acciones realizadas, proporcionando un historial completo de la limpieza de tu escritorio.

De esta manera, tu escritorio quedará ordenado y tendrás un registro accesible de cada acción de organización.

Características

• Organización Automática: Clasifica y mueve archivos del escritorio a carpetas designadas según su tipo (ej., documentos, imágenes, ejecutables).
• Registro Detallado (Log): Genera un archivo de texto (log) con el historial completo de todos los movimientos y acciones realizadas, permitiendo un seguimiento preciso.
• Compatibilidad: Optimizada para entornos Windows x64.

Estructura del Proyecto

Este repositorio contiene la herramienta DeskMate y sus archivos asociados.

DeskMate/
├── DeskMate.py
├── DeskMate.spec
├── README.md
└── README.en.md

---

Documentación Adicional

Aquí encontrarás información más detallada sobre el proyecto:

• 🤝 Código de Conducta - Normas para una comunidad respetuosa.
• 📬 Cómo Contribuir - Pasos para colaborar con el proyecto.
• 🔐 Seguridad - Información sobre cómo reportar vulnerabilidades.
• ⚠️ Aviso Legal - Cláusulas y advertencias legales importantes.
• 📢 Soporte - Dónde obtener ayuda o hacer preguntas.

---

🚀 Guía Rápida de Uso e Instalación

# PASOS GENERALES PARA OBTENER EL PROYECTO
git clone https://github.com/D4rkh45h/DeskMate.git
cd DeskMate

# CONFIGURACIÓN DEL ENTORNO VIRTUAL (OPCIONAL, PERO RECOMENDADO)
# Para Windows:
# python -m venv venv
# .\venv\Scripts\activate
#
# Para Linux:
# python3 -m venv venv
# source venv/bin/activate

# --- OPCIONES DE EJECUCIÓN ---

# 🪟 PARA USUARIOS DE WINDOWS (x64):
# Instalación de PyInstaller y Generación del Ejecutable .exe
pip install pyinstaller
pyinstaller --clean --onefile --noconsole --version-file=version.txt --icon=deskmate.ico DeskMate.py
# El ejecutable compilado estará disponible en: DeskMate/dist/DeskMate/DeskMate.exe

# 🐧 PARA USUARIOS DE LINUX:
# Instalación de Dependencias y Ejecución del Script
pip install -r requirements.txt
python3 DeskMate.py