Create Added Category - Emulator Cheat Sheet

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

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"

build-aux/flatpak/page.kramo.Cartridges.Devel.json

@@ -1,7 +1,7 @@
 {
   "id": "page.kramo.Cartridges.Devel",
   "runtime": "org.gnome.Platform",
-  "runtime-version": "48",
+  "runtime-version": "47",
   "sdk": "org.gnome.Sdk",
   "command": "cartridges",
   "finish-args": [

data/gtk/preferences.blp

@@ -44,7 +44,6 @@ template $CartridgesPreferences: Adw.PreferencesDialog {
       }
 
       Adw.ButtonRow reset_button_row {
-        visible: false;
         title: "Reset App";
 
         styles [

data/page.kramo.Cartridges.metainfo.xml.in

@@ -54,14 +54,9 @@
   </screenshots>
   <content_rating type="oars-1.1" />
   <releases>
-    <release version="2.12.1" date="2025-03-23">
+    <release version="2.11.1" date="2025-03-15">
       <description translate="no">
-        <p>Removed an option used for debugging that would accidentally show up for all users.</p>
-      </description>
-    </release>
-    <release version="2.12" date="2025-03-19">
-      <description translate="no">
-        <p>Updated for GNOME 48</p>
+        <p>Updated the location of Steam covers, so they should correctly import again</p>
       </description>
     </release>
     <release version="2.11" date="2024-12-21">

meson.build

@@ -1,6 +1,6 @@
 project(
   'cartridges',
-  version: '2.12.1',
+  version: '2.11.1',
   meson_version: '>= 0.59.0',
   default_options: [
     'warning_level=2',

po/ca.po

@@ -2,14 +2,13 @@
 # Copyright (C) YEAR kramo
 # This file is distributed under the same license as the Cartridges package.
 # jolupa <jolupameister@gmail.com>, 2023.
-# Moreno <hibarioath@proton.me>, 2025.
 msgid ""
 msgstr ""
 "Project-Id-Version: Cartridges\n"
 "Report-Msgid-Bugs-To: \n"
 "POT-Creation-Date: 2024-11-05 14:01+0100\n"
-"PO-Revision-Date: 2025-03-15 04:51+0000\n"
-"Last-Translator: Moreno <hibarioath@proton.me>\n"
+"PO-Revision-Date: 2023-12-15 13:10+0000\n"
+"Last-Translator: jolupa <jolupameister@gmail.com>\n"
 "Language-Team: Catalan <https://hosted.weblate.org/projects/cartridges/"
 "cartridges/ca/>\n"
 "Language: ca\n"
@@ -17,7 +16,7 @@ msgstr ""
 "Content-Type: text/plain; charset=UTF-8\n"
 "Content-Transfer-Encoding: 8bit\n"
 "Plural-Forms: nplurals=2; plural=n != 1;\n"
-"X-Generator: Weblate 5.11-dev\n"
+"X-Generator: Weblate 5.3\n"
 
 #: data/page.kramo.Cartridges.desktop.in:3
 #: data/page.kramo.Cartridges.metainfo.xml.in:9
@@ -206,7 +205,7 @@ msgstr "Esborrar tots els jocs"
 
 #: data/gtk/preferences.blp:65
 msgid "Import Games Automatically"
-msgstr "Importar jocs automàticament"
+msgstr ""
 
 #: data/gtk/preferences.blp:69
 msgid "Remove Uninstalled Games"
@@ -539,6 +538,7 @@ msgstr "{} mostrar"
 
 #. The variable is the title of the game
 #: cartridges/game.py:153
+#, fuzzy
 msgid "{} removed"
 msgstr "{} eliminat"
 
@@ -587,27 +587,29 @@ msgstr "Descartar"
 
 #: cartridges/utils/relative_date.py:30
 msgid "Today"
-msgstr "Avui"
+msgstr ""
 
 #: cartridges/utils/relative_date.py:32
 msgid "Yesterday"
-msgstr "Ahir"
+msgstr ""
 
 #: cartridges/utils/relative_date.py:36
+#, fuzzy
 msgid "Last Week"
-msgstr "Última setmana"
+msgstr "Últim jugat"
 
 #: cartridges/utils/relative_date.py:38
 msgid "This Month"
-msgstr "Aquest mes"
+msgstr ""
 
 #: cartridges/utils/relative_date.py:40
 msgid "Last Month"
-msgstr "Últim mes"
+msgstr ""
 
 #: cartridges/utils/relative_date.py:44
+#, fuzzy
 msgid "Last Year"
-msgstr "Any passat"
+msgstr "Últim jugat"
 
 #: cartridges/importer/importer.py:144
 msgid "Importing Games…"
@@ -623,17 +625,19 @@ msgstr "No s'han trobat jocs nous"
 
 #. The variable is the number of games.
 #: cartridges/importer/importer.py:379
+#, fuzzy
 msgid "{} game imported"
 msgid_plural "{} games imported"
-msgstr[0] "{} joc importat"
+msgstr[0] "{} jocs importats"
 msgstr[1] "{} jocs importats"
 
 #. The variable is the number of games. This text comes after "{0} games imported".
 #: cartridges/importer/importer.py:383
+#, fuzzy
 msgid ", {} removed"
 msgid_plural ", {} removed"
 msgstr[0] "{} eliminat"
-msgstr[1] "{} eliminats"
+msgstr[1] "{} eliminat"
 
 #. The variable is the name of the source
 #: cartridges/importer/location.py:34

po/de.po

@@ -3,18 +3,16 @@
 # This file is distributed under the same license as the Cartridges package.
 # Jummit <jummit@web.de>, 2023.
 # WebSnke <websnke@tutanota.com>, 2023.
-# Ettore Atalan <atalanttore@googlemail.com>, 2023, 2025.
+# Ettore Atalan <atalanttore@googlemail.com>, 2023.
 # Simon Hahne <simonhahne@web.de>, 2023.
 # Konstantin Tutsch <mail@konstantintutsch.com>, 2024.
-# Weblate Translation Memory <noreply-mt-weblate-translation-memory@weblate.org>, 2025.
 msgid ""
 msgstr ""
 "Project-Id-Version: Cartridges\n"
 "Report-Msgid-Bugs-To: \n"
 "POT-Creation-Date: 2024-11-05 14:01+0100\n"
-"PO-Revision-Date: 2025-03-15 16:28+0000\n"
-"Last-Translator: Weblate Translation Memory <noreply-mt-weblate-translation-"
-"memory@weblate.org>\n"
+"PO-Revision-Date: 2024-02-19 06:35+0000\n"
+"Last-Translator: Konstantin Tutsch <mail@konstantintutsch.com>\n"
 "Language-Team: German <https://hosted.weblate.org/projects/cartridges/"
 "cartridges/de/>\n"
 "Language: de\n"
@@ -22,7 +20,7 @@ msgstr ""
 "Content-Type: text/plain; charset=UTF-8\n"
 "Content-Transfer-Encoding: 8bit\n"
 "Plural-Forms: nplurals=2; plural=n != 1;\n"
-"X-Generator: Weblate 5.11-dev\n"
+"X-Generator: Weblate 5.4\n"
 
 #: data/page.kramo.Cartridges.desktop.in:3
 #: data/page.kramo.Cartridges.metainfo.xml.in:9
@@ -211,7 +209,7 @@ msgstr "Alle Spiele entfernen"
 
 #: data/gtk/preferences.blp:65
 msgid "Import Games Automatically"
-msgstr "Spiele automatisch importieren"
+msgstr ""
 
 #: data/gtk/preferences.blp:69
 msgid "Remove Uninstalled Games"
@@ -552,6 +550,7 @@ msgstr "{} unversteckt"
 
 #. The variable is the title of the game
 #: cartridges/game.py:153
+#, fuzzy
 msgid "{} removed"
 msgstr "{} entfernt"
 
@@ -607,20 +606,22 @@ msgid "Yesterday"
 msgstr "Gestern"
 
 #: cartridges/utils/relative_date.py:36
+#, fuzzy
 msgid "Last Week"
-msgstr "Letzte Woche"
+msgstr "Zuletzt gespielt"
 
 #: cartridges/utils/relative_date.py:38
 msgid "This Month"
-msgstr "Dieser Monat"
+msgstr ""
 
 #: cartridges/utils/relative_date.py:40
 msgid "Last Month"
-msgstr "Letzter Monat"
+msgstr ""
 
 #: cartridges/utils/relative_date.py:44
+#, fuzzy
 msgid "Last Year"
-msgstr "Letztes Jahr"
+msgstr "Zuletzt gespielt"
 
 #: cartridges/importer/importer.py:144
 msgid "Importing Games…"
@@ -636,6 +637,7 @@ msgstr "Keine neuen Spiele gefunden"
 
 #. The variable is the number of games.
 #: cartridges/importer/importer.py:379
+#, fuzzy
 msgid "{} game imported"
 msgid_plural "{} games imported"
 msgstr[0] "{} Spiele importiert"
@@ -643,10 +645,11 @@ msgstr[1] "{} Spiele importiert"
 
 #. The variable is the number of games. This text comes after "{0} games imported".
 #: cartridges/importer/importer.py:383
+#, fuzzy
 msgid ", {} removed"
 msgid_plural ", {} removed"
-msgstr[0] ", {} entfernt"
-msgstr[1] ", {} entfernt"
+msgstr[0] "{} entfernt"
+msgstr[1] "{} entfernt"
 
 #. The variable is the name of the source
 #: cartridges/importer/location.py:34

po/en_GB.po

@@ -3,14 +3,13 @@
 # This file is distributed under the same license as the Cartridges package.
 # kramo <contact@kramo.page>, 2024.
 # Bruce Cowan <bruce@bcowan.me.uk>, 2024.
-# Andi Chandler <andi@gowling.com>, 2025.
 msgid ""
 msgstr ""
 "Project-Id-Version: Cartridges\n"
 "Report-Msgid-Bugs-To: \n"
 "POT-Creation-Date: 2024-11-05 14:01+0100\n"
-"PO-Revision-Date: 2025-02-20 14:20+0000\n"
-"Last-Translator: Andi Chandler <andi@gowling.com>\n"
+"PO-Revision-Date: 2024-03-24 15:19+0000\n"
+"Last-Translator: Bruce Cowan <bruce@bcowan.me.uk>\n"
 "Language-Team: English (United Kingdom) <https://hosted.weblate.org/projects/"
 "cartridges/cartridges/en_GB/>\n"
 "Language: en_GB\n"
@@ -18,7 +17,7 @@ msgstr ""
 "Content-Type: text/plain; charset=UTF-8\n"
 "Content-Transfer-Encoding: 8bit\n"
 "Plural-Forms: nplurals=2; plural=n != 1;\n"
-"X-Generator: Weblate 5.10.1-dev\n"
+"X-Generator: Weblate 5.5-dev\n"
 
 #: data/page.kramo.Cartridges.desktop.in:3
 #: data/page.kramo.Cartridges.metainfo.xml.in:9
@@ -207,7 +206,7 @@ msgstr "Remove All Games"
 
 #: data/gtk/preferences.blp:65
 msgid "Import Games Automatically"
-msgstr "Import Games Automatically"
+msgstr ""
 
 #: data/gtk/preferences.blp:69
 msgid "Remove Uninstalled Games"
@@ -438,10 +437,9 @@ msgstr "{} launched"
 
 #. Translators: Replace this with Your Name, Your Name <your.email@example.com>, or Your Name https://your-site.com for it to show up in the About dialog.
 #: cartridges/main.py:291
+#, fuzzy
 msgid "translator-credits"
-msgstr ""
-"Bruce Cowan <bruce@bcowan.me.uk>\n"
-"Andi Chandler <andi@gowling.com>"
+msgstr "Bruce Cowan <bruce@bcowan.me.uk>"
 
 #. The variable is the date when the game was added
 #: cartridges/window.py:382
@@ -542,6 +540,7 @@ msgstr "{} unhidden"
 
 #. The variable is the title of the game
 #: cartridges/game.py:153
+#, fuzzy
 msgid "{} removed"
 msgstr "{} removed"
 
@@ -589,27 +588,29 @@ msgstr "Dismiss"
 
 #: cartridges/utils/relative_date.py:30
 msgid "Today"
-msgstr "Today"
+msgstr ""
 
 #: cartridges/utils/relative_date.py:32
 msgid "Yesterday"
-msgstr "Yesterday"
+msgstr ""
 
 #: cartridges/utils/relative_date.py:36
+#, fuzzy
 msgid "Last Week"
-msgstr "Last Week"
+msgstr "Last Played"
 
 #: cartridges/utils/relative_date.py:38
 msgid "This Month"
-msgstr "This Month"
+msgstr ""
 
 #: cartridges/utils/relative_date.py:40
 msgid "Last Month"
-msgstr "Last Month"
+msgstr ""
 
 #: cartridges/utils/relative_date.py:44
+#, fuzzy
 msgid "Last Year"
-msgstr "Last Year"
+msgstr "Last Played"
 
 #: cartridges/importer/importer.py:144
 msgid "Importing Games…"
@@ -625,13 +626,15 @@ msgstr "No new games found"
 
 #. The variable is the number of games.
 #: cartridges/importer/importer.py:379
+#, fuzzy
 msgid "{} game imported"
 msgid_plural "{} games imported"
-msgstr[0] "{} game imported"
+msgstr[0] "{} games imported"
 msgstr[1] "{} games imported"
 
 #. The variable is the number of games. This text comes after "{0} games imported".
 #: cartridges/importer/importer.py:383
+#, fuzzy
 msgid ", {} removed"
 msgid_plural ", {} removed"
 msgstr[0] "{} removed"

po/ko.po

@@ -2,13 +2,13 @@
 # Copyright (C) YEAR kramo
 # This file is distributed under the same license as the Cartridges package.
 # MJKim <kmj10727@gmail.com>, 2023.
-# Seong-ho Cho <darkcircle.0426@gmail.com>, 2024, 2025.
+# Seong-ho Cho <darkcircle.0426@gmail.com>, 2024.
 msgid ""
 msgstr ""
 "Project-Id-Version: Cartridges\n"
 "Report-Msgid-Bugs-To: \n"
 "POT-Creation-Date: 2024-11-05 14:01+0100\n"
-"PO-Revision-Date: 2025-02-24 14:34+0000\n"
+"PO-Revision-Date: 2024-03-02 19:01+0000\n"
 "Last-Translator: Seong-ho Cho <darkcircle.0426@gmail.com>\n"
 "Language-Team: Korean <https://hosted.weblate.org/projects/cartridges/"
 "cartridges/ko/>\n"
@@ -17,7 +17,7 @@ msgstr ""
 "Content-Type: text/plain; charset=UTF-8\n"
 "Content-Transfer-Encoding: 8bit\n"
 "Plural-Forms: nplurals=1; plural=0;\n"
-"X-Generator: Weblate 5.10.1-dev\n"
+"X-Generator: Weblate 5.5-dev\n"
 
 #: data/page.kramo.Cartridges.desktop.in:3
 #: data/page.kramo.Cartridges.metainfo.xml.in:9
@@ -207,7 +207,7 @@ msgstr "모든 게임 제거"
 
 #: data/gtk/preferences.blp:65
 msgid "Import Games Automatically"
-msgstr "자동으로 게임 가져오기"
+msgstr ""
 
 #: data/gtk/preferences.blp:69
 msgid "Remove Uninstalled Games"
@@ -361,7 +361,7 @@ msgstr "숨긴 게임 없음"
 
 #: data/gtk/window.blp:41
 msgid "Games you hide will appear here"
-msgstr "숨긴 게임은 이곳에 나타납니다"
+msgstr "숨긴 게임이 이곳에 나타납니다"
 
 #: data/gtk/window.blp:76 data/gtk/window.blp:113 cartridges/main.py:249
 msgid "All Games"
@@ -541,6 +541,7 @@ msgstr "{} 숨김 해제함"
 
 #. The variable is the title of the game
 #: cartridges/game.py:153
+#, fuzzy
 msgid "{} removed"
 msgstr "{} 제거함"
 
@@ -588,27 +589,29 @@ msgstr "버리기"
 
 #: cartridges/utils/relative_date.py:30
 msgid "Today"
-msgstr "오늘"
+msgstr ""
 
 #: cartridges/utils/relative_date.py:32
 msgid "Yesterday"
-msgstr "어제"
+msgstr ""
 
 #: cartridges/utils/relative_date.py:36
+#, fuzzy
 msgid "Last Week"
-msgstr "지난 주"
+msgstr "최근 플레이"
 
 #: cartridges/utils/relative_date.py:38
 msgid "This Month"
-msgstr "이번 달"
+msgstr ""
 
 #: cartridges/utils/relative_date.py:40
 msgid "Last Month"
-msgstr "지난 달"
+msgstr ""
 
 #: cartridges/utils/relative_date.py:44
+#, fuzzy
 msgid "Last Year"
-msgstr "작년"
+msgstr "최근 플레이"
 
 #: cartridges/importer/importer.py:144
 msgid "Importing Games…"
@@ -624,15 +627,17 @@ msgstr "새 게임이 없습니다"
 
 #. The variable is the number of games.
 #: cartridges/importer/importer.py:379
+#, fuzzy
 msgid "{} game imported"
 msgid_plural "{} games imported"
 msgstr[0] "게임 {}건을 가져왔습니다"
 
 #. The variable is the number of games. This text comes after "{0} games imported".
 #: cartridges/importer/importer.py:383
+#, fuzzy
 msgid ", {} removed"
 msgid_plural ", {} removed"
-msgstr[0] ", {} 제거함"
+msgstr[0] "{} 제거함"
 
 #. The variable is the name of the source
 #: cartridges/importer/location.py:34