FolderOrganizer

Organiza tus archivos automáticamente en Windows y Linux.

Aplicación ligera y de código abierto que clasifica automáticamente tus archivos mediante reglas configurables en Windows y Linux.

🇺🇸 English | 🇲🇽 Español

⬇ Descargar última versión · 📖 Instalación · 💖 Sponsor

---

✨ ¿Qué es FolderOrganizer?

Cuando descargamos archivos desde internet, chats o correos electrónicos, es común que todo termine acumulándose en una sola carpeta, como Descargas.

Con el tiempo, encontrar documentos, imágenes, instaladores o archivos importantes se vuelve cada vez más complicado.

FolderOrganizer automatiza esta tarea supervisando el directorio que configures y moviendo los archivos hacia carpetas clasificadas según sus extensiones y las reglas que hayas definido.

Puede ejecutarse:

• 🔄 Automáticamente como Servicio de Windows o mediante systemd en Linux.
• 💻 Manualmente cuando necesites organizar tus archivos.
• ⚙️ Con una estructura predeterminada.
• 🛠️ Con reglas personalizadas.

---

🎬 Mira cómo funciona

---

👀 Antes y después

Antes

Descargas/
├── archivo.zip
├── fotografia.jpg
├── documento.docx
├── notas.txt
├── setup_installer.exe
├── reporte.xlsx
├── desconocido.file
├── Windows10.iso
├── datos.json
├── factura.pdf
├── presentacion.pptx
└── script.js

Después

Descargas/
├── zip o rar/
├── Imagenes/
├── Word/
├── Texto/
├── Ejecutables/
├── Excel/
├── Otros/
├── ISO/
├── JSON/
├── PDF/
├── Presentaciones/
└── Scripts/

El ejemplo refleja las categorías predeterminadas de FolderOrganizer. Con reglas personalizadas, la estructura final puede adaptarse a las carpetas y extensiones que prefieras.

---

⭐ Características

• 📁 Organización automática de archivos.
• ⚙️ Reglas configurables.
• 🗂️ Clasificación mediante extensiones de archivo.
• 🔄 Ejecución automática mediante Servicio de Windows.
• 💻 Ejecución manual cuando se requiera.
• 🧙 Asistente interactivo de configuración.
• 🗣️ Selección de idioma.
• 💾 Reutilización de configuraciones anteriores.
• 📦 Instalador validado para Windows y runtime compatible con Linux.
• 🔓 Código abierto.

---

📥 Instalación rápida

Windows

La instalación recomendada y validada para v1.2.0 es el instalador oficial para Windows disponible en GitHub Releases.

1. Ve a Releases.
2. Descarga FolderOrganizer_Installer.exe.
3. Ejecuta el instalador.
4. Sigue el asistente de instalación.
5. Abre FolderOrganizer desde el menú Inicio de Windows.

⬇ Descargar la última versión

[!NOTE] Permisos de Administrador: FolderOrganizer requiere privilegios de administrador para registrar o administrar el Servicio de Windows cuando esta opción sea utilizada.

Una vez concluida la instalación, busca FolderOrganizer dentro del menú Inicio de Windows.

La aplicación interactiva se ejecuta con permisos normales de usuario. La elevación de administrador se solicita únicamente cuando FolderOrganizer necesita registrar o administrar el Servicio de Windows.

Linux

El código incluye soporte para Linux y ejecución mediante systemd, pero todavía no ha completado el mismo nivel de validación en entornos reales que el instalador de Windows. Para v1.2.0, Windows continúa siendo la distribución principal validada.

---

⚙️ Configuración

FolderOrganizer incluye un asistente que permite configurar cómo deseas organizar tus archivos.

🗣️ Selección de idioma

Selecciona tu idioma de preferencia para realizar la configuración.

El sistema permite elegir entre:

• Por defecto: utiliza una estructura de organización predefinida.
• Personalizada: permite seleccionar las carpetas y extensiones que deseas utilizar.

📁 Configuración por defecto

La configuración predeterminada muestra las carpetas estándar que serán generadas junto con las extensiones de archivo que FolderOrganizer utilizará para clasificar los archivos automáticamente.

🛠️ Configuración personalizada

La configuración personalizada permite especificar qué carpetas y extensiones deben formar parte del proceso de organización.

Al finalizar cualquiera de los dos flujos, FolderOrganizer solicitará confirmar la configuración antes de guardar las preferencias.

---

🔄 Automatización con Servicio de Windows

La forma recomendada de utilizar FolderOrganizer es mediante un Servicio de Windows.

Cuando el servicio está activo, FolderOrganizer trabaja silenciosamente en segundo plano y organiza automáticamente los archivos que llegan al directorio configurado.

Una vez creado correctamente, la consola mostrará un mensaje de confirmación.

[!TIP] Utilizar el Servicio de Windows permite automatizar completamente el proceso y evita tener que ejecutar FolderOrganizer manualmente.

Puedes verificar el estado del servicio desde la herramienta Servicios de Windows. El servicio aparece con el nombre:

FolderOrganizer

---

💻 Ejecución manual

Si prefieres no instalar el Servicio de Windows, FolderOrganizer también puede ejecutarse manualmente.

Durante la configuración selecciona que no deseas crear el servicio. La aplicación preguntará si deseas ejecutar la organización de archivos en ese momento.

---

📝 Configuración previa

A partir de la segunda ejecución, FolderOrganizer detectará si existe una configuración previa.

Puedes continuar utilizando la configuración existente o crear una nueva configuración.

Si necesitas modificar las reglas de organización, selecciona n para iniciar nuevamente el asistente.

---

👨‍💻 Para desarrolladores

FolderOrganizer es un proyecto de código abierto. Puedes revisar el código, modificarlo y generar tu propio instalador.

🔧 Generar el instalador

Necesitarás:

• Node.js
• Inno Setup 6

Desde la raíz del proyecto ejecuta:

pnpm run build:installer

El proceso prepara los archivos en:

dist/FolderOrganizer-build

y genera el instalador en:

dist/FolderOrganizer-Installer/FolderOrganizer_Installer.exe

Si Inno Setup está instalado en una ruta personalizada, define previamente ISCC_PATH:

$env:ISCC_PATH = 'C:\ruta\a\ISCC.exe'
pnpm run build:installer

---

🛠️ Tecnologías utilizadas

Lógica y Core

• Node.js — entorno de ejecución de JavaScript.
• Inquirer — asistente interactivo para la configuración mediante consola.
• node-windows — integración e instalación del proceso como Servicio de Windows.
• systemd — integración del servicio en segundo plano para Linux.
• Color — formato visual de la interfaz CLI.
• ESLint — control de calidad del código.
• cross-env — gestión de variables de entorno.

Empaquetado

• Inno Setup Compiler — generación del instalador para Windows.
• Inkscape — utilizado para la creación del icono de FolderOrganizer.

---

🗺️ Roadmap

Las prioridades de desarrollo y mejoras planeadas se encuentran en ROADMAP.md. El historial de versiones está disponible en CHANGELOG.md.

El código incluye soporte para Linux, pero Windows continúa siendo la distribución principal validada para v1.2.0.

---

🤝 Contribuir

Las contribuciones son bienvenidas.

Si deseas reportar un error, proponer una funcionalidad o colaborar con código, consulta nuestra guía de contribución.

También puedes apoyar el proyecto dejando una ⭐ en el repositorio.

---

💖 Apoya el proyecto

FolderOrganizer es una herramienta de código abierto desarrollada y mantenida de forma independiente.

Si la aplicación te resulta útil y deseas apoyar su mantenimiento y el desarrollo de nuevas funcionalidades:

• ☕ Apóyame en Ko-fi
• 💗 Conviértete en Sponsor en GitHub

Tu apoyo ayuda al mantenimiento, corrección de errores, documentación y desarrollo de nuevas funcionalidades.

---

📄 Licencia

FolderOrganizer se distribuye bajo la licencia MIT.

Consulta el archivo LICENSE para más información.

---

Desarrollado por FrEaKAlL.

Si FolderOrganizer te resulta útil, considera dejar una ⭐ en el repositorio.