Keyflow Password Manager

Un gestor de contraseñas seguro, moderno y de código abierto compatible con archivos .kdbx

---

📖 Descripción

Keyflow es un gestor de contraseñas moderno desarrollado con Python y PySide6 que te permite almacenar y gestionar tus credenciales de forma segura utilizando el formato estándar .kdbx de KeePass.

✨ Características Principales

• 🔐 Cifrado Robusto: Compatible con archivos .kdbx (KeePass Database)
• 🎨 Interfaz Moderna: Tema oscuro con diseño limpio e intuitivo
• ⚡ Optimizado: Tiempos de carga reducidos mediante KDF optimizado
• 🔑 Generador de Contraseñas: Crea contraseñas seguras automáticamente
• 🕒 Timer de Portapapeles: Limpieza automática del portapapeles (12 segundos)
• 💾 Última Bóveda: Acceso rápido a tu bóveda más reciente
• 🌐 Menús en Español: Interfaz completamente localizada
• 📋 Copiar con Seguridad: Copia usuario, contraseña y URL con un clic

---

🖼️ Capturas de Pantalla

Pantalla de Inicio

Vista de la Bóveda

---

📦 Instalación

Opción 1: Instalar mediante Snap (Recomendado)

Si tu sistema soporta paquetes Snap (Ubuntu, Manjaro, Linux Mint, etc.), simplemente ejecuta:

sudo snap install keyflow

Opción 2: Instalar vía Repositorio APT (Recomendado para Debian/Ubuntu)

Puedes añadir nuestro repositorio oficial para recibir actualizaciones automáticas:

# 1. Instalar dependencias necesarias
sudo apt install wget gpg

# 2. Descargar la clave GPG
wget -O- https://maalfer.github.io/keyflow/KEY.gpg | gpg --dearmor | sudo tee /usr/share/keyrings/keyflow-archive-keyring.gpg

# 3. Añadir el repositorio
echo "deb [signed-by=/usr/share/keyrings/keyflow-archive-keyring.gpg arch=amd64] https://maalfer.github.io/keyflow stable main" | sudo tee /etc/apt/sources.list.d/keyflow.list

# 4. Instalar Keyflow
sudo apt update
sudo apt install keyflow

Opción 3: Instalar Paquete .deb

Descarga el último release desde GitHub y ejecútalo:

sudo dpkg -i keyflow.deb

---

🚀 Ejecutar la aplicación

Después de la instalación, puedes ejecutar Keyflow de dos formas:

1. Desde el menú de aplicaciones: Busca "Keyflow" en el menú de tu sistema
2. Desde la terminal:

   keyflow

Desinstalar

Para desinstalar Keyflow completamente:

# Si instalaste mediante Snap
sudo snap remove keyflow

# Si instalaste mediane .deb
sudo apt remove keyflow

Ejecutar la aplicación

Después de la instalación, puedes ejecutar Keyflow de dos formas:

1. Desde el menú de aplicaciones: Busca "Keyflow Password Manager" en el menú de tu sistema
2. Desde la terminal:

   keyflow

Desinstalar

Para desinstalar Keyflow completamente:

sudo apt remove keyflow

---

🛡️ Seguridad

• Cifrado: AES-256 para almacenamiento de datos
• KDF Optimizado: Argon2 con iteraciones ajustables (por defecto: 2 para rendimiento)
• Limpieza de Portapapeles: Automática después de 12 segundos
• Sin Almacenamiento en Claro: Las contraseñas nunca se guardan sin cifrar

---

🏗️ Estructura del Proyecto

keyflow/
├── assets/              # Recursos (logo, imágenes)
├── src/
│   ├── database.py      # Lógica de base de datos (pykeepass)
│   └── ui/
│       ├── main_window.py          # Ventana principal
│       ├── start_screen.py         # Pantalla de inicio
│       ├── entry_dialog.py         # Diálogo de entrada (agregar/editar)
│       ├── login_window.py         # Ventana de login
│       ├── password_dialog.py      # Generador de contraseñas
│       ├── security_audit_dialog.py # Auditoría de contraseñas
│       └── styles.py               # Estilos CSS/QSS
├── main.py             # Punto de entrada
├── compilar.sh         # Script de compilación/instalación
├── requirements.txt    # Dependencias
└── README.md           # Este archivo

---

📝 Licencia

Este proyecto está bajo la Licencia MIT - ver el archivo LICENSE para más detalles.

---

👤 Autor

Maalfer

• GitHub: @Maalfer
• LinkedIn: maalfer1
• Proyecto: Keyflow

---

🐛 Reportar Bugs

Si encuentras algún error o tienes problemas con la aplicación, por favor repórtalo en nuestra sección de Issues: https://github.com/Maalfer/keyflow/issues

🗺️ Próximos Objetivos (Roadmap)

• ✅ Soporte Windows: Próximamente disponible instalador .exe y .msi.
• ✅ Soporte Flatpak: Próximamente disponible en Flathub para mayor compatibilidad entre distribuciones.

---

⭐ Si te gusta Keyflow, dale una estrella en GitHub! ⭐