# jlauncher

Lanzador de juegos de **jailgames**. A partir de `games.toml`, lista los juegos, los
clona/actualiza desde sus repos Gitea, lee su icono y descripción, y los compila/ejecuta.

GUI en **Python + PySide6**, pensada para compilarse a binario nativo con **Nuitka**.

## Requisitos

- Python 3.11+ (usa `tomllib` de la stdlib)
- `git` en el PATH
- `pip install PySide6`

## Ejecutar desde fuente

```bash
pip install PySide6
python -m jlauncher
```

La app crea una carpeta `jlauncher_data/` junto al proyecto (o junto al binario, si está
compilado) con esta estructura **anidada (Versión 1)**:

```
jlauncher_data/
  <id_juego>/
    repo/          # git clone del juego
    metadata/
      info.json    # descripción, versión, rama por defecto, fecha de actualización
      icon.png     # copiado desde repo/release/icons/icon.png
```

## Botones (interfaz en catalán)

- **Descarrega**: si no existe el clone, hace `git clone`. Si existe, trae el remoto
  **forzado** (`git fetch` + `git reset --hard origin/<rama>` + `git clean -fd`),
  descartando cualquier cambio local. Después refresca la metadata:
  - descripción desde la API de Gitea (`/api/v1/repos/<org>/<repo>`),
  - versión ejecutando `version_cmd` (por defecto `git describe --tags --always`),
  - icono desde `release/icons/icon.png`.
- **Juga**: si hay `build_cmd`, compila primero; luego ejecuta `run_cmd`. Para estos
  juegos basta `run_cmd = "make run"` (compila y ejecuta), con `build_cmd` vacío.
- **Esborra**: elimina la descarga local (carpeta del juego en `jlauncher_data/`),
  sin quitar el juego del `games.toml`.

Menú **Opcions**: *Amaga els jocs no descarregats* (filtro persistente) y
*Comprova actualitzacions* (marca los juegos descargados con commits pendientes).
Las preferencias se guardan en `settings.json` junto al ejecutable.

Las operaciones corren en segundo plano (QThreadPool); el log aparece en el panel inferior.

## Configuración: `games.toml`

Una entrada `[[game]]` por juego. Campos:

| Campo         | Obligatorio | Descripción                                                        |
|---------------|-------------|--------------------------------------------------------------------|
| `id`          | sí          | slug → nombre de carpeta en `jlauncher_data/`                       |
| `name`        | sí          | nombre visible                                                      |
| `clone_url`   | sí          | URL de git clone / pull                                             |
| `run_cmd`     | sí          | comando que ejecuta el juego (cwd = repo)                           |
| `build_cmd`   | no          | comando de compilado; vacío = `run_cmd` ya compila                  |
| `version_cmd` | no          | comando que imprime la versión (def. `git describe --tags --always`)|
| `info_url`    | no          | API Gitea del repo (def. derivada de `clone_url`)                  |
| `icon_rel`    | no          | ruta del icono dentro del repo (def. `release/icons/icon.png`)     |

## Compilar a binario (Nuitka, onefile)

`build.sh` lo hace todo: crea el `.venv`, instala dependencias (PySide6 + Nuitka +
zstandard) y compila un único ejecutable comprimido, empaquetándolo en
`dist/jlauncher-v<versión>-<os>-<arch>.tar.gz` junto a `games.toml`.

```bash
./build.sh
# binario: dist/jlauncher  (+ dist/games.toml)
```

El binario crea `jlauncher_data/` y `settings.json` **junto a sí mismo** (resuelto vía
`NUITKA_ONEFILE_DIRECTORY`). El punto de entrada para empaquetar es `app.py` (desde
fuente se ejecuta con `python -m jlauncher`).

### Prerequisitos del sistema (no los instala el script)

- **Python 3.11+** (usa `tomllib`).
- Un **compilador C**:
  - Linux: `gcc` y `patchelf` (p. ej. `apt install build-essential patchelf python3-dev`).
  - macOS: **Xcode Command Line Tools** (`xcode-select --install`); aquí *no* hace falta
    patchelf (Nuitka usa `install_name_tool`).
- `git` en el PATH.

### macOS

Compila en el propio Mac (Nuitka no compila cruzado): `./build.sh` genera
`jlauncher-v…-darwin-arm64.tar.gz`. Como el binario no va firmado, la primera vez quizá
debas hacer `xattr -dr com.apple.quarantine jlauncher` o abrirlo con clic derecho → Abrir.
Lánzalo desde terminal (`./jlauncher`).