🔓 Unlock PDFs GUI – Quitar contraseña a PDFs

Este proyecto permite seleccionar uno o varios archivos PDF protegidos con contraseña y generar copias desbloqueadas mediante una interfaz gráfica sencilla desarrollada con tkinter.

---

✅ Requisitos

• Python 3.8 o superior.
• Instalar dependencias necesarias:

pip install PyPDF2

tkinter ya viene incluido con Python por defecto.

---

▶️ Ejecutar la aplicación manualmente

Desde la raíz del proyecto, ejecuta:

python app.py

Esto abrirá una ventana para:

• Seleccionar uno o varios archivos PDF.
• Ingresar la contraseña común.
• Guardar los archivos desbloqueados en la carpeta pdfs_unlocked.

---

📁 Estructura del proyecto

unlock_pdfs/
├── main.py
├── services/
│   └── pdf_service.py
├── utils/
│   └── file_utils.py

---

🛠️ Crear ejecutable .exe (Windows)

1. Instalar PyInstaller

pip install pyinstaller

2. Crear el ejecutable

pyinstaller --onefile --noconsole main.py

Esto generará el archivo:

dist/main.exe

Puedes renombrarlo si deseas, por ejemplo: DesbloquearPDFs.exe.

---

🖼️ (Opcional) Agregar icono personalizado

Asegúrate de tener un archivo .ico (por ejemplo: icono.ico) y ejecuta:

pyinstaller --onefile --noconsole --icon=icono.ico main.py

---

📂 Carpeta de salida

Los archivos desbloqueados se guardan automáticamente en:

pdfs_unlocked/

---

ℹ️ Notas adicionales

• El script asume que todos los archivos seleccionados tienen la misma contraseña.
• Si deseas desbloquear PDFs con contraseñas distintas, puedes modificar la lógica para pedir la contraseña archivo por archivo.

---

🧑‍💻 Autor

Desarrollado por marjuz | Mario Juez

---

⚙️ Guía para instalación y configuración del entorno

Este proyecto utiliza pip-tools para gestionar dependencias. Sigue estos pasos para configurar el entorno e instalar los paquetes necesarios.

---

📌 Requisitos previos

• Python 3.8 o superior: Descargar Python
• pip: Gestor de paquetes de Python (viene incluido con Python 3.4+).

---

🔧 Pasos para instalar paquetes

1. Clonar el repositorio

git clone https://github.com/tu-usuario/tu-repositorio.git
cd tu-repositorio

2. Ejecutar el script de configuración

Este proyecto incluye un script llamado setup_env.sh que automatiza la instalación de dependencias:

./setup_env.sh

Este script:

• Crea un entorno virtual en .venv.
• Instala pip-tools si no está presente.
• Genera requirements.txt desde requirements.in.
• Instala todas las dependencias requeridas.
• Sincroniza el entorno virtual con las dependencias actualizadas.

---

3. Activar el entorno virtual (opcional)

Dependiendo de tu sistema operativo:

• Linux/MacOS:

source .venv/bin/activate

• Windows (Git Bash o WSL):

source .venv/Scripts/activate

• Windows (CMD):

.\.venv\Scripts\activate

---

🔁 Actualizar dependencias

Si agregas o modificas dependencias en requirements.in, simplemente ejecuta:

./setup_env.sh

Esto actualizará requirements.txt y sincronizará el entorno.

⚠️ pip-sync eliminará los paquetes que ya no estén listados en requirements.txt.

---

📦 Estructura del proyecto (completa)

tu-repositorio/
├── .venv/                  # Entorno virtual (ignorado por Git)
├── requirements.in         # Lista editable de dependencias
├── requirements.txt        # Archivo generado automáticamente
├── setup_env.sh            # Script de configuración de entorno
├── main.py
├── services/
│   └── pdf_service.py
├── utils/
│   └── file_utils.py
└── README.md               # Este archivo