Create Added Category - Emulator Cheat Sheet

A cheat sheet for adding emulators that launch games directly in the "Added" category inside of cartridges.

.github/workflows/ci.yml

@@ -18,7 +18,7 @@ jobs:
         uses: actions/checkout@v4
 
       - name: Flatpak Builder
-        uses: flatpak/flatpak-github-actions/flatpak-builder@v6.3
+        uses: flatpak/flatpak-github-actions/flatpak-builder@v6.4
         with:
           bundle: page.kramo.Cartridges.Devel.flatpak
           manifest-path: build-aux/flatpak/page.kramo.Cartridges.Devel.json

.github/workflows/publish-release.yml

@@ -15,7 +15,7 @@ jobs:
         uses: actions/checkout@v4
 
       - name: Download workflow artifact
-        uses: dawidd6/action-download-artifact@v8
+        uses: dawidd6/action-download-artifact@v9
         with:
           workflow: ci.yml
           commit: ${{ github.sha }}

Added Games - Emulator Cheat Sheet

@@ -0,0 +1,49 @@
+--------------------------------
+General Explanation & Tips
+--------------------------------
+* Content added to Cartridges manually will be in the "Added" Category.
+* First load the Application ID and then apply an Argument (Args) for a specific game.
+* Be mindful of what extensions your emulator supports, and be sure to replace the placeholder material with your directories.
+* On Linux if your folder name has spaces you may need to add "" in those sections.
+* On Windows make sure your folders do not use spaces.
+
+
+EXAMPLES
+--------------------------------
+Linux Retroarch Flatpak Example - This example does work in Lutris
+--------------------------------
+Application ID
+org.libretro.RetroArch
+
+Args
+--libretro "/home/usernamehere/.var/app/org.libretro.RetroArch/config/retroarch/cores/corename_libretro.so" "/pathtogame.fileextension"
+
+--------------------------------
+Windows Retroarch Example
+--------------------------------
+Application ID
+RetroarchInstallDirectory\retroarch.exe
+
+Args
+--libretro RetroarchInstallDirectory\cores\corename.dll --fullscreen "gamefolder\gamename.fileextension"
+
+
+ACTUAL FORMATTING
+--------------------------------
+Retroarch Linux - Flatpak
+--------------------------------
+org.libretro.RetroArch --libretro "/home/usernamehere/.var/app/org.libretro.RetroArch/config/retroarch/cores/corename_libretro.so" "/pathtogame.fileextension"
+
+--------------------------------
+Retroarch Windows - Installer, Portable & Itch
+--------------------------------
+RetroarchInstallDirectory\retroarch.exe --libretro RetroarchInstallDirectory\cores\corename.dll --fullscreen "gamefolder\gamename.fileextension"
+
+--------------------------------
+Simple 64 - No Zip Files
+--------------------------------
+Linux Flatpak
+io.github.simple64.simple64 "gamefolder\gamename.fileextension"
+
+Windows
+Simple64InstallFolder\simple64-gui.exe "gamefolder\gamename.fileextension"

data/page.kramo.Cartridges.desktop.in

@@ -6,6 +6,6 @@ Exec=cartridges
 Icon=@APP_ID@
 Terminal=false
 Type=Application
-Categories=GNOME;GTK;Game;
+Categories=GNOME;GTK;Game;PackageManager;
 Keywords=gaming;launcher;steam;lutris;heroic;bottles;itch;flatpak;legendary;retroarch;
 StartupNotify=true