Una herramienta de escritorio moderna, ultrarrápida y segura construida con Python y Flet (Flutter Engine) con diseño en modo oscuro y acentos en #f40048.
Explorar Funciones • Descargar Binarios • Instalación Local • Guía de Uso • Arquitectura
Tip
Seguridad ante todo: Ninguna operación modifica archivos físicos en disco sin tu confirmación previa. FilesPy detecta colisiones de nombre en tiempo real y permite revertir cualquier lote con un solo clic mediante su motor de transacciones atómicas.
- ✨ Descripción General
- ⚡ Características Principales
- 1. Renombrado por Lotes Potente
- 2. Organización Inteligente en Carpetas
- 3. Previsualización y Detección de Colisiones
- 4. Inspector Integrado de Archivos
- 5. Detección Criptográfica de Duplicados
- 6. Sistema de Deshacer Atómico
- 7. Organización Manual y Nombrado Híbrido
- 8. Configuración Dinámica y Filtros
- 📥 Instaladores y Descargas
- 🚀 Inicio Rápido
- 📖 Guía de Uso
- 🏗️ Arquitectura del Sistema
- 📁 Estructura del Proyecto
- 🛠️ Compilación Local de Instaladores
- 🔄 CI/CD Automatizado
- 📄 Licencia
FilesPy es una solución de escritorio concebida para poner orden en el caos de archivos. Diseñada meticulosamente con un enfoque visual moderno en modo oscuro, ofrece la fluidez del motor Flutter a través de Flet junto con la potencia y flexibilidad de Python 3.
Resuelve de forma eficiente tres de las tareas más comunes y propensas a errores en cualquier sistema operativo:
- Renombrar cientos de archivos aplicando reglas complejas (regex, numeración, capitalización).
- Organizar estructuras caóticas clasificándolas por formato, categorías temáticas o fechas.
- Identificar y depurar archivos duplicados mediante huellas hash SHA-256 sin importar su nombre.
|
|
|
|
|
|
|
|
FilesPy cuenta con paquetes autocontenidos para los principales sistemas operativos, listos para usar sin necesidad de instalar Python ni librerías adicionales:
| Sistema Operativo | Paquete / Formato | Arquitectura | Descripción | Enlace |
|---|---|---|---|---|
FilesPy-Windows-Setup.exeo versión portable .zip |
x64 |
Asistente de instalación Inno Setup con accesos directos al Menú Inicio y Escritorio. | Descargar | |
FilesPy-macOS.dmgo .zip portable |
Universal / x64 / arm64 |
Imagen de disco .dmg con ventana de instalación arrastrar-y-soltar a /Applications. |
Descargar | |
FilesPy-Linux-x64.tar.gz |
x64 |
Paquete portable con lanzador install.sh y acceso de escritorio .desktop. |
Descargar |
Note
Accede al historial completo de versiones y notas de versión en GitHub Releases.
Si prefieres ejecutar FilesPy directamente desde el código fuente o contribuir al proyecto:
- Python 3.10+ instalado en tu sistema.
- Gestor de paquetes
pipy soporte para entornos virtuales (venv).
git clone https://github.com/Mad065/FilesPy.git
cd FilesPy<!-- slide -->
##### En macOS / Linux
```bash
python3 -m venv .venv
source .venv/bin/activate
```
<!-- slide -->
##### En Windows (PowerShell / CMD)
```cmd
python -m venv .venv
.venv\Scripts\activate
```
pip install -r requirements.txtpython main.pyEl flujo de trabajo en FilesPy está pensado para ser visual, rápido e intuitivo:
[ 1. Explorar Carpeta ] ──▶ [ 2. Configurar Reglas ] ──▶ [ 3. Verificar en Vivo ] ──▶ [ 4. Aplicar Cambios ]
│
(¿Necesitas volver atrás?)
▼
[ 5. Botón Deshacer ]
- 📁 Cargar Directorio:
Haz clic en
Explorar...y selecciona la carpeta a procesar. Activa la casillaSubcarpetassi deseas escanear recursivamente. - ⚙️ Seleccionar Modo de Operación:
- Pestaña Renombrar: Configura prefijos, sufijos, reemplazo de caracteres, numeración o formato de mayúsculas/minúsculas.
- Pestaña Organizar: Elige si deseas ordenar por extensión, categoría o fecha (año/mes).
- Pestaña Duplicados: Ejecuta el escaneo por hash SHA-256 para detectar copias redundantes y aislarlas.
- 👀 Comprobación Visual:
Revisa la tabla central interactiva. Las filas se colorean dinámicamente:
- 🟢 Verde: Operación lista y válida sin conflictos.
- 🔴 Rojo: Alerta de colisión (el archivo ya existe en destino o dos archivos recibirían el mismo nombre).
- 🖼️ Inspección de Detalles: Toca cualquier archivo en la tabla para ver su miniatura (en imágenes) o extracto de texto en el panel lateral derecho.
- 🚀 Aplicar Operaciones:
Pulsa en
Aplicar Cambiospara ejecutar las acciones en el disco de forma segura. - ↩️ Reversión Inmediata:
¿Cambio inesperado o error involuntario? Presiona el botón
Deshacery todos los archivos volverán exactamente a su estado y ubicación anterior.
FilesPy sigue una arquitectura desacoplada y reactiva en tres capas bien diferenciadas:
flowchart TD
subgraph UI["💻 Capa de Presentación (Flet / Flutter Engine)"]
FB["FolderBar\nRuta y Filtros"]
Tabs["Paneles Principales\n(Renombrar | Organizar | Duplicados)"]
PT["PreviewTable\nGrid Reactivo de Comparación"]
IP["FileInspector\nMiniaturas (Pillow) y Metadatos"]
AB["ActionBar\nBotones de Aplicar y Deshacer"]
SD["Settings & Review Dialogs\nModales Interactivos"]
end
subgraph Core["🧠 Capa de Negocio (Core Engines)"]
CFG["ConfigManager\nsettings.json y Categorías"]
SCN["DirectoryScanner\nDescubrimiento y Filtros"]
REN["RenamerEngine\nRegex, Prefijos, Formato"]
ORG["OrganizerEngine\nExtensión, Fecha, Tipo"]
CON["ConflictDetector\nValidación y Colisiones"]
DUP["DuplicateFinder\nHashes Criptográficos SHA-256"]
UND["UndoManager\nTransacciones Atómicas y Rollback"]
end
subgraph FS["💾 Almacenamiento Local"]
Disk["Sistema de Archivos en Disco"]
end
FB --> SCN
Tabs --> REN & ORG & DUP
SCN --> Core
REN & ORG --> CON
CON --> PT
PT --> IP
AB --> UND
UND --> Disk
CFG -.-> Tabs
SD -.-> CFG
FilesPy/
├── main.py # Punto de entrada de la aplicación
├── requirements.txt # Dependencias del proyecto (flet, pillow)
├── settings.json # Configuración persistente del usuario
├── .gitignore # Exclusiones de Git
├── README.md # Documentación principal
├── assets/ # Recursos visuales y gráficos
│ └── icons/ # Iconos vectoriales y ejecutables (.ico, .icns, .png)
├── core/ # Módulos de lógica de negocio y motores
│ ├── config_manager.py # Gestión y persistencia de configuración JSON
│ ├── conflicts.py # Detección de colisiones y validación de rutas
│ ├── duplicates.py # Localización de duplicados por hash SHA-256
│ ├── models.py # Modelos de datos (dataclasses tipados)
│ ├── organizer.py # Clasificación por extensión, categoría o fecha
│ ├── renamer.py # Motor de transformaciones de nombres
│ ├── scanner.py # Explorador de directorios con filtros
│ └── undo.py # Pila de transacciones y operaciones reversibles
├── ui/ # Capa visual moderna (Flet)
│ ├── app.py # Ventana principal y pipeline reactivo
│ ├── theme.py # Constantes de diseño, paleta y formateadores
│ └── components/ # Componentes visuales desacoplados
│ ├── action_bar.py # Barra de botones de acción (Aplicar, Deshacer)
│ ├── duplicate_panel.py # Panel de análisis y aislamiento de duplicados
│ ├── folder_bar.py # Barra de ruta, subcarpetas y configuración
│ ├── inspector_panel.py # Panel lateral de miniaturas y metadatos
│ ├── manual_organize_dialog.py # Diálogo de clasificación y nombrado híbrido
│ ├── organize_panel.py # Formulario de modos de organización
│ ├── preview_table.py # Tabla interactiva con verificación visual
│ ├── rename_panel.py # Formulario de reglas de renombrado
│ ├── settings_dialog.py # Modal de edición de categorías y preferencias
│ └── step_review_dialog.py# Revisión paso a paso interactiva
├── packaging/ # Empaquetado multiplataforma
│ ├── FilesPy.spec # Especificación PyInstaller
│ ├── FilesPy.desktop # Lanzador para entornos de escritorio Linux
│ ├── inno_setup.iss # Script de instalación para Windows (Inno Setup)
│ └── icon_generator.py # Generador de iconos .ico / .icns / .png
└── scripts/ # Scripts de compilación automatizada
├── build_macos.sh # Generador de .app y .dmg para macOS
├── build_windows.bat # Generador de .exe y Setup para Windows
└── build_linux.sh # Generador de .tar.gz y .desktop para Linux
Si deseas compilar los binarios e instaladores de forma manual en tu máquina:
# 🍏 En macOS:
chmod +x scripts/build_macos.sh && ./scripts/build_macos.sh
# Salida: dist/FilesPy.app, installer_output/FilesPy-macOS.dmg y .zip
# 🪟 En Windows:
scripts\build_windows.bat
# Salida: dist\FilesPy\FilesPy.exe, installer_output\FilesPy-Windows-Setup.exe y .zip
# 🐧 En Linux:
chmod +x scripts/build_linux.sh && ./scripts/build_linux.sh
# Salida: installer_output/FilesPy-Linux-x64.tar.gz con script install.shFilesPy cuenta con un pipeline de integración y despliegue continuo mediante GitHub Actions (.github/workflows/build-installers.yml):
- 🏷️ Disparo Automático: Se activa ante cualquier nueva etiqueta de versión (
v*) o mediante ejecución manual (workflow_dispatch). - ⚡ Compilación Concurrente: Construye los instaladores simultáneamente en runners nativos de Windows, macOS y Linux.
- 📦 Publicación en Releases: Empaqueta los binarios e instaladores y los adjunta automáticamente a la sección de lanzamientos de GitHub.
Este proyecto está distribuido bajo la licencia MIT. Para más detalles, consulta el archivo LICENSE.
⬆ Volver al inicio