Josties Game Launcher

1. SteamGridDB API-key maken

Maak deze key voordat je de launcher installeert. Tijdens de setup kun je hem direct invullen, zodat artwork ophalen meteen goed staat.

1. Ga naar https://www.steamgriddb.com.
2. Log in of maak een account aan.
3. Open Profile Preferences - API.
4. Maak of kopieer je persoonlijke API-key.
5. Bewaar de key tijdelijk, bijvoorbeeld in een wachtwoordmanager of een tijdelijk tekstbestand.

Deel deze key niet openbaar. Na installatie bewaart de launcher hem lokaal in je Windows-profiel, zodat je hem niet iedere keer opnieuw hoeft in te voeren.

2. Downloaden en installeren

1. Ga naar https://josties.nl.
2. Kies Download setup.
3. Start GameLauncherSetup.exe.
4. Bevestig de Windows-adminmelding als die verschijnt.
5. Kies of je een snelkoppeling op het bureaublad en in het Startmenu wilt.
6. Plak je SteamGridDB API-key in het API-key veld.
7. Kies Install.

De launcher wordt standaard geïnstalleerd in C:\Program Files\Josties Game Launcher.

3. Eerste start

Bij het openen laadt de launcher eerst de bestaande bibliotheek. Daarna scant hij op de achtergrond naar games uit de ingeschakelde importers.

De lijst kan titels vinden uit Steam, Epic, Ubisoft, Battle.net, Xbox, EA, Playnite, snelkoppelingen en handmatig toegevoegde games.

4. Settings en importers kiezen

1. Kies Settings, of druk met een controller op LB + X.
2. Zet de platformen aan die je wilt gebruiken.
3. Gebruik D-pad om te bewegen, A om te schakelen, Start om op te slaan en B om te annuleren.
4. Kies Scan games om de bibliotheek opnieuw op te bouwen.

De EXE-scan kan veel extra bestanden vinden. Zet die alleen aan als je games mist die niet via launchers of snelkoppelingen gevonden worden.

Zet Playnite uninstalled library aan wanneer je niet-geinstalleerde games uit je lokale Playnite-bibliotheek wilt lezen. Geinstalleerde games blijven uit hun normale launcher-scans komen zodat je geen dubbele titels krijgt.

5. Details per game gebruiken

Selecteer een game en druk op A of Start om het detailscherm te openen. Vanuit details kun je starten, een niet-geinstalleerde game installeren of de launcher openen, trailers tonen, de lokale gamemap openen, artwork herstellen en de titel verbergen of terugzetten.

6. Niet-geinstalleerde games tonen en installeren

1. Open Settings.
2. Zet Show uninstalled launcher games aan.
3. Zet Playnite uninstalled library aan als je niet-geinstalleerde Playnite-games wilt meenemen.
4. Kies Scan games.
5. Selecteer een niet-geinstalleerde game en open Details.
6. Kies Install / open launcher.

Steam, Epic en Xbox kunnen waar ondersteund direct de installatiestap openen. Playnite-items openen waar mogelijk de gekozen game in Playnite. Andere launchers openen de bijbehorende game of launcherpagina wanneer dat mogelijk is.

7. Artwork aanvullen of herstellen

Gebruik Refresh art om metadata en artwork voor je bibliotheek aan te vullen. Gebruik Fix art bij een geselecteerde game wanneer de automatische match niet klopt of wanneer je een ander artwork wilt kiezen.

Als SteamGridDB geen goede match vindt, kun je de titel aanpassen via de match-keuze die de launcher aanbiedt. Heb je tijdens de installatie nog geen API-key ingevuld, dan vraagt de launcher erom zodra je artwork ververst of herstelt.

8. Games toevoegen, verbergen en terughalen

Kies Add game om handmatig een .exe, .lnk of .url toe te voegen.

Kies Hide title om een titel uit de normale bibliotheek te halen. Kies daarna Hidden om verborgen titels te bekijken. In die weergave wordt de knop Unhide title, waarmee je een game terugzet. Je kunt een verborgen game ook terugzetten vanuit het detailscherm.

9. Zoeken, recent en trailers

Typ in het zoekveld om de lijst direct te filteren. Gebruik Recent om games op laatst gespeeld te sorteren. Bij games met trailerdata kun je de trailer openen in fullscreen.

Met een controller kun je door de lijst bewegen, details openen, starten, zoeken, scannen, settings openen, artwork herstellen en titels verbergen of terughalen.

10. Automatische updates en What's new

De launcher controleert bij het opstarten of er een nieuwe versie beschikbaar is via het update-manifest.

Als er een update is, vraagt de launcher of je die wilt installeren. Na akkoord downloadt hij de installer, controleert de SHA-256 hash, sluit zichzelf af, voert de update uit en opent de launcher opnieuw.

Voor de installatie kan Windows om adminrechten vragen, omdat de app in Program Files staat.

Na een succesvolle update toont de app eenmalig per versie een What's new venster. Daarin staan de belangrijkste wijzigingen en korte gebruiksuitleg voor nieuwe functies.

11. Problemen oplossen

Er worden geen games gevonden

Controleer de importers en voer daarna Scan games opnieuw uit.

Artwork blijft leeg

Controleer of je SteamGridDB API-key is opgeslagen en probeer daarna Refresh art.

Een game start niet

Voeg de game handmatig toe met Add game en kies de juiste executable of snelkoppeling.

Een verborgen game is weg

Kies Hidden, selecteer de game en kies Unhide title.