Initial Qt AppImage release catalog client

README.md

@@ -0,0 +1,34 @@
+# AppImage Release Catalog
+
+Client desktop Qt 6/C++ per visualizzare il catalogo JSON delle release AppImage pubblicato su Brain.
+
+## Funzioni
+
+- legge `/api/index.json` e `/api/apps/<app>.json`;
+- mostra applicazioni, descrizione, release, architettura, dimensione e SHA-256;
+- carica l'icona dal catalogo;
+- apre gli URL dell'AppImage stabile, del manifest zsync e del progetto;
+- mantiene la GUI responsiva durante le richieste di rete;
+- URL del catalogo modificabile dalla barra superiore.
+
+Il client è **sola lettura**: non pubblica file e non modifica il repository remoto.
+
+## Requisiti
+
+- C++17;
+- CMake 3.21 o superiore;
+- Qt 6.4 o superiore, moduli `Widgets` e `Network`.
+
+Su Debian/Ubuntu, i pacchetti di sviluppo normalmente necessari sono `cmake`, `g++`, `qt6-base-dev` e `qt6-base-dev-tools`.
+
+## Build
+
+```sh
+cmake -S . -B build -DCMAKE_BUILD_TYPE=Release
+cmake --build build --parallel
+./build/appimage-release-client
+```
+
+URL predefinito: `http://10.8.0.3:8092`.
+
+Per la rete LAN è possibile usare `http://10.0.0.181:8092`.