RenameForge Files

# 🛠️ RenameForge v1.0008

## 📌 Descripción
**RenameForge** es una herramienta de escritorio gratuita para renombrar archivos en lote de forma rápida y flexible. Ideal para organizar fotos, documentos o cualquier tipo de archivo, permite aplicar formatos personalizados con variables como fechas, eventos y numeración, todo desde una interfaz gráfica intuitiva. Disponible en Español e Inglés.

## ✨ Características principales
- 🔁 Renombrado masivo: Procesa todos los archivos de una carpeta (y sus subcarpetas).
- 🧩 Formato personalizado: Usa plantillas como `{evento}_{fecha}_{n}` para generar nombres únicos.
- 🔤 Transformación de texto: Convierte nombres a mayúsculas, minúsculas o capitalización.
- 📂 Soporte para subcarpetas: Renombra archivos dentro de estructuras de carpetas.
- 👀 Vista previa en tiempo real: Verifica los nuevos nombres antes de aplicar cambios.
- 📝 Historial de cambios: Guarda un registro en texto plano de los renombrados realizados.
- 🧽 Filtrado por extensión: Trabaja solo con tipos específicos (.jpg, .png, .pdf, etc.).
- 🌐 Interfaz multilingüe: Español e Inglés.
- 💸 Donaciones opcionales: Apoya el desarrollo vía PayPal o escaneando el QR incluido.

## 🖥️ Requisitos
- Sistema operativo: Windows, Linux o macOS.
- Permisos: Ejecutar como administrador (Windows) o usar `sudo` (Linux/macOS) si es necesario.
- Dependencias: Python 3.x + PyQt5 (solo si se usa el código fuente).
- Extras: Incluye `qr_donacion.png` para facilitar las donaciones.

## 📦 Instalación

### 🔹 Ejecutable (.exe)
- Descarga el `.exe` desde el repositorio oficial.
- En Windows, hacé clic derecho y seleccioná “Ejecutar como administrador” si se solicita.

### 🔹 Código fuente
```bash
pip install PyQt5
python renameforge.py
# En Linux/macOS:
sudo python3 renameforge.py
🚀 Cómo usar
- Abrí la aplicación.
- Seleccioná la carpeta con los archivos a renombrar.
- Configurá las opciones:
- Nombre base (ej. “Evento”).
- Fecha y formato (ej. yyyy-MM-dd).
- Plantilla (ej. {fecha}_{evento}_{n}).
- Separador (guión, espacio, etc.).
- Opcional: filtrado por extensión, incluir subcarpetas, guardar en nueva carpeta.
- Activá la vista previa.
- Hacé clic en “Renombrar”.
- (Opcional) Activá el historial para guardar los cambios.
🖼️ Ejemplo práctico
- Carpeta: C:\Fotos\Evento2025
- Evento: Boda
- Formato: {fecha}_{evento}_{n}
- Fecha: 2025-08-14
- Resultado:
2025-08-14_Boda_001.jpg
2025-08-14_Boda_002.jpg
2025-08-14_Boda_003.jpg
⚠️ Notas importantes
- Asegurate de tener permisos de escritura.
- Se eliminan caracteres no válidos (< > : " / \ | ? *).
- Si el nombre ya existe, se agrega un sufijo automático (ej. _1).
- Las donaciones son opcionales y ayudan a mantener el proyecto activo.
👤 Autor
- Nombre: Adrián Piscoya
- Contacto: adrianpiscoya51@gmail.com
💖 Donaciones
RenameForge es gratuito, pero si te resulta útil, podés apoyar su desarrollo:
🔗 Donar vía PayPal
📱 Escaneá el código QR en la pestaña “Apoyar” de la app.
📄 Licencia
Este proyecto es de código abierto y se distribuye bajo la licencia MIT.