PS5 PKG Virtual Shop 1.1.0

PS5 PKG Virtual Shop es una sencilla pero potente interfaz web para gestionar e instalar tus archivos .pkg locales de PS4/PS5 en una PS5 con jailbreak.

La aplicación se ejecuta en tu ordenador y sirve una interfaz web limpia y compatible con mando directamente en el navegador de tu PS5, permitiendo la instalación con un solo clic mediante el instalador directo de paquetes de etaHEN (Direct Package Installer).

⚠️ Atención: por el momento, el script solo acepta el formato PKG de PS4.

📘 Acerca del proyecto

Este proyecto ofrece una interfaz gráfica para gestionar una colección local de archivos .pkg en una PS5 con jailbreak.

En lugar de escribir URLs manualmente o usar herramientas de línea de comandos, este servidor escanea tus carpetas locales, extrae metadatos (como títulos e iconos) y presenta todo en una tienda categorizada y optimizada para consola.

Está desarrollado con Python Flask en el backend y JavaScript vanilla en el frontend.

✨ Características

• Escaneo automático: detecta e indexa todos los directorios definidos en tu archivo de configuración.
• Metadatos enriquecidos: extrae automáticamente título, ID de contenido e icono de los archivos .pkg.
• Interfaz categorizada: organiza los paquetes en pestañas según la estructura de carpetas (por ejemplo, juegos, apps, DLC).
• Optimizado para PS5:
  • Restringe el acceso solo a consolas PS5.
  • Navegación con mando usando L2/R2 para cambiar de categoría.
• Sistema de paginación: añade botones “Siguiente” y “Anterior” para recorrer colecciones grandes.
• Búsqueda en tiempo real: filtra instantáneamente tu colección por título.
• Instalación con un clic: selecciona cualquier juego o aplicación para enviarlo directamente a la cola de descargas de la PS5 mediante etaHEN DPI v2.
• Personalizable: configura el título, rutas de carpetas y más a través de un sencillo archivo configs.json.
• Ligero: solo requiere Python, Flask y Pillow — sin dependencias pesadas.

🧰 Requisitos previos

Antes de empezar, asegúrate de tener:

• Una PlayStation 5 con jailbreak
• etaHEN ejecutándose con Direct Package Installer (DPI v2) activo
• Python 3.x instalado en tu ordenador
• Tu PC y PS5 conectados a la misma red local

⚙️ Instalación y configuración

Descarga y ejecuta la aplicación desde aquí mismo.

Configurar tu biblioteca

Al ejecutar el servidor por primera vez se generará automáticamente un archivo configs.json.

También puedes crearlo manualmente en la carpeta raíz del proyecto.

Ejemplo de configs.json:

{
    "shop_title": "Mi Biblioteca PS5",
    "paths": {
        "games": "C:\\Users\\TuUsuario\\Documents\\PS5\\PKG\\Games",
        "apps": "/home/user/ps5/apps",
        "dlc": "D:\\PKG_Collection\\DLC",
        "updates": "/path/to/your/updates"
    }
}

• shop_title: título principal mostrado en la interfaz web.
• paths: diccionario donde cada clave representa una categoría (nombre de pestaña) y cada valor, la ruta de la carpeta con archivos .pkg.

4️⃣ Ejecutar el servidor

python app.py

El servidor se iniciará y mostrará qué carpetas se están monitorizando.

El primer escaneo puede tardar un poco si tienes una gran colección; los siguientes serán más rápidos gracias al sistema de caché.

🕹️ Uso

🔧 Encontrar la IP de tu ordenador

• Windows: abre el Símbolo del sistema y escribe ipconfig.
• macOS/Linux: abre la terminal y escribe ifconfig o ip -a.
  • Busca tu dirección IPv4 (por ejemplo: 192.168.1.100).

🌐 Abrir en tu PS5

En el navegador de la PS5, entra en:

http://<TU_IP_PC>:5000

Sustituye <TU_IP_PC> por la dirección IP que encontraste.

🛒 Navegar e instalar

• Las pestañas representan cada categoría.
• Usa L2/R2 para cambiar entre pestañas.
• Usa Siguiente/Anterior para navegar entre páginas.
• Haz clic en cualquier juego o app para instalarlo directamente en tu PS5 mediante etaHEN.

📁 Estructura de archivos

.
├── app.py              # Lógica backend en Flask
├── configs.json        # Configuración del usuario (título y rutas)
├── db.json             # Caché de metadatos de los PKG
├── static/
│   ├── script.js       # Lógica del frontend (renderizado, búsqueda, navegación)
│   ├── style.css       # Estilos de la interfaz web
│   ├── index.html      # Página principal HTML
│   ├── l2.svg          # Icono del mando (L2)
│   └── r2.svg          # Icono del mando (R2)
└── cached/             # Carpeta de iconos extraídos

PS5 PKG Virtual Shop ha sido creado por MestreTM.