I hate automation I hate the cloud I hate CI I h--

* Translated using Weblate (German)

Currently translated at 100.0% (141 of 141 strings)

Co-authored-by: Konstantin Tutsch <mail@konstantintutsch.com>
Translate-URL: https://hosted.weblate.org/projects/cartridges/cartridges/de/
Translation: Cartridges/Cartridges

* Translated using Weblate (Hungarian)

Currently translated at 100.0% (141 of 141 strings)

Co-authored-by: Hosted Weblate <hosted@weblate.org>
Co-authored-by: kramo <contact@kramo.hu>
Translate-URL: https://hosted.weblate.org/projects/cartridges/cartridges/hu/
Translation: Cartridges/Cartridges

* Translated using Weblate (Hindi)

Currently translated at 100.0% (141 of 141 strings)

Translated using Weblate (Hindi)

Currently translated at 100.0% (141 of 141 strings)

Added translation using Weblate (Hindi)

Co-authored-by: Hosted Weblate <hosted@weblate.org>
Co-authored-by: Nitin Khalia <weblate.scrambled777@simplelogin.com>
Translate-URL: https://hosted.weblate.org/projects/cartridges/cartridges/hi/
Translation: Cartridges/Cartridges

* Translated using Weblate (Dutch)

Currently translated at 100.0% (141 of 141 strings)

Co-authored-by: Hosted Weblate <hosted@weblate.org>
Co-authored-by: Philip Goto <philip.goto@gmail.com>
Translate-URL: https://hosted.weblate.org/projects/cartridges/cartridges/nl/
Translation: Cartridges/Cartridges

* Translated using Weblate (Chinese (Simplified))

Currently translated at 100.0% (141 of 141 strings)

Co-authored-by: Float <float.hu+@gmail.com>
Co-authored-by: Hosted Weblate <hosted@weblate.org>
Translate-URL: https://hosted.weblate.org/projects/cartridges/cartridges/zh_Hans/
Translation: Cartridges/Cartridges

* Update translation files

Updated by "Squash Git commits" hook in Weblate.

Translation: Cartridges/Cartridges
Translate-URL: https://hosted.weblate.org/projects/cartridges/cartridges/

---------

Co-authored-by: Konstantin Tutsch <mail@konstantintutsch.com>
Co-authored-by: kramo <contact@kramo.hu>
Co-authored-by: Nitin Khalia <weblate.scrambled777@simplelogin.com>
Co-authored-by: Philip Goto <philip.goto@gmail.com>
Co-authored-by: Float <float.hu+@gmail.com>

.github/FUNDING.yml

@@ -0,0 +1 @@
+github: [kra-mo]

.github/ISSUE_TEMPLATE/bug_report.md

@@ -0,0 +1,35 @@
+---
+name: Bug report
+about: Create a report to help us improve
+title: ''
+labels: bug
+assignees: ''
+
+---
+
+**Describe the bug**
+A clear and concise description of what the bug is.
+
+**To Reproduce**
+Steps to reproduce the behavior:
+1. Go to '...'
+2. Click on '....'
+3. Scroll down to '....'
+4. See error
+
+**Expected behavior**
+A clear and concise description of what you expected to happen.
+
+**Screenshots**
+If applicable, add screenshots to help explain your problem.
+
+**Logs**
+If applicable, attatch your logs from `Main Menu > About Cartridges > Troubleshooting > Debugging Information` to the issue.
+
+**System (please complete the following information):**
+ - OS: [e.g. Fedora Linux]
+ - Installation method [e.g. Flatpak]
+ - Cartridges version [e.g. 1.5.4]
+
+**Additional context**
+Add any other context about the problem here.

.github/ISSUE_TEMPLATE/feature_request.md

@@ -0,0 +1,20 @@
+---
+name: Feature request
+about: Suggest an idea for this project
+title: ''
+labels: enhancement
+assignees: ''
+
+---
+
+**Is your feature request related to a problem? Please describe.**
+A clear and concise description of what the problem is. Ex. I'm always frustrated when [...]
+
+**Describe the solution you'd like**
+A clear and concise description of what you want to happen.
+
+**Describe alternatives you've considered**
+A clear and concise description of any alternative solutions or features you've considered.
+
+**Additional context**
+Add any other context or screenshots about the feature request here.

.github/workflows/ci.yml

@@ -0,0 +1,60 @@
+on:
+  push:
+    branches: [main]
+  pull_request:
+name: CI
+concurrency:
+  group: release-${{ github.sha }}
+jobs:
+  flatpak:
+    name: Flatpak
+    runs-on: ubuntu-latest
+    container:
+      image: bilelmoussaoui/flatpak-github-actions:gnome-45
+      options: --privileged
+    steps:
+    - name: Checkout
+      uses: actions/checkout@v4
+
+    - name: Flatpak Builder
+      uses: flatpak/flatpak-github-actions/flatpak-builder@v6.3
+      with:
+        bundle: hu.kramo.Cartridges.Devel.flatpak
+        manifest-path: flatpak/hu.kramo.Cartridges.Devel.json
+
+  windows:
+    name: Windows
+    runs-on: windows-latest
+    steps:
+      - name: Checkout
+        uses: actions/checkout@v4
+
+      - name: Setup MSYS2
+        uses: msys2/setup-msys2@v2
+        with:
+          msystem: UCRT64
+          update: true
+          install: mingw-w64-ucrt-x86_64-gtk4 mingw-w64-ucrt-x86_64-libadwaita mingw-w64-ucrt-x86_64-python-gobject mingw-w64-ucrt-x86_64-python-yaml mingw-w64-ucrt-x86_64-python-requests mingw-w64-ucrt-x86_64-python-pillow mingw-w64-ucrt-x86_64-desktop-file-utils mingw-w64-ucrt-x86_64-ca-certificates mingw-w64-ucrt-x86_64-meson git
+
+      - name: Compile
+        shell: msys2 {0}
+        run: |
+          meson setup _build
+          ninja -C _build install
+          pacman --noconfirm -Rs mingw-w64-ucrt-x86_64-desktop-file-utils mingw-w64-ucrt-x86_64-meson git
+          find /ucrt64/share/locale/ -type f ! -name "*cartridges.mo" -delete
+
+      - name: Test
+        shell: msys2 {0}
+        run: |
+          set +e
+          timeout 2 cartridges; [ "$?" -eq "124" ]
+
+      - name: Inno Setup
+        run: iscc ".\_build\windows\Cartridges.iss"
+
+      - name: Upload Artifact
+        uses: actions/upload-artifact@v3
+        with:
+          name: Windows Installer
+          path: _build/windows/Output/Cartridges Setup.exe

.github/workflows/flatpak-builder.yml

@@ -1,21 +0,0 @@
-on:
-  push:
-    branches: [main]
-  pull_request:
-name: CI
-jobs:
-  flatpak:
-    name: "Flatpak"
-    runs-on: ubuntu-latest
-    container:
-      image: bilelmoussaoui/flatpak-github-actions:gnome-40
-      options: --privileged
-    steps:
-    - uses: actions/checkout@v3
-    - uses: flatpak/flatpak-github-actions/flatpak-builder@v5
-      with:
-        repository-name: gnome-nightly
-        repository-url: https://nightly.gnome.org/gnome-nightly.flatpakrepo
-        bundle: hu.kramo.Cartridges.flatpak
-        manifest-path: hu.kramo.Cartridges.json
-        cache-key: flatpak-builder-${{ github.sha }}

.github/workflows/publish-release.yml

@@ -0,0 +1,45 @@
+on:
+  push:
+    tags:
+      "*"
+name: Publish Release
+concurrency:
+  group: release-${{ github.sha }}
+jobs:
+  publish-release:
+    name: Publish Release
+    runs-on: ubuntu-latest
+    steps:
+      - name: Checkout
+        uses: actions/checkout@v4
+
+      - name: Download workflow artifact
+        uses: dawidd6/action-download-artifact@v3.0.0
+        with:
+          workflow: ci.yml
+          commit: ${{ github.sha }}
+
+      - name: Get release notes
+        shell: python
+        run: |
+          import re, textwrap
+          open_file = open("./data/hu.kramo.Cartridges.metainfo.xml.in", "r", encoding="utf-8")
+          string = open_file.read()
+          open_file.close()
+          string = re.findall("<release.*>\s*<description.*>\n([\s\S]*?)\s*</description>\s*<\/release>", string)[0]
+          string = textwrap.dedent(string)
+          open_file = open("release_notes", "w", encoding="utf-8")
+          open_file.write(string)
+          open_file.close()
+
+      - name: Get tag name
+        id: get_tag_name
+        run: echo tag_name=${GITHUB_REF#refs/tags/} >> $GITHUB_OUTPUT
+
+      - name: Publish release
+        uses: softprops/action-gh-release@v0.1.15
+        with:
+          files: Windows Installer/Cartridges Setup.exe
+          fail_on_unmatched_files: true
+          tag_name: ${{ steps.get_tag_name.outputs.tag_name }}
+          body_path: release_notes

.github/workflows/windows.yml

@@ -1,31 +0,0 @@
-on:
-  push:
-    branches: [main]
-  pull_request:
-name: "Build for Windows"
-jobs:
-  windows:
-    name: "Build"
-    runs-on: windows-latest
-    steps:
-      - name: Checkout
-        uses: actions/checkout@v3
-      - name: MSYS2
-        uses: msys2/setup-msys2@v2
-        with:
-          msystem: UCRT64
-          update: true
-          install: mingw-w64-ucrt-x86_64-gtk4 mingw-w64-ucrt-x86_64-libadwaita mingw-w64-ucrt-x86_64-python-gobject mingw-w64-ucrt-x86_64-python-yaml mingw-w64-ucrt-x86_64-desktop-file-utils mingw-w64-ucrt-x86_64-ca-certificates mingw-w64-ucrt-x86_64-meson git
-      - name: Compile
-        shell: msys2 {0}
-        run: |
-          meson _build
-          ninja -C _build install
-          pacman --noconfirm -Rs mingw-w64-ucrt-x86_64-desktop-file-utils mingw-w64-ucrt-x86_64-meson git
-      - name: "Inno Setup"
-        run: iscc ".\.windows\Cartridges.iss"
-      - name: "Upload Artifact"
-        uses: actions/upload-artifact@v3
-        with:
-          name: "Installer"
-          path: ".windows/Output/Cartridges Setup.exe"

.gitignore

@@ -1,3 +1,4 @@
 /subprojects/blueprint-compiler
 /.flatpak
+/.flatpak-builder
 /.vscode

.pylintrc

@@ -0,0 +1,32 @@
+[MAIN]
+
+ignore=importers
+
+
+[MESSAGES CONTROL]
+
+disable=raw-checker-failed,
+        bad-inline-option,
+        locally-disabled,
+        file-ignored,
+        suppressed-message,
+        useless-suppression,
+        deprecated-pragma,
+        use-symbolic-message-instead,
+        too-few-public-methods,
+        missing-function-docstring,
+        missing-class-docstring,
+        missing-module-docstring,
+        relative-beyond-top-level,
+        import-error,
+        no-name-in-module
+
+
+[TYPECHECK]
+
+ignored-classes=Child
+
+
+[VARIABLES]
+
+additional-builtins=_

.windows/cartridges

@@ -1,41 +0,0 @@
-# Cartridges
-#
-# Copyright 2022 kramo
-#
-# This program is free software: you can redistribute it and/or modify
-# it under the terms of the GNU General Public License as published by
-# the Free Software Foundation, either version 3 of the License, or
-# (at your option) any later version.
-#
-# This program is distributed in the hope that it will be useful,
-# but WITHOUT ANY WARRANTY; without even the implied warranty of
-# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
-# GNU General Public License for more details.
-#
-# You should have received a copy of the GNU General Public License
-# along with this program.  If not, see <http://www.gnu.org/licenses/>.
-#
-# SPDX-License-Identifier: GPL-3.0-or-later
-
-import os
-import sys
-import signal
-import gettext
-
-VERSION = '0.1.3'
-pkgdatadir = os.path.join(os.path.dirname(__file__), '..', 'share', 'cartridges')
-localedir = os.path.join(os.path.dirname(__file__), '..', 'share', 'locale')
-
-sys.path.insert(1, pkgdatadir)
-signal.signal(signal.SIGINT, signal.SIG_DFL)
-gettext.install('cartridges', localedir)
-
-if __name__ == '__main__':
-    import gi
-
-    from gi.repository import Gio
-    resource = Gio.Resource.load(os.path.join(pkgdatadir, 'cartridges.gresource'))
-    resource._register()
-
-    from cartridges import main
-    sys.exit(main.main(VERSION))

CODE_OF_CONDUCT.md

@@ -0,0 +1,3 @@
+The project follows the [GNOME Code of Conduct](https://wiki.gnome.org/Foundation/CodeOfConduct).
+
+If you believe that someone is violating the Code of Conduct, or have any other concerns, please contact us via [cartridges-community@kramo.page](mailto:cartridges-community@kramo.page).

CONTRIBUTING.md

@@ -0,0 +1,62 @@
+# Contributing
+
+## Code
+
+Be sure to follow the [code style](#code-style) of the project.
+
+### Adding a feature
+[Create an issue](https://github.com/kra-mo/cartridges/issues/new) or join the [Discord](https://discord.gg/4KSFh3AmQR)/[Matrix](https://matrix.to/#/#cartridges:matrix.org) to discuss it with the maintainers. We will provide additional guidance.
+
+### Fixing a bug
+Fork the repository, make your changes, then create a pull request. Be sure to mention the GitHub issue you're fixing if one was already open.
+
+## Translations
+### Weblate
+The project can be translated on [Weblate](https://hosted.weblate.org/engage/cartridges/).
+
+### Manually
+1. Clone the repository.
+2. If it isn't already there, add your language to `/po/LINGUAS`.
+3. Create a new translation from the `/po/cartridges.pot` file with a translation editor such as [Poedit](https://poedit.net/).
+4. Save the file as `[YOUR LANGUAGE CODE].po` to `/po/`.
+5. Create a pull request with your translations.
+
+# Building
+
+## GNOME Builder
+1. Install [GNOME Builder](https://flathub.org/apps/org.gnome.Builder).
+2. Click "Clone Repository" with `https://github.com/kra-mo/cartridges.git` as the URL.
+3. Click on the build button (hammer) at the top.
+
+## For Windows
+1. Install [MSYS2](https://www.msys2.org/).
+2. From the MSYS2 shell, install the required dependencies listed [here](https://github.com/kra-mo/cartridges/blob/main/.github/workflows/ci.yml).
+3. Build it via Meson.
+
+## Meson
+```bash
+git clone https://github.com/kra-mo/cartridges.git
+cd cartridges
+meson setup build
+ninja -C build install
+```
+
+# Code style
+
+All code is auto-formatted with [Black](https://github.com/psf/black) and linted with [Pylint](https://github.com/pylint-dev/pylint). Imports are sorted by [isort](https://github.com/pycqa/isort).
+
+VSCode extensions are available for all of these and you can set them up with the following `settings.json` configuration:
+
+```json
+"python.formatting.provider": "none",
+"[python]": {
+    "editor.defaultFormatter": "ms-python.black-formatter",
+    "editor.formatOnSave": true,
+    "editor.codeActionsOnSave": {
+        "source.organizeImports": true
+    },
+},
+"isort.args":["--profile", "black"],
+```
+
+For other code editors, you can install them via `pip` and invoke them from the command line.

README.md

@@ -1,75 +1,101 @@
 
+[circle-url]: https://circle.gnome.org
+[circle-image]: https://circle.gnome.org/assets/button/badge.svg
+[weblate-url]: https://hosted.weblate.org/engage/cartridges/
+[weblate-image]: https://hosted.weblate.org/widgets/cartridges/-/cartridges/svg-badge.svg
+[discord-url]: https://discord.gg/4KSFh3AmQR
+[discord-image]: https://img.shields.io/discord/1088155799299313754?color=%235865F2&label=discord&logo=discord&logoColor=%23FFFFFF&style=for-the-badge
+[matrix-url]: https://matrix.to/#/#cartridges:matrix.org
+[matrix-image]: https://img.shields.io/matrix/cartridges:matrix.org?label=Matrix&logo=matrix&color=%230dbd8b&style=for-the-badge
+[flathub-url]: https://flathub.org/apps/hu.kramo.Cartridges
+[flathub-image]: https://img.shields.io/flathub/v/hu.kramo.Cartridges?logo=flathub&style=for-the-badge
+[installs-image]: https://img.shields.io/flathub/downloads/hu.kramo.Cartridges?style=for-the-badge
+
 <div align="center">
   <img src="data/icons/hicolor/scalable/apps/hu.kramo.Cartridges.svg" width="128" height="128">
 
   # Cartridges
+
   A GTK4 + Libadwaita game launcher
 
-[![Build status][github-actions-image]][github-actions-url]
+  [![GNOME Circle][circle-image]][circle-url]
   [![Translation Status][weblate-image]][weblate-url]
-[![Merged PRs][prs-merged-image]][prs-merged-url]
-[![License][license-image]][license-url]
-[![Code style][code-style-image]][code-style-url]
 
-[github-actions-url]: https://github.com/kra-mo/cartridges
+  [![Flathub][flathub-image]][flathub-url]
-[github-actions-image]: https://img.shields.io/github/actions/workflow/status/kra-mo/cartridges/flatpak-builder.yml?branch=main&label=build
+  [![Discord][discord-image]][discord-url]
-[prs-merged-url]: https://github.com/kra-mo/cartridges/pulls?q=is:pr+is:merged
+  [![Matrix][matrix-image]][matrix-url]
-[prs-merged-image]: https://img.shields.io/github/issues-pr-closed-raw/kra-mo/cartridges.svg?label=merged+PRs&color=green
+  [![Installs][installs-image]][flathub-url]
-[license-url]: https://github.com/kra-mo/cartridges/blob/main/LICENSE
-[license-image]: https://img.shields.io/github/license/kra-mo/cartridges
-[code-style-url]: https://github.com/psf/black
-[code-style-image]: https://img.shields.io/badge/code%20style-black-000000?style=flat
-[weblate-url]: https://hosted.weblate.org/projects/cartridges/cartridges
-[weblate-image]: https://hosted.weblate.org/widgets/cartridges/-/cartridges/svg-badge.svg
 
-  <img src="data/screenshot.webp">
+  <img src="data/screenshots/1.png">
 </div>
 
+# The Project
+
+Cartridges is an easy-to-use, elegant game launcher written in Python using GTK4 and Libadwaita.
+
+## Features
 
-## The Project
-Cartridges is a simple game launcher written in Python using GTK4 + Libadwaita.
-### Features
 - Manually adding and editing games
-- Importing games from Steam, Heroic and Bottles
+- Importing games from various sources:
-- Hiding games
+  - Steam
+  - Lutris
+  - Heroic
+  - Bottles
+  - itch
+  - Legendary
+  - RetroArch
+  - Flatpak
+  - Desktop Entries
+- Filtering games by source
 - Searching and sorting by title, date added and last played
+- Hiding games
+- Automatically downloading cover art from [SteamGridDB](https://www.steamgriddb.com/)
+- Searching for games on various databases
+- Animated covers
+- A search provider for GNOME
 
-## Building
+For updates and questions, join our [Discord server][discord-url] (bridged to [Matrix](https://matrix.to/#/#cartridges:matrix.org))!
 
-### GNOME Builder
+## Donations
+I accept donations through [GitHub Sponsors](https://github.com/sponsors/kra-mo).
 
-1. Download [GNOME Builder](https://flathub.org/apps/details/org.gnome.Builder).
+Thank you for your generosity! 💜
-2. Click "Clone Repository" with `https://github.com/kra-mo/game-shelf.git` as the URL.
-3. Click on the build button (hammer) at the top.
 
-## Installation
+# Installation
 
-### Latest Build From GitHub Actions
+## Linux
-1. Install `org.gnome.Platform` from the [gnome-nightly repository](https://wiki.gnome.org/Apps/Nightly) if needed.
+
-2. Download the artifact from the latest workflow run.
+### Flathub
-3. Decompress the archive.
+
-4. Install it via GNOME Software or `flatpak install hu.kramo.Cartridges.flatpak`.
+The app is available on Flathub.
+
+<a href=https://flathub.org/apps/hu.kramo.Cartridges><img width='240' alt='Download on Flathub' src='https://dl.flathub.org/assets/badges/flathub-badge-en.png'/></a>
+
+## Windows
 
 ### From Releases
-1. Install `org.gnome.Platform` from the [gnome-nightly repository](https://wiki.gnome.org/Apps/Nightly) if needed.
-2. Download the latest release from Releases.
-3. Install it via GNOME Software or `flatpak install hu.kramo.Cartridges.flatpak`.
 
-### From GNOME Builder
+1. Download the latest release from [Releases](https://github.com/kra-mo/cartridges/releases).
-Click the down arrow next to the hammer at the top of your GNOME Builder window, then click "Export". This will create a flatpak that then can be installed on your system.
+2. Run the downloaded installer.
 
-## Contributing
+Note: Windows might present you with a warning when trying to install the app. This is expected, just ignore the warning.
 
-### Code
+### Winget
-Fork the repository, make your changes, then create a pull request. 
 
-### Translations
+Install the latest release with the command: `winget install cartridges`. 
-#### Weblate
-The project can be translated on [Weblate](https://hosted.weblate.org/projects/cartridges/).
 
-#### Manually
+## Building manually
-1. Clone the repository.
+
-2. If it isn't already there, add your language to `/po/LINGUAS`.
+See [Building](https://github.com/kra-mo/cartridges/blob/main/CONTRIBUTING.md#building).
-3. Create a new translation from the `/po/cartridges.pot` file with a translation editor such as [Poedit](https://poedit.net/).
+
-4. Save the file as `[YOUR LANGUAGE CODE].po` to `/po/`.
+# Contributing
-5. Create a pull request with your translations.
+
+See [CONTRIBUTING.md](https://github.com/kra-mo/cartridges/blob/main/CONTRIBUTING.md).
+
+Thanks to [Weblate](https://weblate.org/) for hosting our translations!
+
+# Code of Conduct
+
+The project follows the [GNOME Code of Conduct](https://wiki.gnome.org/Foundation/CodeOfConduct).
+
+See [CODE_OF_CONDUCT.md](https://github.com/kra-mo/cartridges/blob/main/CODE_OF_CONDUCT.md).

cartridges.doap

@@ -0,0 +1,41 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<Project xmlns:rdf="http://www.w3.org/1999/02/22-rdf-syntax-ns#"
+         xmlns:rdfs="http://www.w3.org/2000/01/rdf-schema#"
+         xmlns:foaf="http://xmlns.com/foaf/0.1/"
+         xmlns:gnome="http://api.gnome.org/doap-extensions#"
+         xmlns="http://usefulinc.com/ns/doap#">
+
+  <name>Cartridges</name>
+  <shortdesc xml:lang="en">Launch all your games</shortdesc>
+  <description xml:lang="en">
+Cartridges is a simple game launcher for all of your games. It has support for importing games from Steam, Lutris, Heroic and more with no login necessary. You can sort and hide games or download cover art from SteamGridDB.
+  </description>
+
+  <homepage rdf:resource="https://github.com/kra-mo/cartridges" />
+  <download-page rdf:resource="https://github.com/kra-mo/cartridges" />
+  <bug-database rdf:resource="https://github.com/kra-mo/cartridges/issues" />
+
+  <programming-language>Python</programming-language>
+  <platform>GTK 4</platform>
+  <platform>Libadwaita</platform>
+
+  <maintainer>
+    <foaf:Person>
+      <foaf:name>kramo</foaf:name>
+      <foaf:mbox rdf:resource="mailto:contact@kramo.page" />
+      <foaf:account>
+        <foaf:OnlineAccount>
+          <foaf:accountServiceHomepage rdf:resource="https://github.com"/>
+          <foaf:accountName>kra-mo</foaf:accountName>
+        </foaf:OnlineAccount>
+      </foaf:account>
+      <foaf:account>
+        <foaf:OnlineAccount>
+          <foaf:accountServiceHomepage rdf:resource="https://gitlab.gnome.org"/>
+          <foaf:accountName>kramo</foaf:accountName>
+        </foaf:OnlineAccount>
+      </foaf:account>
+    </foaf:Person>
+  </maintainer>
+
+</Project>

cartridges/__builtins__.pyi

@@ -0,0 +1 @@
+def _(_msg: str, /) -> str: ...

cartridges/cartridges.in

@@ -2,7 +2,7 @@
 
 # cartridges.in
 #
-# Copyright 2022 kramo
+# Copyright 2022-2023 kramo
 #
 # This program is free software: you can redistribute it and/or modify
 # it under the terms of the GNU General Public License as published by
@@ -19,28 +19,40 @@
 #
 # SPDX-License-Identifier: GPL-3.0-or-later
 
-import os
-import sys
-import signal
-import locale
 import gettext
+import locale
+import os
+import signal
+import sys
 
-VERSION = '@VERSION@'
+VERSION = "@VERSION@"
-pkgdatadir = '@pkgdatadir@'
+if os.name == "nt":
-localedir = '@localedir@'
+    from ctypes import windll
 
-sys.path.insert(1, pkgdatadir)
+    os.environ["LANGUAGE"] = locale.windows_locale[
+        windll.kernel32.GetUserDefaultUILanguage()
+    ]
+    PKGDATADIR = os.path.join(os.path.dirname(__file__), "..", "share", "cartridges")
+    LOCALEDIR = os.path.join(os.path.dirname(__file__), "..", "share", "locale")
+else:
+    PKGDATADIR = "@pkgdatadir@"
+    LOCALEDIR = "@localedir@"
+
+sys.path.insert(1, PKGDATADIR)
 signal.signal(signal.SIGINT, signal.SIG_DFL)
-locale.bindtextdomain('cartridges', localedir)
-locale.textdomain('cartridges')
-gettext.install('cartridges', localedir)
 
-if __name__ == '__main__':
+if os.name != "nt":
-    import gi
+    locale.bindtextdomain("cartridges", LOCALEDIR)
+    locale.textdomain("cartridges")
 
+gettext.install("cartridges", LOCALEDIR)
+
+if __name__ == "__main__":
     from gi.repository import Gio
-    resource = Gio.Resource.load(os.path.join(pkgdatadir, 'cartridges.gresource'))
+
-    resource._register()
+    resource = Gio.Resource.load(os.path.join(PKGDATADIR, "cartridges.gresource"))
+    resource._register()  # pylint: disable=protected-access
 
     from cartridges import main
+
     sys.exit(main.main(VERSION))

cartridges/details_window.py

@@ -0,0 +1,331 @@
+# details_window.py
+#
+# Copyright 2022-2023 kramo
+#
+# This program is free software: you can redistribute it and/or modify
+# it under the terms of the GNU General Public License as published by
+# the Free Software Foundation, either version 3 of the License, or
+# (at your option) any later version.
+#
+# This program is distributed in the hope that it will be useful,
+# but WITHOUT ANY WARRANTY; without even the implied warranty of
+# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+# GNU General Public License for more details.
+#
+# You should have received a copy of the GNU General Public License
+# along with this program.  If not, see <http://www.gnu.org/licenses/>.
+#
+# SPDX-License-Identifier: GPL-3.0-or-later
+
+import os
+import shlex
+from pathlib import Path
+from time import time
+from typing import Any, Optional
+
+from gi.repository import Adw, Gio, GLib, Gtk
+from PIL import Image, UnidentifiedImageError
+
+from cartridges import shared
+from cartridges.errors.friendly_error import FriendlyError
+from cartridges.game import Game
+from cartridges.game_cover import GameCover
+from cartridges.store.managers.cover_manager import CoverManager
+from cartridges.store.managers.sgdb_manager import SgdbManager
+from cartridges.utils.create_dialog import create_dialog
+from cartridges.utils.save_cover import convert_cover, save_cover
+
+
+@Gtk.Template(resource_path=shared.PREFIX + "/gtk/details-window.ui")
+class DetailsWindow(Adw.Window):
+    __gtype_name__ = "DetailsWindow"
+
+    cover_overlay = Gtk.Template.Child()
+    cover = Gtk.Template.Child()
+    cover_button_edit = Gtk.Template.Child()
+    cover_button_delete_revealer = Gtk.Template.Child()
+    cover_button_delete = Gtk.Template.Child()
+    spinner = Gtk.Template.Child()
+
+    name = Gtk.Template.Child()
+    developer = Gtk.Template.Child()
+    executable = Gtk.Template.Child()
+
+    exec_info_label = Gtk.Template.Child()
+    exec_info_popover = Gtk.Template.Child()
+    file_chooser_button = Gtk.Template.Child()
+
+    apply_button = Gtk.Template.Child()
+
+    cover_changed: bool = False
+
+    def __init__(self, game: Optional[Game] = None, **kwargs: Any):
+        super().__init__(**kwargs)
+
+        self.game: Game = game
+        self.game_cover: GameCover = GameCover({self.cover})
+
+        self.set_transient_for(shared.win)
+
+        if self.game:
+            self.set_title(_("Game Details"))
+            self.name.set_text(self.game.name)
+            if self.game.developer:
+                self.developer.set_text(self.game.developer)
+            self.executable.set_text(self.game.executable)
+            self.apply_button.set_label(_("Apply"))
+
+            self.game_cover.new_cover(self.game.get_cover_path())
+            if self.game_cover.get_texture():
+                self.cover_button_delete_revealer.set_reveal_child(True)
+        else:
+            self.set_title(_("Add New Game"))
+            self.apply_button.set_label(_("Add"))
+
+        image_filter = Gtk.FileFilter(name=_("Images"))
+        for extension in Image.registered_extensions():
+            image_filter.add_suffix(extension[1:])
+            image_filter.add_suffix("svg")  # Gdk.Texture supports .svg but PIL doesn't
+
+        image_filters = Gio.ListStore.new(Gtk.FileFilter)
+        image_filters.append(image_filter)
+
+        exec_filter = Gtk.FileFilter(name=_("Executables"))
+        exec_filter.add_mime_type("application/x-executable")
+
+        exec_filters = Gio.ListStore.new(Gtk.FileFilter)
+        exec_filters.append(exec_filter)
+
+        self.image_file_dialog = Gtk.FileDialog()
+        self.image_file_dialog.set_filters(image_filters)
+        self.image_file_dialog.set_default_filter(image_filter)
+
+        self.exec_file_dialog = Gtk.FileDialog()
+        self.exec_file_dialog.set_filters(exec_filters)
+        self.exec_file_dialog.set_default_filter(exec_filter)
+
+        # Translate this string as you would translate "file"
+        file_name = _("file.txt")
+        # As in software
+        exe_name = _("program")
+
+        if os.name == "nt":
+            exe_name += ".exe"
+            # Translate this string as you would translate "path to {}"
+            exe_path = _("C:\\path\\to\\{}").format(exe_name)
+            # Translate this string as you would translate "path to {}"
+            file_path = _("C:\\path\\to\\{}").format(file_name)
+            command = "start"
+        else:
+            # Translate this string as you would translate "path to {}"
+            exe_path = _("/path/to/{}").format(exe_name)
+            # Translate this string as you would translate "path to {}"
+            file_path = _("/path/to/{}").format(file_name)
+            command = "xdg-open"
+
+        # pylint: disable=line-too-long
+        exec_info_text = _(
+            'To launch the executable "{}", use the command:\n\n<tt>"{}"</tt>\n\nTo open the file "{}" with the default application, use:\n\n<tt>{} "{}"</tt>\n\nIf the path contains spaces, make sure to wrap it in double quotes!'
+        ).format(exe_name, exe_path, file_name, command, file_path)
+
+        self.exec_info_label.set_label(exec_info_text)
+
+        self.exec_info_popover.update_property(
+            (Gtk.AccessibleProperty.LABEL,),
+            (
+                exec_info_text.replace("<tt>", "").replace("</tt>", ""),
+            ),  # Remove formatting, else the screen reader reads it
+        )
+
+        def set_exec_info_a11y_label(*_args: Any) -> None:
+            self.set_focus(self.exec_info_popover)
+
+        self.exec_info_popover.connect("show", set_exec_info_a11y_label)
+
+        self.cover_button_delete.connect("clicked", self.delete_pixbuf)
+        self.cover_button_edit.connect("clicked", self.choose_cover)
+        self.file_chooser_button.connect("clicked", self.choose_executable)
+        self.apply_button.connect("clicked", self.apply_preferences)
+
+        self.name.connect("entry-activated", self.focus_executable)
+        self.developer.connect("entry-activated", self.focus_executable)
+        self.executable.connect("entry-activated", self.apply_preferences)
+
+        self.set_focus(self.name)
+        self.present()
+
+    def delete_pixbuf(self, *_args: Any) -> None:
+        self.game_cover.new_cover()
+
+        self.cover_button_delete_revealer.set_reveal_child(False)
+        self.cover_changed = True
+
+    def apply_preferences(self, *_args: Any) -> None:
+        final_name = self.name.get_text()
+        final_developer = self.developer.get_text()
+        final_executable = self.executable.get_text()
+
+        if not self.game:
+            if final_name == "":
+                create_dialog(
+                    self, _("Couldn't Add Game"), _("Game title cannot be empty.")
+                )
+                return
+
+            if final_executable == "":
+                create_dialog(
+                    self, _("Couldn't Add Game"), _("Executable cannot be empty.")
+                )
+                return
+
+            # Increment the number after the game id (eg. imported_1, imported_2)
+            source_id = "imported"
+            numbers = [0]
+            game_id: str
+            for game_id in shared.store.source_games.get(source_id, set()):
+                prefix = "imported_"
+                if not game_id.startswith(prefix):
+                    continue
+                numbers.append(int(game_id.replace(prefix, "", 1)))
+
+            game_number = max(numbers) + 1
+
+            self.game = Game(
+                {
+                    "game_id": f"imported_{game_number}",
+                    "hidden": False,
+                    "source": source_id,
+                    "added": int(time()),
+                }
+            )
+
+            if shared.win.sidebar.get_selected_row().get_child() not in (
+                shared.win.all_games_row_box,
+                shared.win.added_row_box,
+            ):
+                shared.win.sidebar.select_row(shared.win.added_row_box.get_parent())
+
+        else:
+            if final_name == "":
+                create_dialog(
+                    self,
+                    _("Couldn't Apply Preferences"),
+                    _("Game title cannot be empty."),
+                )
+                return
+
+            if final_executable == "":
+                create_dialog(
+                    self,
+                    _("Couldn't Apply Preferences"),
+                    _("Executable cannot be empty."),
+                )
+                return
+
+        self.game.name = final_name
+        self.game.developer = final_developer or None
+        self.game.executable = final_executable
+
+        if self.game.game_id in shared.win.game_covers.keys():
+            shared.win.game_covers[self.game.game_id].animation = None
+
+        shared.win.game_covers[self.game.game_id] = self.game_cover
+
+        if self.cover_changed:
+            save_cover(
+                self.game.game_id,
+                self.game_cover.path,
+            )
+
+        shared.store.add_game(self.game, {}, run_pipeline=False)
+        self.game.save()
+        self.game.update()
+
+        # TODO: this is fucked up (less than before)
+        # Get a cover from SGDB if none is present
+        if not self.game_cover.get_texture():
+            self.game.set_loading(1)
+            sgdb_manager = shared.store.managers[SgdbManager]
+            sgdb_manager.reset_cancellable()
+            sgdb_manager.process_game(self.game, {}, self.update_cover_callback)
+
+        self.game_cover.pictures.remove(self.cover)
+
+        self.close()
+        shared.win.show_details_page(self.game)
+
+    def update_cover_callback(self, manager: SgdbManager) -> None:
+        # Set the game as not loading
+        self.game.set_loading(-1)
+        self.game.update()
+
+        # Handle errors that occured
+        for error in manager.collect_errors():
+            # On auth error, inform the user
+            if isinstance(error, FriendlyError):
+                create_dialog(
+                    shared.win,
+                    error.title,
+                    error.subtitle,
+                    "open_preferences",
+                    _("Preferences"),
+                ).connect("response", self.update_cover_error_response)
+
+    def update_cover_error_response(self, _widget: Any, response: str) -> None:
+        if response == "open_preferences":
+            shared.win.get_application().on_preferences_action(page_name="sgdb")
+
+    def focus_executable(self, *_args: Any) -> None:
+        self.set_focus(self.executable)
+
+    def toggle_loading(self) -> None:
+        self.apply_button.set_sensitive(not self.apply_button.get_sensitive())
+        self.spinner.set_spinning(not self.spinner.get_spinning())
+        self.cover_overlay.set_opacity(not self.cover_overlay.get_opacity())
+
+    def set_cover(self, _source: Any, result: Gio.Task, *_args: Any) -> None:
+        try:
+            path = self.image_file_dialog.open_finish(result).get_path()
+        except GLib.Error:
+            return
+
+        def thread_func() -> None:
+            new_path = None
+
+            try:
+                with Image.open(path) as image:
+                    if getattr(image, "is_animated", False):
+                        new_path = convert_cover(path)
+            except UnidentifiedImageError:
+                pass
+
+            if not new_path:
+                new_path = convert_cover(
+                    pixbuf=shared.store.managers[CoverManager].composite_cover(
+                        Path(path)
+                    )
+                )
+
+            if new_path:
+                self.game_cover.new_cover(new_path)
+                self.cover_button_delete_revealer.set_reveal_child(True)
+                self.cover_changed = True
+
+            self.toggle_loading()
+
+        self.toggle_loading()
+        GLib.Thread.new(None, thread_func)
+
+    def set_executable(self, _source: Any, result: Gio.Task, *_args: Any) -> None:
+        try:
+            path = self.exec_file_dialog.open_finish(result).get_path()
+        except GLib.Error:
+            return
+
+        self.executable.set_text(shlex.quote(path))
+
+    def choose_executable(self, *_args: Any) -> None:
+        self.exec_file_dialog.open(self, None, self.set_executable)
+
+    def choose_cover(self, *_args: Any) -> None:
+        self.image_file_dialog.open(self, None, self.set_cover)

cartridges/errors/error_producer.py

@@ -0,0 +1,28 @@
+from threading import Lock
+
+
+class ErrorProducer:
+    """
+    A mixin for objects that produce errors.
+
+    Specifies the report_error and collect_errors methods in a thread-safe manner.
+    """
+
+    errors: list[Exception]
+    errors_lock: Lock
+
+    def __init__(self) -> None:
+        self.errors = []
+        self.errors_lock = Lock()
+
+    def report_error(self, error: Exception) -> None:
+        """Report an error"""
+        with self.errors_lock:
+            self.errors.append(error)
+
+    def collect_errors(self) -> list[Exception]:
+        """Collect and remove the errors produced by the object"""
+        with self.errors_lock:
+            errors = self.errors.copy()
+            self.errors.clear()
+        return errors

cartridges/errors/friendly_error.py

@@ -0,0 +1,47 @@
+from typing import Iterable, Optional
+
+
+class FriendlyError(Exception):
+    """
+    An error that is supposed to be shown to the user in a nice format
+
+    Use `raise ... from ...` to preserve context.
+    """
+
+    title_format: str
+    title_args: Iterable[str]
+    subtitle_format: str
+    subtitle_args: Iterable[str]
+
+    @property
+    def title(self) -> str:
+        """Get the gettext translated error title"""
+        return self.title_format.format(self.title_args)
+
+    @property
+    def subtitle(self) -> str:
+        """Get the gettext translated error subtitle"""
+        return self.subtitle_format.format(self.subtitle_args)
+
+    def __init__(
+        self,
+        title: str,
+        subtitle: str,
+        title_args: Optional[Iterable[str]] = None,
+        subtitle_args: Optional[Iterable[str]] = None,
+    ) -> None:
+        """Create a friendly error
+
+        :param str title: The error's title, translatable with gettext
+        :param str subtitle: The error's subtitle, translatable with gettext
+        """
+        super().__init__()
+        if title is not None:
+            self.title_format = title
+        if subtitle is not None:
+            self.subtitle_format = subtitle
+        self.title_args = title_args if title_args else ()
+        self.subtitle_args = subtitle_args if subtitle_args else ()
+
+    def __str__(self) -> str:
+        return f"{self.title} - {self.subtitle}"

cartridges/game.py

@@ -0,0 +1,203 @@
+# game.py
+#
+# Copyright 2022-2023 kramo
+#
+# This program is free software: you can redistribute it and/or modify
+# it under the terms of the GNU General Public License as published by
+# the Free Software Foundation, either version 3 of the License, or
+# (at your option) any later version.
+#
+# This program is distributed in the hope that it will be useful,
+# but WITHOUT ANY WARRANTY; without even the implied warranty of
+# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+# GNU General Public License for more details.
+#
+# You should have received a copy of the GNU General Public License
+# along with this program.  If not, see <http://www.gnu.org/licenses/>.
+#
+# SPDX-License-Identifier: GPL-3.0-or-later
+
+import shlex
+from pathlib import Path
+from time import time
+from typing import Any, Optional
+
+from gi.repository import Adw, GObject, Gtk
+
+from cartridges import shared
+from cartridges.game_cover import GameCover
+from cartridges.utils.run_executable import run_executable
+
+
+# pylint: disable=too-many-instance-attributes
+@Gtk.Template(resource_path=shared.PREFIX + "/gtk/game.ui")
+class Game(Gtk.Box):
+    __gtype_name__ = "Game"
+
+    title = Gtk.Template.Child()
+    play_button = Gtk.Template.Child()
+    cover = Gtk.Template.Child()
+    spinner = Gtk.Template.Child()
+    cover_button = Gtk.Template.Child()
+    menu_button = Gtk.Template.Child()
+    play_revealer = Gtk.Template.Child()
+    menu_revealer = Gtk.Template.Child()
+    game_options = Gtk.Template.Child()
+    hidden_game_options = Gtk.Template.Child()
+
+    loading: int = 0
+    filtered: bool = False
+
+    added: int
+    executable: str
+    game_id: str
+    source: str
+    hidden: bool = False
+    last_played: int = 0
+    name: str
+    developer: Optional[str] = None
+    removed: bool = False
+    blacklisted: bool = False
+    game_cover: GameCover = None
+    version: int = 0
+
+    def __init__(self, data: dict[str, Any], **kwargs: Any) -> None:
+        super().__init__(**kwargs)
+
+        self.app = shared.win.get_application()
+        self.version = shared.SPEC_VERSION
+
+        self.update_values(data)
+        self.base_source = self.source.split("_")[0]
+
+        self.set_play_icon()
+
+        self.event_contoller_motion = Gtk.EventControllerMotion.new()
+        self.add_controller(self.event_contoller_motion)
+        self.event_contoller_motion.connect("enter", self.toggle_play, False)
+        self.event_contoller_motion.connect("leave", self.toggle_play, None, None)
+        self.cover_button.connect("clicked", self.main_button_clicked, False)
+        self.play_button.connect("clicked", self.main_button_clicked, True)
+
+        shared.schema.connect("changed", self.schema_changed)
+
+    def update_values(self, data: dict[str, Any]) -> None:
+        for key, value in data.items():
+            # Convert executables to strings
+            if key == "executable" and isinstance(value, list):
+                value = shlex.join(value)
+            setattr(self, key, value)
+
+    def update(self) -> None:
+        self.emit("update-ready", {})
+
+    def save(self) -> None:
+        self.emit("save-ready", {})
+
+    def create_toast(self, title: str, action: Optional[str] = None) -> None:
+        toast = Adw.Toast.new(title.format(self.name))
+        toast.set_priority(Adw.ToastPriority.HIGH)
+        toast.set_use_markup(False)
+
+        if action:
+            toast.set_button_label(_("Undo"))
+            toast.connect("button-clicked", shared.win.on_undo_action, self, action)
+
+            if (self, action) in shared.win.toasts.keys():
+                # Dismiss the toast if there already is one
+                shared.win.toasts[(self, action)].dismiss()
+
+            shared.win.toasts[(self, action)] = toast
+
+        shared.win.toast_overlay.add_toast(toast)
+
+    def launch(self) -> None:
+        self.last_played = int(time())
+        self.save()
+        self.update()
+
+        run_executable(self.executable)
+
+        if shared.schema.get_boolean("exit-after-launch"):
+            self.app.quit()
+
+        # The variable is the title of the game
+        self.create_toast(_("{} launched"))
+
+    def toggle_hidden(self, toast: bool = True) -> None:
+        self.hidden = not self.hidden
+        self.save()
+
+        if shared.win.navigation_view.get_visible_page() == shared.win.details_page:
+            shared.win.navigation_view.pop()
+
+        self.update()
+
+        if toast:
+            self.create_toast(
+                # The variable is the title of the game
+                (_("{} hidden") if self.hidden else _("{} unhidden")).format(self.name),
+                "hide",
+            )
+
+    def remove_game(self) -> None:
+        # Add "removed=True" to the game properties so it can be deleted on next init
+        self.removed = True
+        self.save()
+        self.update()
+
+        if shared.win.navigation_view.get_visible_page() == shared.win.details_page:
+            shared.win.navigation_view.pop()
+
+        # The variable is the title of the game
+        self.create_toast(_("{} removed").format(self.name), "remove")
+
+    def set_loading(self, state: int) -> None:
+        self.loading += state
+        loading = self.loading > 0
+
+        self.cover.set_opacity(int(not loading))
+        self.spinner.set_spinning(loading)
+
+    def get_cover_path(self) -> Optional[Path]:
+        cover_path = shared.covers_dir / f"{self.game_id}.gif"
+        if cover_path.is_file():
+            return cover_path  # type: ignore
+
+        cover_path = shared.covers_dir / f"{self.game_id}.tiff"
+        if cover_path.is_file():
+            return cover_path  # type: ignore
+
+        return None
+
+    def toggle_play(
+        self, _widget: Any, _prop1: Any, _prop2: Any, state: bool = True
+    ) -> None:
+        if not self.menu_button.get_active():
+            self.play_revealer.set_reveal_child(not state)
+            self.menu_revealer.set_reveal_child(not state)
+
+    def main_button_clicked(self, _widget: Any, button: bool) -> None:
+        if shared.schema.get_boolean("cover-launches-game") ^ button:
+            self.launch()
+        else:
+            shared.win.show_details_page(self)
+
+    def set_play_icon(self) -> None:
+        self.play_button.set_icon_name(
+            "help-about-symbolic"
+            if shared.schema.get_boolean("cover-launches-game")
+            else "media-playback-start-symbolic"
+        )
+
+    def schema_changed(self, _settings: Any, key: str) -> None:
+        if key == "cover-launches-game":
+            self.set_play_icon()
+
+    @GObject.Signal(name="update-ready", arg_types=[object])
+    def update_ready(self, _additional_data):  # type: ignore
+        """Signal emitted when the game needs updating"""
+
+    @GObject.Signal(name="save-ready", arg_types=[object])
+    def save_ready(self, _additional_data):  # type: ignore
+        """Signal emitted when the game needs saving"""

cartridges/game_cover.py

@@ -0,0 +1,132 @@
+# game_cover.py
+#
+# Copyright 2022-2023 kramo
+#
+# This program is free software: you can redistribute it and/or modify
+# it under the terms of the GNU General Public License as published by
+# the Free Software Foundation, either version 3 of the License, or
+# (at your option) any later version.
+#
+# This program is distributed in the hope that it will be useful,
+# but WITHOUT ANY WARRANTY; without even the implied warranty of
+# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+# GNU General Public License for more details.
+#
+# You should have received a copy of the GNU General Public License
+# along with this program.  If not, see <http://www.gnu.org/licenses/>.
+#
+# SPDX-License-Identifier: GPL-3.0-or-later
+
+from pathlib import Path
+from typing import Optional
+
+from gi.repository import Gdk, GdkPixbuf, Gio, GLib, Gtk
+from PIL import Image, ImageFilter, ImageStat
+
+from cartridges import shared
+
+
+class GameCover:
+    texture: Optional[Gdk.Texture]
+    blurred: Optional[Gdk.Texture]
+    luminance: Optional[tuple[float, float]]
+    path: Optional[Path]
+    animation: Optional[GdkPixbuf.PixbufAnimation]
+    anim_iter: Optional[GdkPixbuf.PixbufAnimationIter]
+
+    placeholder = Gdk.Texture.new_from_resource(
+        shared.PREFIX + "/library_placeholder.svg"
+    )
+    placeholder_small = Gdk.Texture.new_from_resource(
+        shared.PREFIX + "/library_placeholder_small.svg"
+    )
+
+    def __init__(self, pictures: set[Gtk.Picture], path: Optional[Path] = None) -> None:
+        self.pictures = pictures
+        self.new_cover(path)
+
+    def new_cover(self, path: Optional[Path] = None) -> None:
+        self.animation = None
+        self.texture = None
+        self.blurred = None
+        self.luminance = None
+        self.path = path
+
+        if path:
+            if path.suffix == ".gif":
+                self.animation = GdkPixbuf.PixbufAnimation.new_from_file(str(path))
+                self.anim_iter = self.animation.get_iter()
+                self.task = Gio.Task.new()
+                self.task.run_in_thread(
+                    lambda *_: self.update_animation((self.task, self.animation))
+                )
+            else:
+                self.texture = Gdk.Texture.new_from_filename(str(path))
+
+        if not self.animation:
+            self.set_texture(self.texture)
+
+    def get_texture(self) -> Gdk.Texture:
+        return (
+            Gdk.Texture.new_for_pixbuf(self.animation.get_static_image())
+            if self.animation
+            else self.texture
+        )
+
+    def get_blurred(self) -> Gdk.Texture:
+        if not self.blurred:
+            if self.path:
+                with Image.open(self.path) as image:
+                    image = (
+                        image.convert("RGB")
+                        .resize((100, 150))
+                        .filter(ImageFilter.GaussianBlur(20))
+                    )
+
+                    tmp_path = Gio.File.new_tmp(None)[0].get_path()
+                    image.save(tmp_path, "tiff", compression=None)
+
+                    self.blurred = Gdk.Texture.new_from_filename(tmp_path)
+
+                    stat = ImageStat.Stat(image.convert("L"))
+
+                    # Luminance values for light and dark mode
+                    self.luminance = (
+                        min((stat.mean[0] + stat.extrema[0][0]) / 510, 0.7),
+                        max((stat.mean[0] + stat.extrema[0][1]) / 510, 0.3),
+                    )
+            else:
+                self.blurred = self.placeholder_small
+                self.luminance = (0.3, 0.5)
+
+        return self.blurred
+
+    def add_picture(self, picture: Gtk.Picture) -> None:
+        self.pictures.add(picture)
+        if not self.animation:
+            self.set_texture(self.texture)
+        else:
+            self.update_animation((self.task, self.animation))
+
+    def set_texture(self, texture: Gdk.Texture) -> None:
+        self.pictures.discard(
+            picture for picture in self.pictures if not picture.is_visible()
+        )
+        if not self.pictures:
+            self.animation = None
+        else:
+            for picture in self.pictures:
+                picture.set_paintable(texture or self.placeholder)
+
+    def update_animation(self, data: GdkPixbuf.PixbufAnimation) -> None:
+        if self.animation == data[1]:
+            self.anim_iter.advance()  # type: ignore
+
+            self.set_texture(Gdk.Texture.new_for_pixbuf(self.anim_iter.get_pixbuf()))  # type: ignore
+
+            delay_time = self.anim_iter.get_delay_time()  # type: ignore
+            GLib.timeout_add(
+                20 if delay_time < 20 else delay_time,
+                self.update_animation,
+                data,
+            )

cartridges/importer/bottles_source.py

@@ -0,0 +1,109 @@
+# bottles_source.py
+#
+# Copyright 2022-2023 kramo
+# Copyright 2023 Geoffrey Coulaud
+#
+# This program is free software: you can redistribute it and/or modify
+# it under the terms of the GNU General Public License as published by
+# the Free Software Foundation, either version 3 of the License, or
+# (at your option) any later version.
+#
+# This program is distributed in the hope that it will be useful,
+# but WITHOUT ANY WARRANTY; without even the implied warranty of
+# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+# GNU General Public License for more details.
+#
+# You should have received a copy of the GNU General Public License
+# along with this program.  If not, see <http://www.gnu.org/licenses/>.
+#
+# SPDX-License-Identifier: GPL-3.0-or-later
+
+from pathlib import Path
+from typing import NamedTuple
+
+import yaml
+
+from cartridges import shared
+from cartridges.game import Game
+from cartridges.importer.location import Location, LocationSubPath
+from cartridges.importer.source import SourceIterable, URLExecutableSource
+
+
+class BottlesSourceIterable(SourceIterable):
+    source: "BottlesSource"
+
+    def __iter__(self):
+        """Generator method producing games"""
+
+        data = self.source.locations.data["library.yml"].read_text("utf-8")
+        library: dict = yaml.safe_load(data)
+
+        for entry in library.values():
+            # Build game
+            values = {
+                "source": self.source.source_id,
+                "added": shared.import_time,
+                "name": entry["name"],
+                "game_id": self.source.game_id_format.format(game_id=entry["id"]),
+                "executable": self.source.make_executable(
+                    bottle_name=entry["bottle"]["name"],
+                    game_name=entry["name"],
+                ),
+            }
+            game = Game(values)
+
+            # Get official cover path
+            try:
+                # This will not work if both Cartridges and Bottles are installed via Flatpak
+                # as Cartridges can't access directories picked via Bottles' file picker portal
+                bottles_location = Path(
+                    yaml.safe_load(
+                        self.source.locations.data["data.yml"].read_text("utf-8")
+                    )["custom_bottles_path"]
+                )
+            except (FileNotFoundError, KeyError):
+                bottles_location = self.source.locations.data.root / "bottles"
+
+            bottle_path = entry["bottle"]["path"]
+
+            additional_data = {}
+            if entry["thumbnail"]:
+                image_name = entry["thumbnail"].split(":")[1]
+                image_path = bottles_location / bottle_path / "grids" / image_name
+                additional_data = {"local_image_path": image_path}
+
+            yield (game, additional_data)
+
+
+class BottlesLocations(NamedTuple):
+    data: Location
+
+
+class BottlesSource(URLExecutableSource):
+    """Generic Bottles source"""
+
+    source_id = "bottles"
+    name = _("Bottles")
+    iterable_class = BottlesSourceIterable
+    url_format = 'bottles:run/"{bottle_name}"/"{game_name}"'
+    available_on = {"linux"}
+
+    locations: BottlesLocations
+
+    def __init__(self) -> None:
+        super().__init__()
+        self.locations = BottlesLocations(
+            Location(
+                schema_key="bottles-location",
+                candidates=(
+                    shared.flatpak_dir / "com.usebottles.bottles" / "data" / "bottles",
+                    shared.data_dir / "bottles/",
+                    shared.host_data_dir / "bottles",
+                ),
+                paths={
+                    "library.yml": LocationSubPath("library.yml"),
+                    "data.yml": LocationSubPath("data.yml"),
+                },
+                invalid_subtitle=Location.DATA_INVALID_SUBTITLE,
+            )
+        )

cartridges/importer/desktop_source.py

@@ -0,0 +1,223 @@
+# desktop_source.py
+#
+# Copyright 2023 kramo
+#
+# This program is free software: you can redistribute it and/or modify
+# it under the terms of the GNU General Public License as published by
+# the Free Software Foundation, either version 3 of the License, or
+# (at your option) any later version.
+#
+# This program is distributed in the hope that it will be useful,
+# but WITHOUT ANY WARRANTY; without even the implied warranty of
+# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+# GNU General Public License for more details.
+#
+# You should have received a copy of the GNU General Public License
+# along with this program.  If not, see <http://www.gnu.org/licenses/>.
+#
+# SPDX-License-Identifier: GPL-3.0-or-later
+
+import os
+import shlex
+import subprocess
+from pathlib import Path
+from typing import NamedTuple
+
+from gi.repository import GLib, Gtk
+
+from cartridges import shared
+from cartridges.game import Game
+from cartridges.importer.source import Source, SourceIterable
+
+
+class DesktopSourceIterable(SourceIterable):
+    source: "DesktopSource"
+
+    def __iter__(self):
+        """Generator method producing games"""
+
+        icon_theme = Gtk.IconTheme.new()
+
+        search_paths = [
+            shared.host_data_dir,
+            "/run/host/usr/local/share",
+            "/run/host/usr/share",
+            "/run/host/usr/share/pixmaps",
+            "/usr/share/pixmaps",
+        ] + GLib.get_system_data_dirs()
+
+        for search_path in search_paths:
+            path = Path(search_path)
+
+            if not str(search_path).endswith("/pixmaps"):
+                path = path / "icons"
+
+            if not path.is_dir():
+                continue
+
+            if str(path).startswith("/app/"):
+                continue
+
+            icon_theme.add_search_path(str(path))
+
+        launch_command, full_path = self.check_launch_commands()
+
+        for path in search_paths:
+            if str(path).startswith("/app/"):
+                continue
+
+            path = Path(path) / "applications"
+
+            if not path.is_dir():
+                continue
+
+            for entry in path.iterdir():
+                if entry.suffix != ".desktop":
+                    continue
+
+                # Skip Lutris games
+                if str(entry.name).startswith("net.lutris."):
+                    continue
+
+                keyfile = GLib.KeyFile.new()
+
+                try:
+                    keyfile.load_from_file(str(entry), 0)
+
+                    if "Game" not in keyfile.get_string_list(
+                        "Desktop Entry", "Categories"
+                    ):
+                        continue
+
+                    name = keyfile.get_string("Desktop Entry", "Name")
+                    executable = keyfile.get_string("Desktop Entry", "Exec").split(
+                        " %"
+                    )[0]
+                except GLib.Error:
+                    continue
+
+                try:
+                    try_exec = "which " + keyfile.get_string("Desktop Entry", "TryExec")
+                    if not self.check_command(try_exec):
+                        continue
+
+                except GLib.Error:
+                    pass
+
+                # Skip Steam games
+                if "steam://rungameid/" in executable:
+                    continue
+
+                # Skip Heroic games
+                if "heroic://launch/" in executable:
+                    continue
+
+                # Skip Bottles games
+                if "bottles-cli " in executable:
+                    continue
+
+                try:
+                    if keyfile.get_boolean("Desktop Entry", "NoDisplay"):
+                        continue
+                except GLib.Error:
+                    pass
+
+                try:
+                    if keyfile.get_boolean("Desktop Entry", "Hidden"):
+                        continue
+                except GLib.Error:
+                    pass
+
+                # Strip /run/host from Flatpak paths
+                if entry.is_relative_to(prefix := "/run/host"):
+                    entry = Path("/") / entry.relative_to(prefix)
+
+                launch_arg = shlex.quote(str(entry if full_path else entry.stem))
+
+                values = {
+                    "source": self.source.source_id,
+                    "added": shared.import_time,
+                    "name": name,
+                    "game_id": f"desktop_{entry.stem}",
+                    "executable": f"{launch_command} {launch_arg}",
+                }
+                game = Game(values)
+
+                additional_data = {}
+
+                try:
+                    icon_str = keyfile.get_string("Desktop Entry", "Icon")
+                except GLib.Error:
+                    yield game
+                    continue
+                else:
+                    if "/" in icon_str:
+                        additional_data = {"local_icon_path": Path(icon_str)}
+                        yield (game, additional_data)
+                        continue
+
+                try:
+                    if (
+                        icon_path := icon_theme.lookup_icon(
+                            icon_str,
+                            None,
+                            512,
+                            1,
+                            shared.win.get_direction(),
+                            0,
+                        )
+                        .get_file()
+                        .get_path()
+                    ):
+                        additional_data = {"local_icon_path": Path(icon_path)}
+                except GLib.Error:
+                    pass
+
+                yield (game, additional_data)
+
+    def check_command(self, command) -> bool:
+        flatpak_str = "flatpak-spawn --host /bin/sh -c "
+
+        if os.getenv("FLATPAK_ID") == shared.APP_ID:
+            command = flatpak_str + shlex.quote(command)
+
+        try:
+            subprocess.run(command, shell=True, check=True)
+        except subprocess.CalledProcessError:
+            return False
+
+        return True
+
+    def check_launch_commands(self) -> (str, bool):
+        """Check whether `gio launch` `gtk4-launch` or `gtk-launch` are available on the system"""
+        commands = (("gio launch", True), ("gtk4-launch", False), ("gtk-launch", False))
+
+        for command, full_path in commands:
+            # Even if `gio` is available, `gio launch` is only available on GLib >= 2.67.2
+            command_to_check = (
+                "gio help launch" if command == "gio launch" else f"which {command}"
+            )
+
+            if self.check_command(command_to_check):
+                return command, full_path
+
+        return commands[2]
+
+
+class DesktopLocations(NamedTuple):
+    pass
+
+
+class DesktopSource(Source):
+    """Generic Flatpak source"""
+
+    source_id = "desktop"
+    name = _("Desktop Entries")
+    iterable_class = DesktopSourceIterable
+    available_on = {"linux"}
+
+    locations: DesktopLocations
+
+    def __init__(self) -> None:
+        super().__init__()
+        self.locations = DesktopLocations()

cartridges/importer/flatpak_source.py

@@ -0,0 +1,166 @@
+# flatpak_source.py
+#
+# Copyright 2022-2023 kramo
+#
+# This program is free software: you can redistribute it and/or modify
+# it under the terms of the GNU General Public License as published by
+# the Free Software Foundation, either version 3 of the License, or
+# (at your option) any later version.
+#
+# This program is distributed in the hope that it will be useful,
+# but WITHOUT ANY WARRANTY; without even the implied warranty of
+# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+# GNU General Public License for more details.
+#
+# You should have received a copy of the GNU General Public License
+# along with this program.  If not, see <http://www.gnu.org/licenses/>.
+#
+# SPDX-License-Identifier: GPL-3.0-or-later
+
+from itertools import chain
+from pathlib import Path
+from typing import NamedTuple
+
+from gi.repository import GLib, Gtk
+
+from cartridges import shared
+from cartridges.game import Game
+from cartridges.importer.location import Location, LocationSubPath
+from cartridges.importer.source import ExecutableFormatSource, SourceIterable
+
+
+class FlatpakSourceIterable(SourceIterable):
+    source: "FlatpakSource"
+
+    def __iter__(self):
+        """Generator method producing games"""
+
+        icon_theme = Gtk.IconTheme.new()
+        if user_data := self.source.locations.user_data["icons"]:
+            icon_theme.add_search_path(str(user_data))
+
+        if system_data := self.source.locations.system_data["icons"]:
+            icon_theme.add_search_path(str(system_data))
+
+        if not (system_data or user_data):
+            return
+
+        blacklist = (
+            {"hu.kramo.Cartridges", "hu.kramo.Cartridges.Devel"}
+            if shared.schema.get_boolean("flatpak-import-launchers")
+            else {
+                "hu.kramo.Cartridges",
+                "hu.kramo.Cartridges.Devel",
+                "com.valvesoftware.Steam",
+                "net.lutris.Lutris",
+                "com.heroicgameslauncher.hgl",
+                "com.usebottles.Bottles",
+                "io.itch.itch",
+                "org.libretro.RetroArch",
+            }
+        )
+
+        generators = set(
+            location.iterdir()
+            for location in (
+                self.source.locations.user_data["applications"],
+                self.source.locations.system_data["applications"],
+            )
+            if location
+        )
+
+        for entry in chain(*generators):
+            if entry.suffix != ".desktop":
+                continue
+
+            keyfile = GLib.KeyFile.new()
+
+            try:
+                keyfile.load_from_file(str(entry), 0)
+
+                if "Game" not in keyfile.get_string_list("Desktop Entry", "Categories"):
+                    continue
+
+                if (
+                    flatpak_id := keyfile.get_string("Desktop Entry", "X-Flatpak")
+                ) in blacklist or flatpak_id != entry.stem:
+                    continue
+
+                name = keyfile.get_string("Desktop Entry", "Name")
+
+            except GLib.Error:
+                continue
+
+            values = {
+                "source": self.source.source_id,
+                "added": shared.import_time,
+                "name": name,
+                "game_id": self.source.game_id_format.format(game_id=flatpak_id),
+                "executable": self.source.make_executable(flatpak_id=flatpak_id),
+            }
+            game = Game(values)
+
+            additional_data = {}
+
+            try:
+                if (
+                    icon_path := icon_theme.lookup_icon(
+                        keyfile.get_string("Desktop Entry", "Icon"),
+                        None,
+                        512,
+                        1,
+                        shared.win.get_direction(),
+                        0,
+                    )
+                    .get_file()
+                    .get_path()
+                ):
+                    additional_data = {"local_icon_path": Path(icon_path)}
+                else:
+                    pass
+            except GLib.Error:
+                pass
+
+            yield (game, additional_data)
+
+
+class FlatpakLocations(NamedTuple):
+    system_data: Location
+    user_data: Location
+
+
+class FlatpakSource(ExecutableFormatSource):
+    """Generic Flatpak source"""
+
+    source_id = "flatpak"
+    name = _("Flatpak")
+    iterable_class = FlatpakSourceIterable
+    executable_format = "flatpak run {flatpak_id}"
+    available_on = {"linux"}
+
+    locations: FlatpakLocations
+
+    def __init__(self) -> None:
+        super().__init__()
+        self.locations = FlatpakLocations(
+            Location(
+                schema_key="flatpak-system-location",
+                candidates=("/var/lib/flatpak/",),
+                paths={
+                    "applications": LocationSubPath("exports/share/applications", True),
+                    "icons": LocationSubPath("exports/share/icons", True),
+                },
+                invalid_subtitle=Location.DATA_INVALID_SUBTITLE,
+                optional=True,
+            ),
+            Location(
+                schema_key="flatpak-user-location",
+                candidates=(shared.data_dir / "flatpak",),
+                paths={
+                    "applications": LocationSubPath("exports/share/applications", True),
+                    "icons": LocationSubPath("exports/share/icons", True),
+                },
+                invalid_subtitle=Location.DATA_INVALID_SUBTITLE,
+                optional=True,
+            ),
+        )

cartridges/importer/heroic_source.py

@@ -0,0 +1,387 @@
+# heroic_source.py
+#
+# Copyright 2022-2023 kramo
+# Copyright 2023 Geoffrey Coulaud
+#
+# This program is free software: you can redistribute it and/or modify
+# it under the terms of the GNU General Public License as published by
+# the Free Software Foundation, either version 3 of the License, or
+# (at your option) any later version.
+#
+# This program is distributed in the hope that it will be useful,
+# but WITHOUT ANY WARRANTY; without even the implied warranty of
+# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+# GNU General Public License for more details.
+#
+# You should have received a copy of the GNU General Public License
+# along with this program.  If not, see <http://www.gnu.org/licenses/>.
+#
+# SPDX-License-Identifier: GPL-3.0-or-later
+
+import json
+import logging
+from abc import abstractmethod
+from functools import cached_property
+from hashlib import sha256
+from json import JSONDecodeError
+from pathlib import Path
+from typing import Iterable, NamedTuple, Optional, TypedDict
+
+from cartridges import shared
+from cartridges.game import Game
+from cartridges.importer.location import Location, LocationSubPath
+from cartridges.importer.source import (
+    SourceIterable,
+    SourceIterationResult,
+    URLExecutableSource,
+)
+
+
+def path_json_load(path: Path):
+    """
+    Load JSON from the file at the given path
+
+    :raises OSError: if the file can't be opened
+    :raises JSONDecodeError: if the file isn't valid JSON
+    """
+    with path.open("r", encoding="utf-8") as open_file:
+        return json.load(open_file)
+
+
+class InvalidLibraryFileError(Exception):
+    pass
+
+
+class InvalidInstalledFileError(Exception):
+    pass
+
+
+class InvalidStoreFileError(Exception):
+    pass
+
+
+class HeroicLibraryEntry(TypedDict):
+    app_name: str
+    installed: Optional[bool]
+    runner: str
+    title: str
+    developer: str
+    art_square: str
+
+
+class SubSourceIterable(Iterable):
+    """Class representing a Heroic sub-source"""
+
+    source: "HeroicSource"
+    source_iterable: "HeroicSourceIterable"
+    name: str
+    service: str
+    image_uri_params: str = ""
+    relative_library_path: Path
+    library_json_entries_key: str = "library"
+
+    def __init__(self, source, source_iterable) -> None:
+        self.source = source
+        self.source_iterable = source_iterable
+
+    @cached_property
+    def library_path(self) -> Path:
+        path = self.source.locations.config.root / self.relative_library_path
+        logging.debug("Using Heroic %s library.json path %s", self.name, path)
+        return path
+
+    def process_library_entry(self, entry: HeroicLibraryEntry) -> SourceIterationResult:
+        """Build a Game from a Heroic library entry"""
+
+        app_name = entry["app_name"]
+        runner = entry["runner"]
+
+        # Build game
+        values = {
+            "source": f"{self.source.source_id}_{self.service}",
+            "added": shared.import_time,
+            "name": entry["title"],
+            "developer": entry.get("developer", None),
+            "game_id": self.source.game_id_format.format(
+                service=self.service, game_id=app_name
+            ),
+            "executable": self.source.make_executable(runner=runner, app_name=app_name),
+            "hidden": self.source_iterable.is_hidden(app_name),
+        }
+        game = Game(values)
+
+        # Get the image path from the Heroic cache
+        # Filenames are derived from the URL that Heroic used to get the file
+        uri: str = entry["art_square"] + self.image_uri_params
+        digest = sha256(uri.encode()).hexdigest()
+        image_path = self.source.locations.config.root / "images-cache" / digest
+        additional_data = {"local_image_path": image_path}
+
+        return (game, additional_data)
+
+    def __iter__(self):
+        """
+        Iterate through the games with a generator
+        :raises InvalidLibraryFileError: on initial call if the library file is bad
+        """
+
+        try:
+            iterator = iter(
+                path_json_load(self.library_path)[self.library_json_entries_key]
+            )
+        except (OSError, JSONDecodeError, TypeError, KeyError) as error:
+            raise InvalidLibraryFileError(
+                f"Invalid {self.library_path.name}"
+            ) from error
+        for entry in iterator:
+            try:
+                yield self.process_library_entry(entry)
+            except KeyError as error:
+                logging.warning(
+                    "Skipped invalid %s game %s",
+                    self.name,
+                    entry.get("app_name", "UNKNOWN"),
+                    exc_info=error,
+                )
+                continue
+
+
+class StoreSubSourceIterable(SubSourceIterable):
+    """
+    Class representing a "store" sub source.
+    Games can be installed or not, this class does the check accordingly.
+    """
+
+    relative_installed_path: Path
+    installed_app_names: set[str]
+
+    @cached_property
+    def installed_path(self) -> Path:
+        path = self.source.locations.config.root / self.relative_installed_path
+        logging.debug("Using Heroic %s installed.json path %s", self.name, path)
+        return path
+
+    @abstractmethod
+    def get_installed_app_names(self) -> set[str]:
+        """
+        Get the sub source's installed app names as a set.
+
+        :raises InvalidInstalledFileError: if the installed file data cannot be read
+            Whenever possible, `__cause__` is set with the original exception
+        """
+
+    def is_installed(self, app_name: str) -> bool:
+        return app_name in self.installed_app_names
+
+    def process_library_entry(self, entry):
+        # Skip games that are not installed
+        app_name = entry["app_name"]
+        if not self.is_installed(app_name):
+            logging.warning(
+                "Skipped %s game %s (%s): not installed",
+                self.service,
+                entry["title"],
+                app_name,
+            )
+            return None
+        # Process entry as normal
+        return super().process_library_entry(entry)
+
+    def __iter__(self):
+        """
+        Iterate through the installed games with a generator
+        :raises InvalidLibraryFileError: on initial call if the library file is bad
+        :raises InvalidInstalledFileError: on initial call if the installed file is bad
+        """
+        self.installed_app_names = self.get_installed_app_names()
+        yield from super().__iter__()
+
+
+class SideloadIterable(SubSourceIterable):
+    name = "sideload"
+    service = "sideload"
+    relative_library_path = Path("sideload_apps") / "library.json"
+    library_json_entries_key = "games"
+
+
+class LegendaryIterable(StoreSubSourceIterable):
+    name = "legendary"
+    service = "epic"
+    image_uri_params = "?h=400&resize=1&w=300"
+    relative_library_path = Path("store_cache") / "legendary_library.json"
+
+    # relative_installed_path = (
+    #    Path("legendary") / "legendaryConfig" / "legendary" / "installed.json"
+    # )
+
+    @cached_property
+    def installed_path(self) -> Path:
+        """Get the right path depending on the Heroic version"""
+        # TODO after Heroic 2.9 has been out for a while
+        # We should use the commented out relative_installed_path
+        # and remove this property override.
+
+        heroic_config_path = self.source.locations.config.root
+        # Heroic >= 2.9
+        if (path := heroic_config_path / "legendaryConfig").is_dir():
+            logging.debug("Using Heroic >= 2.9 legendary file")
+        # Heroic <= 2.8
+        elif heroic_config_path.is_relative_to(shared.flatpak_dir):
+            # Heroic flatpak
+            path = shared.flatpak_dir / "com.heroicgameslauncher.hgl" / "config"
+            logging.debug("Using Heroic flatpak <= 2.8 legendary file")
+        else:
+            # Heroic native
+            logging.debug("Using Heroic native <= 2.8 legendary file")
+            path = shared.host_config_dir
+
+        path = path / "legendary" / "installed.json"
+        logging.debug("Using Heroic %s installed.json path %s", self.name, path)
+        return path
+
+    def get_installed_app_names(self):
+        try:
+            return set(path_json_load(self.installed_path).keys())
+        except (OSError, JSONDecodeError, AttributeError) as error:
+            raise InvalidInstalledFileError(
+                f"Invalid {self.installed_path.name}"
+            ) from error
+
+
+class GogIterable(StoreSubSourceIterable):
+    name = "gog"
+    service = "gog"
+    library_json_entries_key = "games"
+    relative_library_path = Path("store_cache") / "gog_library.json"
+    relative_installed_path = Path("gog_store") / "installed.json"
+
+    def get_installed_app_names(self):
+        try:
+            return {
+                app_name
+                for entry in path_json_load(self.installed_path)["installed"]
+                if (app_name := entry.get("appName")) is not None
+            }
+        except (OSError, JSONDecodeError, KeyError, AttributeError) as error:
+            raise InvalidInstalledFileError(
+                f"Invalid {self.installed_path.name}"
+            ) from error
+
+
+class NileIterable(StoreSubSourceIterable):
+    name = "nile"
+    service = "amazon"
+    relative_library_path = Path("store_cache") / "nile_library.json"
+    relative_installed_path = Path("nile_config") / "nile" / "installed.json"
+
+    def get_installed_app_names(self):
+        try:
+            installed_json = path_json_load(self.installed_path)
+            return {
+                app_name
+                for entry in installed_json
+                if (app_name := entry.get("id")) is not None
+            }
+        except (OSError, JSONDecodeError, AttributeError) as error:
+            raise InvalidInstalledFileError(
+                f"Invalid {self.installed_path.name}"
+            ) from error
+
+
+class HeroicSourceIterable(SourceIterable):
+    source: "HeroicSource"
+
+    hidden_app_names: set[str] = set()
+
+    def is_hidden(self, app_name: str) -> bool:
+        return app_name in self.hidden_app_names
+
+    def get_hidden_app_names(self) -> set[str]:
+        """Get the hidden app names from store/config.json
+
+        :raises InvalidStoreFileError: if the store is invalid for some reason
+        """
+
+        try:
+            store = path_json_load(self.source.locations.config["store_config.json"])
+            self.hidden_app_names = {
+                app_name
+                for game in store["games"]["hidden"]
+                if (app_name := game.get("appName")) is not None
+            }
+        except KeyError:
+            logging.warning('No ["games"]["hidden"] key in Heroic store file')
+        except (OSError, JSONDecodeError, TypeError) as error:
+            logging.error("Invalid Heroic store file", exc_info=error)
+            raise InvalidStoreFileError() from error
+
+    def __iter__(self):
+        """Generator method producing games from all the Heroic sub-sources"""
+
+        self.get_hidden_app_names()
+
+        # Get games from the sub sources
+        for sub_source_class in (
+            SideloadIterable,
+            LegendaryIterable,
+            GogIterable,
+            NileIterable,
+        ):
+            sub_source = sub_source_class(self.source, self)
+
+            if not shared.schema.get_boolean("heroic-import-" + sub_source.service):
+                logging.debug("Skipping Heroic %s: disabled", sub_source.service)
+                continue
+            try:
+                sub_source_iterable = iter(sub_source)
+                yield from sub_source_iterable
+            except (InvalidLibraryFileError, InvalidInstalledFileError) as error:
+                logging.error(
+                    "Skipping bad Heroic sub-source %s",
+                    sub_source.service,
+                    exc_info=error,
+                )
+                continue
+
+
+class HeroicLocations(NamedTuple):
+    config: Location
+
+
+class HeroicSource(URLExecutableSource):
+    """Generic Heroic Games Launcher source"""
+
+    source_id = "heroic"
+    name = _("Heroic")
+    iterable_class = HeroicSourceIterable
+    url_format = "heroic://launch/{runner}/{app_name}"
+    available_on = {"linux", "win32"}
+
+    locations: HeroicLocations
+
+    @property
+    def game_id_format(self) -> str:
+        """The string format used to construct game IDs"""
+        return self.source_id + "_{service}_{game_id}"
+
+    def __init__(self) -> None:
+        super().__init__()
+        self.locations = HeroicLocations(
+            Location(
+                schema_key="heroic-location",
+                candidates=(
+                    shared.config_dir / "heroic",
+                    shared.host_config_dir / "heroic",
+                    shared.flatpak_dir
+                    / "com.heroicgameslauncher.hgl"
+                    / "config"
+                    / "heroic",
+                    shared.appdata_dir / "heroic",
+                ),
+                paths={
+                    "config.json": LocationSubPath("config.json"),
+                    "store_config.json": LocationSubPath("store/config.json"),
+                },
+                invalid_subtitle=Location.CONFIG_INVALID_SUBTITLE,
+            )
+        )

cartridges/importer/importer.py

@@ -0,0 +1,428 @@
+# importer.py
+#
+# Copyright 2022-2023 kramo
+# Copyright 2023 Geoffrey Coulaud
+#
+# This program is free software: you can redistribute it and/or modify
+# it under the terms of the GNU General Public License as published by
+# the Free Software Foundation, either version 3 of the License, or
+# (at your option) any later version.
+#
+# This program is distributed in the hope that it will be useful,
+# but WITHOUT ANY WARRANTY; without even the implied warranty of
+# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+# GNU General Public License for more details.
+#
+# You should have received a copy of the GNU General Public License
+# along with this program.  If not, see <http://www.gnu.org/licenses/>.
+#
+# SPDX-License-Identifier: GPL-3.0-or-later
+
+import logging
+from time import time
+from typing import Any, Optional
+
+from gi.repository import Adw, Gio, GLib, Gtk
+
+from cartridges import shared
+from cartridges.errors.error_producer import ErrorProducer
+from cartridges.errors.friendly_error import FriendlyError
+from cartridges.game import Game
+from cartridges.importer.location import UnresolvableLocationError
+from cartridges.importer.source import Source
+from cartridges.store.managers.async_manager import AsyncManager
+from cartridges.store.pipeline import Pipeline
+
+
+# pylint: disable=too-many-instance-attributes
+class Importer(ErrorProducer):
+    """A class in charge of scanning sources for games"""
+
+    progressbar: Gtk.ProgressBar
+    import_statuspage: Adw.StatusPage
+    import_dialog: Adw.MessageDialog
+    summary_toast: Optional[Adw.Toast] = None
+
+    sources: set[Source]
+
+    n_source_tasks_created: int = 0
+    n_source_tasks_done: int = 0
+    n_pipelines_done: int = 0
+    game_pipelines: set[Pipeline]
+
+    removed_game_ids: set[str]
+    imported_game_ids: set[str]
+
+    close_req_id: int
+
+    def __init__(self) -> None:
+        super().__init__()
+
+        shared.import_time = int(time())
+
+        # TODO: make this stateful
+        shared.store.new_game_ids = set()
+        shared.store.duplicate_game_ids = set()
+
+        self.removed_game_ids = set()
+        self.imported_game_ids = set()
+
+        self.game_pipelines = set()
+        self.sources = set()
+
+    @property
+    def n_games_added(self) -> int:
+        return sum(
+            1 if not (pipeline.game.blacklisted or pipeline.game.removed) else 0
+            for pipeline in self.game_pipelines
+        )
+
+    @property
+    def pipelines_progress(self) -> float:
+        progress = sum(pipeline.progress for pipeline in self.game_pipelines)
+        try:
+            progress = progress / len(self.game_pipelines)
+        except ZeroDivisionError:
+            progress = 0
+        return progress  # type: ignore
+
+    @property
+    def sources_progress(self) -> float:
+        try:
+            progress = self.n_source_tasks_done / self.n_source_tasks_created
+        except ZeroDivisionError:
+            progress = 0
+        return progress
+
+    @property
+    def finished(self) -> bool:
+        return (
+            self.n_source_tasks_created == self.n_source_tasks_done
+            and len(self.game_pipelines) == self.n_pipelines_done
+        )
+
+    def add_source(self, source: Source) -> None:
+        self.sources.add(source)
+
+    def run(self) -> None:
+        """Use several Gio.Task to import games from added sources"""
+
+        shared.win.get_application().state = shared.AppState.IMPORT
+
+        if self.__class__.summary_toast:
+            self.__class__.summary_toast.dismiss()
+
+        shared.win.get_application().lookup_action("import").set_enabled(False)
+        shared.win.get_application().lookup_action("add_game").set_enabled(False)
+
+        self.create_dialog()
+
+        # Collect all errors and reset the cancellables for the managers
+        # - Only one importer exists at any given time
+        # - Every import starts fresh
+        self.collect_errors()
+        for manager in shared.store.managers.values():
+            manager.collect_errors()
+            if isinstance(manager, AsyncManager):
+                manager.reset_cancellable()
+
+        for source in self.sources:
+            logging.debug("Importing games from source %s", source.source_id)
+            task = Gio.Task.new(None, None, self.source_callback, (source,))
+            self.n_source_tasks_created += 1
+            task.run_in_thread(
+                lambda _task, _obj, _data, _cancellable, src=source: self.source_task_thread_func(
+                    (src,)
+                )
+            )
+
+        self.progress_changed_callback()
+
+    def create_dialog(self) -> None:
+        """Create the import dialog"""
+        self.progressbar = Gtk.ProgressBar(margin_start=12, margin_end=12)
+        self.import_statuspage = Adw.StatusPage(
+            title=_("Importing Games…"),
+            child=self.progressbar,
+        )
+        self.import_dialog = Adw.Window(
+            content=self.import_statuspage,
+            modal=True,
+            default_width=350,
+            default_height=-1,
+            transient_for=shared.win,
+            deletable=False,
+        )
+
+        self.close_req_id = self.import_dialog.connect(
+            "close-request", lambda *_: shared.win.close()
+        )
+
+        self.import_dialog.present()
+
+    def source_task_thread_func(self, data: tuple) -> None:
+        """Source import task code"""
+
+        source: Source
+        source, *_rest = data
+
+        # Early exit if not available or not installed
+        if not source.is_available:
+            logging.info("Source %s skipped, not available", source.source_id)
+            return
+        try:
+            iterator = iter(source)
+        except UnresolvableLocationError:
+            logging.info("Source %s skipped, bad location", source.source_id)
+            return
+
+        # Get games from source
+        logging.info("Scanning source %s", source.source_id)
+        while True:
+            # Handle exceptions raised when iterating
+            try:
+                iteration_result = next(iterator)
+            except StopIteration:
+                break
+            except Exception as error:  # pylint: disable=broad-exception-caught
+                logging.exception("%s in %s", type(error).__name__, source.source_id)
+                self.report_error(error)
+                continue
+
+            # Handle the result depending on its type
+            if isinstance(iteration_result, Game):
+                game = iteration_result
+                additional_data = {}
+            elif isinstance(iteration_result, tuple):
+                game, additional_data = iteration_result
+            elif iteration_result is None:
+                continue
+            else:
+                # Warn source implementers that an invalid type was produced
+                # Should not happen on production code
+                logging.warning(
+                    "%s produced an invalid iteration return type %s",
+                    source.source_id,
+                    type(iteration_result),
+                )
+                continue
+
+            # Register game
+            pipeline: Pipeline = shared.store.add_game(game, additional_data)
+            if pipeline is not None:
+                logging.info("Imported %s (%s)", game.name, game.game_id)
+                pipeline.connect(
+                    "advanced",
+                    # I'm not sure idle_add is needed here, but a widget is updated in the callback
+                    lambda *args: GLib.idle_add(self.pipeline_advanced_callback, *args),
+                )
+                self.game_pipelines.add(pipeline)
+
+    def update_progressbar(self) -> None:
+        """Update the progressbar to show the overall import progress"""
+        # Reserve 10% for the sources discovery, the rest is the pipelines
+        self.progressbar.set_fraction(
+            (0.1 * self.sources_progress) + (0.9 * self.pipelines_progress)
+        )
+
+    def source_callback(self, _obj: Any, _result: Any, data: tuple) -> None:
+        """Callback executed when a source is fully scanned"""
+        source, *_rest = data
+        logging.debug("Import done for source %s", source.source_id)
+        self.n_source_tasks_done += 1
+        self.progress_changed_callback()
+
+    def pipeline_advanced_callback(self, pipeline: Pipeline) -> None:
+        """Callback called when a pipeline for a game has advanced"""
+        if pipeline.is_done:
+            self.n_pipelines_done += 1
+            self.progress_changed_callback()
+
+    def progress_changed_callback(self) -> None:
+        """
+        Callback called when the import process has progressed
+
+        Triggered when:
+        * All sources have been started
+        * A source finishes
+        * A pipeline finishes
+        """
+        self.update_progressbar()
+        if self.finished:
+            self.import_callback()
+
+    def remove_games(self) -> None:
+        """Set removed to True for missing games"""
+        if not shared.schema.get_boolean("remove-missing"):
+            return
+
+        for game in shared.store:
+            if game.removed:
+                continue
+            if game.source == "imported":
+                continue
+            if not shared.schema.get_boolean(game.base_source):
+                continue
+            if game.game_id in shared.store.duplicate_game_ids:
+                continue
+            if game.game_id in shared.store.new_game_ids:
+                continue
+
+            logging.debug("Removing missing game %s (%s)", game.name, game.game_id)
+
+            game.removed = True
+            game.save()
+            game.update()
+            self.removed_game_ids.add(game.game_id)
+
+    def import_callback(self) -> None:
+        """Callback called when importing has finished"""
+        logging.info("Import done")
+        self.remove_games()
+        self.imported_game_ids = shared.store.new_game_ids
+        shared.store.new_game_ids = set()
+        shared.store.duplicate_game_ids = set()
+        # Disconnect the close-request signal that closes the main window
+        self.import_dialog.disconnect(self.close_req_id)
+        self.import_dialog.close()
+        self.__class__.summary_toast = self.create_summary_toast()
+        self.create_error_dialog()
+        shared.win.get_application().lookup_action("import").set_enabled(True)
+        shared.win.get_application().lookup_action("add_game").set_enabled(True)
+        shared.win.get_application().state = shared.AppState.DEFAULT
+        shared.win.create_source_rows()
+
+    def create_error_dialog(self) -> None:
+        """Dialog containing all errors raised by importers"""
+
+        # Collect all errors that happened in the importer and the managers
+        errors = []
+        errors.extend(self.collect_errors())
+        for manager in shared.store.managers.values():
+            errors.extend(manager.collect_errors())
+
+        # Filter out non friendly errors
+        errors = set(
+            tuple(
+                (error.title, error.subtitle)
+                for error in (
+                    filter(lambda error: isinstance(error, FriendlyError), errors)
+                )
+            )
+        )
+
+        # No error to display
+        if not errors:
+            self.timeout_toast()
+            return
+
+        # Create error dialog
+        dialog = Adw.MessageDialog()
+        dialog.set_heading(_("Warning"))
+        dialog.add_response("close", _("Dismiss"))
+        dialog.add_response("open_preferences_import", _("Preferences"))
+        dialog.set_default_response("open_preferences_import")
+        dialog.connect("response", self.dialog_response_callback)
+        dialog.set_transient_for(shared.win)
+
+        if len(errors) == 1:
+            dialog.set_heading((error := next(iter(errors)))[0])
+            dialog.set_body(error[1])
+        else:
+            # Display the errors in a list
+            list_box = Gtk.ListBox()
+            list_box.set_selection_mode(Gtk.SelectionMode.NONE)
+            list_box.set_css_classes(["boxed-list"])
+            list_box.set_margin_top(9)
+            for error in errors:
+                row = Adw.ActionRow.new()
+                row.set_title(error[0])
+                row.set_subtitle(error[1])
+                list_box.append(row)
+            dialog.set_body(_("The following errors occured during import:"))
+            dialog.set_extra_child(list_box)
+
+        dialog.present()
+
+    def undo_import(self, *_args: Any) -> None:
+        for game_id in self.imported_game_ids:
+            shared.store[game_id].removed = True
+            shared.store[game_id].update()
+            shared.store[game_id].save()
+
+        for game_id in self.removed_game_ids:
+            shared.store[game_id].removed = False
+            shared.store[game_id].update()
+            shared.store[game_id].save()
+
+        self.imported_game_ids = set()
+        self.removed_game_ids = set()
+        if self.__class__.summary_toast:
+            self.__class__.summary_toast.dismiss()
+
+        logging.info("Import undone")
+
+    def create_summary_toast(self) -> Adw.Toast:
+        """N games imported, removed toast"""
+
+        toast = Adw.Toast(timeout=0, priority=Adw.ToastPriority.HIGH)
+
+        if not self.n_games_added:
+            toast_title = _("No new games found")
+
+            if not self.removed_game_ids:
+                toast.set_button_label(_("Preferences"))
+                toast.connect(
+                    "button-clicked",
+                    self.dialog_response_callback,
+                    "open_preferences",
+                    "import",
+                )
+
+        elif self.n_games_added == 1:
+            toast_title = _("1 game imported")
+
+        elif self.n_games_added > 1:
+            # The variable is the number of games
+            toast_title = _("{} games imported").format(self.n_games_added)
+
+        if (removed_length := len(self.removed_game_ids)) == 1:
+            # A single game removed
+            toast_title += ", " + _("1 removed")
+
+        elif removed_length > 1:
+            # The variable is the number of games removed
+            toast_title += ", " + _("{} removed").format(removed_length)
+
+        if self.n_games_added or self.removed_game_ids:
+            toast.set_button_label(_("Undo"))
+            toast.connect("button-clicked", self.undo_import)
+
+        toast.set_title(toast_title)
+
+        shared.win.toast_overlay.add_toast(toast)
+        return toast
+
+    def open_preferences(
+        self,
+        page_name: Optional[str] = None,
+        expander_row: Optional[Adw.ExpanderRow] = None,
+    ) -> Adw.PreferencesWindow:
+        return shared.win.get_application().on_preferences_action(
+            page_name=page_name, expander_row=expander_row
+        )
+
+    def timeout_toast(self, *_args: Any) -> None:
+        """Manually timeout the toast after the user has dismissed all warnings"""
+        if self.__class__.summary_toast:
+            GLib.timeout_add_seconds(5, self.__class__.summary_toast.dismiss)
+
+    def dialog_response_callback(self, _widget: Any, response: str, *args: Any) -> None:
+        """Handle after-import dialogs callback"""
+        logging.debug("After-import dialog response: %s (%s)", response, str(args))
+        if response == "open_preferences":
+            self.open_preferences(*args)
+        elif response == "open_preferences_import":
+            self.open_preferences(*args).connect("close-request", self.timeout_toast)
+        else:
+            self.timeout_toast()

cartridges/importer/itch_source.py

@@ -0,0 +1,104 @@
+# itch_source.py
+#
+# Copyright 2022-2023 kramo
+# Copyright 2023 Geoffrey Coulaud
+#
+# This program is free software: you can redistribute it and/or modify
+# it under the terms of the GNU General Public License as published by
+# the Free Software Foundation, either version 3 of the License, or
+# (at your option) any later version.
+#
+# This program is distributed in the hope that it will be useful,
+# but WITHOUT ANY WARRANTY; without even the implied warranty of
+# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+# GNU General Public License for more details.
+#
+# You should have received a copy of the GNU General Public License
+# along with this program.  If not, see <http://www.gnu.org/licenses/>.
+#
+# SPDX-License-Identifier: GPL-3.0-or-later
+
+from shutil import rmtree
+from sqlite3 import connect
+from typing import NamedTuple
+
+from cartridges import shared
+from cartridges.game import Game
+from cartridges.importer.location import Location, LocationSubPath
+from cartridges.importer.source import SourceIterable, URLExecutableSource
+from cartridges.utils.sqlite import copy_db
+
+
+class ItchSourceIterable(SourceIterable):
+    source: "ItchSource"
+
+    def __iter__(self):
+        """Generator method producing games"""
+
+        # Query the database
+        db_request = """
+        SELECT
+            games.id,
+            games.title,
+            games.cover_url,
+            games.still_cover_url,
+            caves.id
+        FROM
+            'caves'
+        INNER JOIN
+            'games'
+        ON
+            caves.game_id = games.id
+        ;
+        """
+        db_path = copy_db(self.source.locations.config["butler.db"])
+        connection = connect(db_path)
+        cursor = connection.execute(db_request)
+
+        # Create games from the db results
+        for row in cursor:
+            values = {
+                "added": shared.import_time,
+                "source": self.source.source_id,
+                "name": row[1],
+                "game_id": self.source.game_id_format.format(game_id=row[0]),
+                "executable": self.source.make_executable(cave_id=row[4]),
+            }
+            additional_data = {"online_cover_url": row[3] or row[2]}
+            game = Game(values)
+            yield (game, additional_data)
+
+        # Cleanup
+        rmtree(str(db_path.parent))
+
+
+class ItchLocations(NamedTuple):
+    config: Location
+
+
+class ItchSource(URLExecutableSource):
+    source_id = "itch"
+    name = _("itch")
+    iterable_class = ItchSourceIterable
+    url_format = "itch://caves/{cave_id}/launch"
+    available_on = {"linux", "win32"}
+
+    locations: ItchLocations
+
+    def __init__(self) -> None:
+        super().__init__()
+        self.locations = ItchLocations(
+            Location(
+                schema_key="itch-location",
+                candidates=(
+                    shared.flatpak_dir / "io.itch.itch" / "config" / "itch",
+                    shared.config_dir / "itch",
+                    shared.host_config_dir / "itch",
+                    shared.appdata_dir / "itch",
+                ),
+                paths={
+                    "butler.db": LocationSubPath("db/butler.db"),
+                },
+                invalid_subtitle=Location.CONFIG_INVALID_SUBTITLE,
+            )
+        )

cartridges/importer/legendary_source.py

@@ -0,0 +1,119 @@
+# legendary_source.py
+#
+# Copyright 2023 Geoffrey Coulaud
+#
+# This program is free software: you can redistribute it and/or modify
+# it under the terms of the GNU General Public License as published by
+# the Free Software Foundation, either version 3 of the License, or
+# (at your option) any later version.
+#
+# This program is distributed in the hope that it will be useful,
+# but WITHOUT ANY WARRANTY; without even the implied warranty of
+# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+# GNU General Public License for more details.
+#
+# You should have received a copy of the GNU General Public License
+# along with this program.  If not, see <http://www.gnu.org/licenses/>.
+#
+# SPDX-License-Identifier: GPL-3.0-or-later
+
+import json
+import logging
+from json import JSONDecodeError
+from typing import NamedTuple
+
+from cartridges import shared
+from cartridges.game import Game
+from cartridges.importer.location import Location, LocationSubPath
+from cartridges.importer.source import (
+    ExecutableFormatSource,
+    SourceIterable,
+    SourceIterationResult,
+)
+
+
+class LegendarySourceIterable(SourceIterable):
+    source: "LegendarySource"
+
+    def game_from_library_entry(self, entry: dict) -> SourceIterationResult:
+        # Skip non-games
+        if entry["is_dlc"]:
+            return None
+
+        # Build game
+        app_name = entry["app_name"]
+        values = {
+            "added": shared.import_time,
+            "source": self.source.source_id,
+            "name": entry["title"],
+            "game_id": self.source.game_id_format.format(game_id=app_name),
+            "executable": self.source.make_executable(app_name=app_name),
+        }
+        data = {}
+
+        # Get additional metadata from file (optional)
+        metadata_file = self.source.locations.config["metadata"] / f"{app_name}.json"
+        try:
+            metadata = json.load(metadata_file.open())
+            values["developer"] = metadata["metadata"]["developer"]
+            for image_entry in metadata["metadata"]["keyImages"]:
+                if image_entry["type"] == "DieselGameBoxTall":
+                    data["online_cover_url"] = image_entry["url"]
+                    break
+        except (JSONDecodeError, OSError, KeyError):
+            pass
+
+        game = Game(values)
+        return (game, data)
+
+    def __iter__(self):
+        # Open library
+        file = self.source.locations.config["installed.json"]
+        try:
+            library: dict = json.load(file.open())
+        except (JSONDecodeError, OSError):
+            logging.warning("Couldn't open Legendary file: %s", str(file))
+            return
+
+        # Generate games from library
+        for entry in library.values():
+            try:
+                result = self.game_from_library_entry(entry)
+            except KeyError as error:
+                # Skip invalid games
+                logging.warning(
+                    "Invalid Legendary game skipped in %s", str(file), exc_info=error
+                )
+                continue
+            yield result
+
+
+class LegendaryLocations(NamedTuple):
+    config: Location
+
+
+class LegendarySource(ExecutableFormatSource):
+    source_id = "legendary"
+    name = _("Legendary")
+    executable_format = "legendary launch {app_name}"
+    available_on = {"linux"}
+    iterable_class = LegendarySourceIterable
+
+    locations: LegendaryLocations
+
+    def __init__(self) -> None:
+        super().__init__()
+        self.locations = LegendaryLocations(
+            Location(
+                schema_key="legendary-location",
+                candidates=(
+                    shared.config_dir / "legendary",
+                    shared.host_config_dir / "legendary",
+                ),
+                paths={
+                    "installed.json": LocationSubPath("installed.json"),
+                    "metadata": LocationSubPath("metadata", True),
+                },
+                invalid_subtitle=Location.CONFIG_INVALID_SUBTITLE,
+            )
+        )

cartridges/importer/location.py

@@ -0,0 +1,111 @@
+import logging
+from os import PathLike
+from pathlib import Path
+from typing import Iterable, Mapping, NamedTuple, Optional
+
+from cartridges import shared
+
+PathSegment = str | PathLike | Path
+PathSegments = Iterable[PathSegment]
+Candidate = PathSegments
+
+
+class LocationSubPath(NamedTuple):
+    segment: PathSegment
+    is_directory: bool = False
+
+
+class UnresolvableLocationError(Exception):
+    def __init__(self, optional: Optional[bool] = False):
+        self.optional = optional
+
+
+class Location:
+    """
+    Class representing a filesystem location
+
+    * A location may have multiple candidate roots
+    * The path in the schema is always favored
+    * From the candidate root, multiple subpaths should exist for it to be valid
+    * When resolved, the schema is updated with the picked chosen
+    """
+
+    # The variable is the name of the source
+    CACHE_INVALID_SUBTITLE = _("Select the {} cache directory.")
+    # The variable is the name of the source
+    CONFIG_INVALID_SUBTITLE = _("Select the {} configuration directory.")
+    # The variable is the name of the source
+    DATA_INVALID_SUBTITLE = _("Select the {} data directory.")
+
+    schema_key: str
+    candidates: Iterable[Candidate]
+    paths: Mapping[str, LocationSubPath]
+    invalid_subtitle: str
+
+    root: Optional[Path] = None
+
+    def __init__(
+        self,
+        schema_key: str,
+        candidates: Iterable[Candidate],
+        paths: Mapping[str, LocationSubPath],
+        invalid_subtitle: str,
+        optional: Optional[bool] = False,
+    ) -> None:
+        super().__init__()
+        self.schema_key = schema_key
+        self.candidates = candidates
+        self.paths = paths
+        self.invalid_subtitle = invalid_subtitle
+        self.optional = optional
+
+    def check_candidate(self, candidate: Path) -> bool:
+        """Check if a candidate root has the necessary files and directories"""
+        for segment, is_directory in self.paths.values():
+            path = Path(candidate) / segment
+            if is_directory:
+                if not path.is_dir():
+                    return False
+            else:
+                if not path.is_file():
+                    return False
+        return True
+
+    def resolve(self) -> None:
+        """Choose a root path from the candidates for the location.
+        If none fits, raise an UnresolvableLocationError"""
+
+        if self.root is not None:
+            return
+
+        # Get the schema candidate
+        schema_candidate = shared.schema.get_string(self.schema_key)
+
+        # Find the first matching candidate
+        for candidate in (schema_candidate, *self.candidates):
+            candidate = Path(candidate).expanduser()
+            if not self.check_candidate(candidate):
+                continue
+            self.root = candidate
+            break
+        else:
+            # No good candidate found
+            raise UnresolvableLocationError(self.optional)
+
+        # Update the schema with the found candidate
+        value = str(candidate)
+        shared.schema.set_string(self.schema_key, value)
+        logging.debug("Resolved value for schema key %s: %s", self.schema_key, value)
+
+    def __getitem__(self, key: str) -> Optional[Path]:
+        """Get the computed path from its key for the location"""
+        try:
+            self.resolve()
+        except UnresolvableLocationError as error:
+            if error.optional:
+                return None
+            raise UnresolvableLocationError from error
+
+        if self.root:
+            return self.root / self.paths[key].segment
+        return None

cartridges/importer/lutris_source.py

@@ -0,0 +1,118 @@
+# lutris_source.py
+#
+# Copyright 2022-2023 kramo
+# Copyright 2023 Geoffrey Coulaud
+#
+# This program is free software: you can redistribute it and/or modify
+# it under the terms of the GNU General Public License as published by
+# the Free Software Foundation, either version 3 of the License, or
+# (at your option) any later version.
+#
+# This program is distributed in the hope that it will be useful,
+# but WITHOUT ANY WARRANTY; without even the implied warranty of
+# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+# GNU General Public License for more details.
+#
+# You should have received a copy of the GNU General Public License
+# along with this program.  If not, see <http://www.gnu.org/licenses/>.
+#
+# SPDX-License-Identifier: GPL-3.0-or-later
+from shutil import rmtree
+from sqlite3 import connect
+from typing import NamedTuple
+
+from cartridges import shared
+from cartridges.game import Game
+from cartridges.importer.location import Location, LocationSubPath
+from cartridges.importer.source import SourceIterable, URLExecutableSource
+from cartridges.utils.sqlite import copy_db
+
+
+class LutrisSourceIterable(SourceIterable):
+    source: "LutrisSource"
+
+    def __iter__(self):
+        """Generator method producing games"""
+
+        # Query the database
+        request = """
+            SELECT id, name, slug, runner, hidden
+            FROM 'games'
+            WHERE
+                name IS NOT NULL
+                AND slug IS NOT NULL
+                AND configPath IS NOT NULL
+                AND installed
+                AND (runner IS NOT "steam" OR :import_steam)
+                AND (runner IS NOT "flatpak" OR :import_flatpak)
+            ;
+        """
+        params = {
+            "import_steam": shared.schema.get_boolean("lutris-import-steam"),
+            "import_flatpak": shared.schema.get_boolean("lutris-import-flatpak"),
+        }
+        db_path = copy_db(self.source.locations.data["pga.db"])
+        connection = connect(db_path)
+        cursor = connection.execute(request, params)
+
+        # Create games from the DB results
+        for row in cursor:
+            # Create game
+            values = {
+                "added": shared.import_time,
+                "hidden": row[4],
+                "name": row[1],
+                "source": f"{self.source.source_id}_{row[3]}",
+                "game_id": self.source.game_id_format.format(
+                    runner=row[3], game_id=row[0]
+                ),
+                "executable": self.source.make_executable(game_id=row[0]),
+            }
+            game = Game(values)
+
+            # Get official image path
+            image_path = self.source.locations.data["coverart"] / f"{row[2]}.jpg"
+            additional_data = {"local_image_path": image_path}
+
+            yield (game, additional_data)
+
+        # Cleanup
+        rmtree(str(db_path.parent))
+
+
+class LutrisLocations(NamedTuple):
+    data: Location
+
+
+class LutrisSource(URLExecutableSource):
+    """Generic Lutris source"""
+
+    source_id = "lutris"
+    name = _("Lutris")
+    iterable_class = LutrisSourceIterable
+    url_format = "lutris:rungameid/{game_id}"
+    available_on = {"linux"}
+
+    locations: LutrisLocations
+
+    @property
+    def game_id_format(self):
+        return self.source_id + "_{runner}_{game_id}"
+
+    def __init__(self) -> None:
+        super().__init__()
+        self.locations = LutrisLocations(
+            Location(
+                schema_key="lutris-location",
+                candidates=(
+                    shared.flatpak_dir / "net.lutris.Lutris" / "data" / "lutris",
+                    shared.data_dir / "lutris",
+                    shared.host_data_dir / "lutris",
+                ),
+                paths={
+                    "pga.db": LocationSubPath("pga.db"),
+                    "coverart": LocationSubPath("coverart", True),
+                },
+                invalid_subtitle=Location.DATA_INVALID_SUBTITLE,
+            )
+        )

cartridges/importer/retroarch_source.py

@@ -0,0 +1,255 @@
+# retroarch_source.py
+#
+# Copyright 2023 Rilic
+#
+# This program is free software: you can redistribute it and/or modify
+# it under the terms of the GNU General Public License as published by
+# the Free Software Foundation, either version 3 of the License, or
+# (at your option) any later version.
+#
+# This program is distributed in the hope that it will be useful,
+# but WITHOUT ANY WARRANTY; without even the implied warranty of
+# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+# GNU General Public License for more details.
+#
+# You should have received a copy of the GNU General Public License
+# along with this program.  If not, see <http://www.gnu.org/licenses/>.
+#
+# SPDX-License-Identifier: GPL-3.0-or-later
+
+import json
+import logging
+import re
+from hashlib import md5
+from json import JSONDecodeError
+from pathlib import Path
+from shlex import quote as shell_quote
+from typing import NamedTuple
+
+from cartridges import shared
+from cartridges.errors.friendly_error import FriendlyError
+from cartridges.game import Game
+from cartridges.importer.location import (
+    Location,
+    LocationSubPath,
+    UnresolvableLocationError,
+)
+from cartridges.importer.source import Source, SourceIterable
+from cartridges.importer.steam_source import SteamSource
+
+
+class RetroarchSourceIterable(SourceIterable):
+    source: "RetroarchSource"
+
+    def get_config_value(self, key: str, config_data: str):
+        for item in re.findall(f'{key}\\s*=\\s*"(.*)"\n', config_data, re.IGNORECASE):
+            if item.startswith(":"):
+                item = item.replace(":", str(self.source.locations.config.root))
+
+            logging.debug(str(item))
+            return item
+
+        raise KeyError(f"Key not found in RetroArch config: {key}")
+
+    def __iter__(self):
+        bad_playlists = set()
+
+        config_file = self.source.locations.config["retroarch.cfg"]
+        with config_file.open(encoding="utf-8") as open_file:
+            config_data = open_file.read()
+
+        playlist_folder = Path(
+            self.get_config_value("playlist_directory", config_data)
+        ).expanduser()
+        thumbnail_folder = Path(
+            self.get_config_value("thumbnails_directory", config_data)
+        ).expanduser()
+
+        # Get all playlist files, ending in .lpl
+        playlist_files = playlist_folder.glob("*.lpl")
+
+        for playlist_file in playlist_files:
+            logging.debug(playlist_file)
+            try:
+                with playlist_file.open(
+                    encoding="utf-8",
+                ) as open_file:
+                    playlist_json = json.load(open_file)
+            except (JSONDecodeError, OSError):
+                logging.warning("Cannot read playlist file: %s", str(playlist_file))
+                continue
+
+            for item in playlist_json["items"]:
+                # Select the core.
+                # Try the content's core first, then the playlist's default core.
+                # If none can be used, warn the user and continue.
+                for core_path in (
+                    item["core_path"],
+                    playlist_json["default_core_path"],
+                ):
+                    if core_path not in ("DETECT", ""):
+                        break
+                else:
+                    logging.warning("Cannot find core for: %s", str(item["path"]))
+                    bad_playlists.add(playlist_file.stem)
+                    continue
+
+                # Build game
+                game_id = md5(item["path"].encode("utf-8")).hexdigest()
+
+                values = {
+                    "source": self.source.source_id,
+                    "added": shared.import_time,
+                    "name": item["label"],
+                    "game_id": self.source.game_id_format.format(game_id=game_id),
+                    "executable": self.source.make_executable(
+                        core_path=core_path,
+                        rom_path=item["path"],
+                    ),
+                }
+
+                game = Game(values)
+
+                # Get boxart
+                boxart_image_name = item["label"] + ".png"
+                boxart_image_name = re.sub(r"[&\*\/:`<>\?\\\|]", "_", boxart_image_name)
+                boxart_folder_name = playlist_file.stem
+                image_path = (
+                    thumbnail_folder
+                    / boxart_folder_name
+                    / "Named_Boxarts"
+                    / boxart_image_name
+                )
+                additional_data = {"local_image_path": image_path}
+
+                yield (game, additional_data)
+
+        if bad_playlists:
+            raise FriendlyError(
+                _("No RetroArch Core Selected"),
+                # The variable is a newline separated list of playlists
+                _("The following playlists have no default core:")
+                + "\n\n{}\n\n".format("\n".join(bad_playlists))
+                + _("Games with no core selected were not imported"),
+            )
+
+
+class RetroarchLocations(NamedTuple):
+    config: Location
+
+
+class RetroarchSource(Source):
+    name = _("RetroArch")
+    source_id = "retroarch"
+    available_on = {"linux"}
+    iterable_class = RetroarchSourceIterable
+
+    locations: RetroarchLocations
+
+    def __init__(self) -> None:
+        super().__init__()
+        self.locations = RetroarchLocations(
+            Location(
+                schema_key="retroarch-location",
+                candidates=[
+                    shared.flatpak_dir
+                    / "org.libretro.RetroArch"
+                    / "config"
+                    / "retroarch",
+                    shared.config_dir / "retroarch",
+                    shared.host_config_dir / "retroarch",
+                    # TODO: Windows support, waiting for executable path setting improvement
+                    # Path("C:\\RetroArch-Win64"),
+                    # Path("C:\\RetroArch-Win32"),
+                    # TODO: UWP support (URL handler - https://github.com/libretro/RetroArch/pull/13563)
+                    # shared.local_appdata_dir
+                    # / "Packages"
+                    # / "1e4cf179-f3c2-404f-b9f3-cb2070a5aad8_8ngdn9a6dx1ma"
+                    # / "LocalState",
+                ],
+                paths={
+                    "retroarch.cfg": LocationSubPath("retroarch.cfg"),
+                },
+                invalid_subtitle=Location.CONFIG_INVALID_SUBTITLE,
+            )
+        )
+        # TODO enable when we get the Steam RetroArch games working
+        # self.add_steam_location_candidate()
+
+    def add_steam_location_candidate(self) -> None:
+        """Add the Steam RetroAcrh location to the config candidates"""
+        try:
+            self.locations.config.candidates.append(self.get_steam_location())
+        except (OSError, KeyError, UnresolvableLocationError):
+            logging.debug("Steam isn't installed")
+        except ValueError as error:
+            logging.debug("RetroArch Steam location candiate not found", exc_info=error)
+
+    def get_steam_location(self) -> str:
+        """
+        Get the RetroArch installed via Steam location
+
+        :raise UnresolvableLocationError: if Steam isn't installed
+        :raise KeyError: if there is no libraryfolders.vdf subpath
+        :raise OSError: if libraryfolders.vdf can't be opened
+        :raise ValueError: if RetroArch isn't installed through Steam
+        """
+
+        # Find Steam location
+        libraryfolders = SteamSource().locations.data["libraryfolders.vdf"]
+        parse_apps = False
+        with open(libraryfolders, "r", encoding="utf-8") as open_file:
+            # Search each line for a library path and store it each time a new one is found.
+            for line in open_file:
+                if '"path"' in line:
+                    library_path = re.findall(
+                        '"path"\\s+"(.*)"\n', line, re.IGNORECASE
+                    )[0]
+                elif '"apps"' in line:
+                    parse_apps = True
+                elif parse_apps and "}" in line:
+                    parse_apps = False
+                # Stop searching, as the library path directly above the appid has been found.
+                elif parse_apps and '"1118310"' in line:
+                    return Path(f"{library_path}/steamapps/common/RetroArch")
+        # Not found
+        raise ValueError("RetroArch not found in Steam library")
+
+    def make_executable(self, core_path: Path, rom_path: Path) -> str:
+        """
+        Generate an executable command from the rom path and core path,
+        depending on the source's location.
+
+        The format depends on RetroArch's installation method,
+        detected from the source config location
+
+        :param Path rom_path: the game's rom path
+        :param Path core_path: the game's core path
+        :return str: an executable command
+        """
+
+        self.locations.config.resolve()
+        args = ("-L", core_path, rom_path)
+
+        # Steam RetroArch
+        # (Must check before Flatpak, because Steam itself can be installed as one)
+        # TODO enable when we get Steam RetroArch executable to work
+        # if self.locations.config.root.parent.parent.name == "steamapps":
+        #     # steam://run exepects args to be url-encoded and separated by spaces.
+        #     args = map(lambda s: url_quote(str(s), safe=""), args)
+        #     args_str = " ".join(args)
+        #     uri = f"steam://run/1118310//{args_str}/"
+        #     return f"xdg-open {shell_quote(uri)}"
+
+        # Flatpak RetroArch
+        args = map(lambda s: shell_quote(str(s)), args)
+        args_str = " ".join(args)
+        if self.locations.config.root.is_relative_to(shared.flatpak_dir):
+            return f"flatpak run org.libretro.RetroArch {args_str}"
+
+        # TODO executable override for non-sandboxed sources
+
+        # Linux native RetroArch
+        return f"retroarch {args_str}"
+
+        # TODO implement for windows (needs override)

cartridges/importer/source.py

@@ -0,0 +1,131 @@
+# source.py
+#
+# Copyright 2023 Geoffrey Coulaud
+#
+# This program is free software: you can redistribute it and/or modify
+# it under the terms of the GNU General Public License as published by
+# the Free Software Foundation, either version 3 of the License, or
+# (at your option) any later version.
+#
+# This program is distributed in the hope that it will be useful,
+# but WITHOUT ANY WARRANTY; without even the implied warranty of
+# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+# GNU General Public License for more details.
+#
+# You should have received a copy of the GNU General Public License
+# along with this program.  If not, see <http://www.gnu.org/licenses/>.
+#
+# SPDX-License-Identifier: GPL-3.0-or-later
+
+import sys
+from abc import abstractmethod
+from collections.abc import Iterable
+from typing import Any, Collection, Generator, Optional
+
+from cartridges.game import Game
+from cartridges.importer.location import Location, UnresolvableLocationError
+
+# Type of the data returned by iterating on a Source
+SourceIterationResult = Optional[Game | tuple[Game, tuple[Any]]]
+
+
+class SourceIterable(Iterable):
+    """Data producer for a source of games"""
+
+    source: "Source"
+
+    def __init__(self, source: "Source") -> None:
+        self.source = source
+
+    @abstractmethod
+    def __iter__(self) -> Generator[SourceIterationResult, None, None]:
+        """
+        Method that returns a generator that produces games
+        * Should be implemented as a generator method
+        * May yield `None` when an iteration hasn't produced a game
+        * In charge of handling per-game errors
+        * Returns when exhausted
+        """
+
+
+class Source(Iterable):
+    """Source of games. E.g an installed app with a config file that lists game directories"""
+
+    source_id: str
+    name: str
+    variant: Optional[str] = None
+    available_on: set[str] = set()
+    iterable_class: type[SourceIterable]
+
+    # NOTE: Locations must be set at __init__ time, not in the class definition.
+    # They must not be shared between source instances.
+    locations: Collection[Location]
+
+    @property
+    def full_name(self) -> str:
+        """The source's full name"""
+        full_name_ = self.name
+        if self.variant:
+            full_name_ += f" ({self.variant})"
+        return full_name_
+
+    @property
+    def game_id_format(self) -> str:
+        """The string format used to construct game IDs"""
+        return self.source_id + "_{game_id}"
+
+    @property
+    def is_available(self) -> bool:
+        return sys.platform in self.available_on
+
+    def make_executable(self, *args, **kwargs) -> str:
+        """
+        Create a game executable command.
+        Should be implemented by child classes.
+        """
+
+    def __iter__(self) -> Generator[SourceIterationResult, None, None]:
+        """
+        Get an iterator for the source
+        :raises UnresolvableLocationError: Not iterable
+        if any of the mandatory locations are unresolvable
+        """
+        for location in self.locations:
+            try:
+                location.resolve()
+            except UnresolvableLocationError as error:
+                if not error.optional:
+                    raise UnresolvableLocationError from error
+        return iter(self.iterable_class(self))
+
+
+class ExecutableFormatSource(Source):
+    """Source class that uses a simple executable format to start games"""
+
+    @property
+    @abstractmethod
+    def executable_format(self) -> str:
+        """The executable format used to construct game executables"""
+
+    def make_executable(self, *args, **kwargs) -> str:
+        """Use the executable format to"""
+        return self.executable_format.format(*args, **kwargs)
+
+
+# pylint: disable=abstract-method
+class URLExecutableSource(ExecutableFormatSource):
+    """Source class that use custom URLs to start games"""
+
+    url_format: str
+
+    @property
+    def executable_format(self) -> str:
+        match sys.platform:
+            case "win32":
+                return "start " + self.url_format
+            case "linux":
+                return "xdg-open " + self.url_format
+            case other:
+                raise NotImplementedError(
+                    f"No URL handler command available for {other}"
+                )

cartridges/importer/steam_source.py

@@ -0,0 +1,140 @@
+# steam_source.py
+#
+# Copyright 2022-2023 kramo
+# Copyright 2023 Geoffrey Coulaud
+#
+# This program is free software: you can redistribute it and/or modify
+# it under the terms of the GNU General Public License as published by
+# the Free Software Foundation, either version 3 of the License, or
+# (at your option) any later version.
+#
+# This program is distributed in the hope that it will be useful,
+# but WITHOUT ANY WARRANTY; without even the implied warranty of
+# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+# GNU General Public License for more details.
+#
+# You should have received a copy of the GNU General Public License
+# along with this program.  If not, see <http://www.gnu.org/licenses/>.
+#
+# SPDX-License-Identifier: GPL-3.0-or-later
+
+import logging
+import re
+from pathlib import Path
+from typing import Iterable, NamedTuple
+
+from cartridges import shared
+from cartridges.game import Game
+from cartridges.importer.location import Location, LocationSubPath
+from cartridges.importer.source import SourceIterable, URLExecutableSource
+from cartridges.utils.steam import SteamFileHelper, SteamInvalidManifestError
+
+
+class SteamSourceIterable(SourceIterable):
+    source: "SteamSource"
+
+    def get_manifest_dirs(self) -> Iterable[Path]:
+        """Get dirs that contain Steam app manifests"""
+        libraryfolders_path = self.source.locations.data["libraryfolders.vdf"]
+        with open(libraryfolders_path, "r", encoding="utf-8") as file:
+            contents = file.read()
+        return [
+            Path(path) / "steamapps"
+            for path in re.findall('"path"\\s+"(.*)"\n', contents, re.IGNORECASE)
+        ]
+
+    def get_manifests(self) -> Iterable[Path]:
+        """Get app manifests"""
+        manifests = set()
+        for steamapps_dir in self.get_manifest_dirs():
+            if not steamapps_dir.is_dir():
+                continue
+            manifests.update(
+                [
+                    manifest
+                    for manifest in steamapps_dir.glob("appmanifest_*.acf")
+                    if manifest.is_file()
+                ]
+            )
+        return manifests
+
+    def __iter__(self):
+        """Generator method producing games"""
+        appid_cache = set()
+        manifests = self.get_manifests()
+
+        for manifest in manifests:
+            # Get metadata from manifest
+            steam = SteamFileHelper()
+            try:
+                local_data = steam.get_manifest_data(manifest)
+            except (OSError, SteamInvalidManifestError) as error:
+                logging.debug("Couldn't load appmanifest %s", manifest, exc_info=error)
+                continue
+
+            # Skip non installed games
+            installed_mask = 4
+            if not int(local_data["stateflags"]) & installed_mask:
+                logging.debug("Skipped %s: not installed", manifest)
+                continue
+
+            # Skip duplicate appids
+            appid = local_data["appid"]
+            if appid in appid_cache:
+                logging.debug("Skipped %s: appid already seen during import", manifest)
+                continue
+            appid_cache.add(appid)
+
+            # Build game from local data
+            values = {
+                "added": shared.import_time,
+                "name": local_data["name"],
+                "source": self.source.source_id,
+                "game_id": self.source.game_id_format.format(game_id=appid),
+                "executable": self.source.make_executable(game_id=appid),
+            }
+            game = Game(values)
+
+            # Add official cover image
+            image_path = (
+                self.source.locations.data["librarycache"]
+                / f"{appid}_library_600x900.jpg"
+            )
+            additional_data = {"local_image_path": image_path, "steam_appid": appid}
+
+            yield (game, additional_data)
+
+
+class SteamLocations(NamedTuple):
+    data: Location
+
+
+class SteamSource(URLExecutableSource):
+    source_id = "steam"
+    name = _("Steam")
+    available_on = {"linux", "win32"}
+    iterable_class = SteamSourceIterable
+    url_format = "steam://rungameid/{game_id}"
+
+    locations: SteamLocations
+
+    def __init__(self) -> None:
+        super().__init__()
+        self.locations = SteamLocations(
+            Location(
+                schema_key="steam-location",
+                candidates=(
+                    shared.home / ".steam" / "steam",
+                    shared.data_dir / "Steam",
+                    shared.flatpak_dir / "com.valvesoftware.Steam" / "data" / "Steam",
+                    shared.programfiles32_dir / "Steam",
+                ),
+                paths={
+                    "libraryfolders.vdf": LocationSubPath(
+                        "steamapps/libraryfolders.vdf"
+                    ),
+                    "librarycache": LocationSubPath("appcache/librarycache", True),
+                },
+                invalid_subtitle=Location.DATA_INVALID_SUBTITLE,
+            )
+        )

cartridges/logging/color_log_formatter.py

@@ -0,0 +1,44 @@
+# color_log_formatter.py
+#
+# Copyright 2023 Geoffrey Coulaud
+#
+# This program is free software: you can redistribute it and/or modify
+# it under the terms of the GNU General Public License as published by
+# the Free Software Foundation, either version 3 of the License, or
+# (at your option) any later version.
+#
+# This program is distributed in the hope that it will be useful,
+# but WITHOUT ANY WARRANTY; without even the implied warranty of
+# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+# GNU General Public License for more details.
+#
+# You should have received a copy of the GNU General Public License
+# along with this program.  If not, see <http://www.gnu.org/licenses/>.
+#
+# SPDX-License-Identifier: GPL-3.0-or-later
+
+from logging import Formatter, LogRecord
+
+
+class ColorLogFormatter(Formatter):
+    """Formatter that outputs logs in a colored format"""
+
+    RESET = "\033[0m"
+    DIM = "\033[2m"
+    BOLD = "\033[1m"
+    RED = "\033[31m"
+    YELLOW = "\033[33m"
+
+    def format(self, record: LogRecord) -> str:
+        super_format = super().format(record)
+        match record.levelname:
+            case "CRITICAL":
+                return self.BOLD + self.RED + super_format + self.RESET
+            case "ERROR":
+                return self.RED + super_format + self.RESET
+            case "WARNING":
+                return self.YELLOW + super_format + self.RESET
+            case "DEBUG":
+                return self.DIM + super_format + self.RESET
+            case _other:
+                return super_format

cartridges/logging/session_file_handler.py

@@ -0,0 +1,140 @@
+# session_file_handler.py
+#
+# Copyright 2023 Geoffrey Coulaud
+#
+# This program is free software: you can redistribute it and/or modify
+# it under the terms of the GNU General Public License as published by
+# the Free Software Foundation, either version 3 of the License, or
+# (at your option) any later version.
+#
+# This program is distributed in the hope that it will be useful,
+# but WITHOUT ANY WARRANTY; without even the implied warranty of
+# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+# GNU General Public License for more details.
+#
+# You should have received a copy of the GNU General Public License
+# along with this program.  If not, see <http://www.gnu.org/licenses/>.
+#
+# SPDX-License-Identifier: GPL-3.0-or-later
+
+import lzma
+from io import TextIOWrapper
+from logging import StreamHandler
+from lzma import FORMAT_XZ, PRESET_DEFAULT
+from os import PathLike
+from pathlib import Path
+from typing import Optional
+
+from cartridges import shared
+
+
+class SessionFileHandler(StreamHandler):
+    """
+    A logging handler that writes to a new file on every app restart.
+    The files are compressed and older sessions logs are kept up to a small limit.
+    """
+
+    NUMBER_SUFFIX_POSITION = 1
+
+    backup_count: int
+    filename: Path
+    log_file: Optional[TextIOWrapper] = None
+
+    def create_dir(self) -> None:
+        """Create the log dir if needed"""
+        self.filename.parent.mkdir(exist_ok=True, parents=True)
+
+    def path_is_logfile(self, path: Path) -> bool:
+        return path.is_file() and path.name.startswith(self.filename.stem)
+
+    def path_has_number(self, path: Path) -> bool:
+        try:
+            int(path.suffixes[self.NUMBER_SUFFIX_POSITION][1:])
+        except (ValueError, IndexError):
+            return False
+        return True
+
+    def get_path_number(self, path: Path) -> int:
+        """Get the number extension in the filename as an int"""
+        suffixes = path.suffixes
+        number = (
+            0
+            if not self.path_has_number(path)
+            else int(suffixes[self.NUMBER_SUFFIX_POSITION][1:])
+        )
+        return number
+
+    def set_path_number(self, path: Path, number: int) -> str:
+        """Set or add the number extension in the filename"""
+        suffixes = path.suffixes
+        if self.path_has_number(path):
+            suffixes.pop(self.NUMBER_SUFFIX_POSITION)
+        suffixes.insert(self.NUMBER_SUFFIX_POSITION, f".{number}")
+        stem = path.name.split(".", maxsplit=1)[0]
+        new_name = stem + "".join(suffixes)
+        return new_name
+
+    def file_sort_key(self, path: Path) -> int:
+        """Key function used to sort files"""
+        return self.get_path_number(path) if self.path_has_number(path) else 0
+
+    def get_logfiles(self) -> list[Path]:
+        """Get the log files"""
+        logfiles = list(filter(self.path_is_logfile, self.filename.parent.iterdir()))
+        logfiles.sort(key=self.file_sort_key, reverse=True)
+        return logfiles
+
+    def rotate_file(self, path: Path) -> None:
+        """Rotate a file's number suffix and remove it if it's too old"""
+
+        # If uncompressed, compress
+        if not path.name.endswith(".xz"):
+            try:
+                with open(path, "r", encoding="utf-8") as original_file:
+                    original_data = original_file.read()
+            except UnicodeDecodeError:
+                # If the file is corrupted, throw it away
+                path.unlink()
+                return
+
+            # Compress the file
+            compressed_path = path.with_suffix(path.suffix + ".xz")
+            with lzma.open(
+                compressed_path,
+                "wt",
+                format=FORMAT_XZ,
+                preset=PRESET_DEFAULT,
+                encoding="utf-8",
+            ) as lzma_file:
+                lzma_file.write(original_data)
+            path.unlink()
+            path = compressed_path
+
+        # Rename with new number suffix
+        new_number = self.get_path_number(path) + 1
+        new_path_name = self.set_path_number(path, new_number)
+        path = path.rename(path.with_name(new_path_name))
+
+        # Remove older files
+        if new_number > self.backup_count:
+            path.unlink()
+            return
+
+    def rotate(self) -> None:
+        """Rotate the numbered suffix on the log files and remove old ones"""
+        for path in self.get_logfiles():
+            self.rotate_file(path)
+
+    def __init__(self, filename: PathLike, backup_count: int = 2) -> None:
+        self.filename = Path(filename)
+        self.backup_count = backup_count
+        self.create_dir()
+        self.rotate()
+        self.log_file = open(self.filename, "w", encoding="utf-8")
+        shared.log_files = self.get_logfiles()
+        super().__init__(self.log_file)
+
+    def close(self) -> None:
+        if self.log_file:
+            self.log_file.close()
+        super().close()

cartridges/logging/setup.py

@@ -0,0 +1,109 @@
+# setup.py
+#
+# Copyright 2023 Geoffrey Coulaud
+#
+# This program is free software: you can redistribute it and/or modify
+# it under the terms of the GNU General Public License as published by
+# the Free Software Foundation, either version 3 of the License, or
+# (at your option) any later version.
+#
+# This program is distributed in the hope that it will be useful,
+# but WITHOUT ANY WARRANTY; without even the implied warranty of
+# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+# GNU General Public License for more details.
+#
+# You should have received a copy of the GNU General Public License
+# along with this program.  If not, see <http://www.gnu.org/licenses/>.
+#
+# SPDX-License-Identifier: GPL-3.0-or-later
+
+import logging
+import logging.config as logging_dot_config
+import os
+import platform
+import subprocess
+import sys
+
+from cartridges import shared
+
+
+def setup_logging() -> None:
+    """Intitate the app's logging"""
+
+    is_dev = shared.PROFILE == "development"
+    profile_app_log_level = "DEBUG" if is_dev else "INFO"
+    profile_lib_log_level = "INFO" if is_dev else "WARNING"
+    app_log_level = os.environ.get("LOGLEVEL", profile_app_log_level).upper()
+    lib_log_level = os.environ.get("LIBLOGLEVEL", profile_lib_log_level).upper()
+
+    log_filename = shared.cache_dir / "cartridges" / "logs" / "cartridges.log"
+
+    config = {
+        "version": 1,
+        "formatters": {
+            "file_formatter": {
+                "format": "%(asctime)s - %(levelname)s: %(message)s",
+                "datefmt": "%M:%S",
+            },
+            "console_formatter": {
+                "format": "%(name)s %(levelname)s - %(message)s",
+                "class": "cartridges.logging.color_log_formatter.ColorLogFormatter",
+            },
+        },
+        "handlers": {
+            "file_handler": {
+                "class": "cartridges.logging.session_file_handler.SessionFileHandler",
+                "formatter": "file_formatter",
+                "level": "DEBUG",
+                "filename": log_filename,
+                "backup_count": 2,
+            },
+            "app_console_handler": {
+                "class": "logging.StreamHandler",
+                "formatter": "console_formatter",
+                "level": app_log_level,
+            },
+            "lib_console_handler": {
+                "class": "logging.StreamHandler",
+                "formatter": "console_formatter",
+                "level": lib_log_level,
+            },
+        },
+        "loggers": {
+            "PIL": {
+                "handlers": ["lib_console_handler", "file_handler"],
+                "propagate": False,
+                "level": "WARNING",
+            },
+            "urllib3": {
+                "handlers": ["lib_console_handler", "file_handler"],
+                "propagate": False,
+                "level": "NOTSET",
+            },
+        },
+        "root": {
+            "level": "NOTSET",
+            "handlers": ["app_console_handler", "file_handler"],
+        },
+    }
+    logging_dot_config.dictConfig(config)
+
+
+def log_system_info() -> None:
+    """Log system debug information"""
+
+    logging.debug("Starting %s v%s (%s)", shared.APP_ID, shared.VERSION, shared.PROFILE)
+    logging.debug("Python version: %s", sys.version)
+    if os.getenv("FLATPAK_ID") == shared.APP_ID:
+        process = subprocess.run(
+            ("flatpak-spawn", "--host", "flatpak", "--version"),
+            capture_output=True,
+            encoding="utf-8",
+            check=False,
+        )
+        logging.debug("Flatpak version: %s", process.stdout.rstrip())
+    logging.debug("Platform: %s", platform.platform())
+    if os.name == "posix":
+        for key, value in platform.uname()._asdict().items():
+            logging.debug("\t%s: %s", key.title(), value)
+    logging.debug("─" * 37)

cartridges/main.py

@@ -0,0 +1,387 @@
+# main.py
+#
+# Copyright 2022-2023 kramo
+#
+# This program is free software: you can redistribute it and/or modify
+# it under the terms of the GNU General Public License as published by
+# the Free Software Foundation, either version 3 of the License, or
+# (at your option) any later version.
+#
+# This program is distributed in the hope that it will be useful,
+# but WITHOUT ANY WARRANTY; without even the implied warranty of
+# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+# GNU General Public License for more details.
+#
+# You should have received a copy of the GNU General Public License
+# along with this program.  If not, see <http://www.gnu.org/licenses/>.
+#
+# SPDX-License-Identifier: GPL-3.0-or-later
+
+import json
+import lzma
+import os
+import shlex
+import sys
+from time import time
+from typing import Any, Optional
+
+import gi
+
+gi.require_version("Gtk", "4.0")
+gi.require_version("Adw", "1")
+
+# pylint: disable=wrong-import-position
+from gi.repository import Adw, Gio, GLib, Gtk
+
+from cartridges import shared
+from cartridges.details_window import DetailsWindow
+from cartridges.game import Game
+from cartridges.importer.bottles_source import BottlesSource
+from cartridges.importer.desktop_source import DesktopSource
+from cartridges.importer.flatpak_source import FlatpakSource
+from cartridges.importer.heroic_source import HeroicSource
+from cartridges.importer.importer import Importer
+from cartridges.importer.itch_source import ItchSource
+from cartridges.importer.legendary_source import LegendarySource
+from cartridges.importer.lutris_source import LutrisSource
+from cartridges.importer.retroarch_source import RetroarchSource
+from cartridges.importer.steam_source import SteamSource
+from cartridges.logging.setup import log_system_info, setup_logging
+from cartridges.preferences import PreferencesWindow
+from cartridges.store.managers.cover_manager import CoverManager
+from cartridges.store.managers.display_manager import DisplayManager
+from cartridges.store.managers.file_manager import FileManager
+from cartridges.store.managers.sgdb_manager import SgdbManager
+from cartridges.store.managers.steam_api_manager import SteamAPIManager
+from cartridges.store.store import Store
+from cartridges.utils.migrate_files_v1_to_v2 import migrate_files_v1_to_v2
+from cartridges.utils.run_executable import run_executable
+from cartridges.window import CartridgesWindow
+
+
+class CartridgesApplication(Adw.Application):
+    state = shared.AppState.DEFAULT
+    win: CartridgesWindow
+    init_search_term: Optional[str] = None
+
+    def __init__(self) -> None:
+        shared.store = Store()
+        super().__init__(application_id=shared.APP_ID)
+
+        search = GLib.OptionEntry()
+        search.long_name = "search"
+        search.short_name = ord("s")
+        search.flags = 0
+        search.arg = int(GLib.OptionArg.STRING)
+        search.arg_data = None
+        search.description = "Open the app with this term in the search entry"
+        search.arg_description = "TERM"
+
+        launch = GLib.OptionEntry()
+        launch.long_name = "launch"
+        launch.short_name = ord("l")
+        launch.flags = int(GLib.OptionFlags.NONE)
+        launch.arg = int(GLib.OptionArg.STRING)
+        launch.arg_data = None
+        launch.description = "Run a game with the given game_id"
+        launch.arg_description = "GAME_ID"
+
+        self.add_main_option_entries((search, launch))
+
+    def do_activate(self) -> None:  # pylint: disable=arguments-differ
+        """Called on app creation"""
+
+        setup_logging()
+        log_system_info()
+
+        if os.name == "nt":
+            migrate_files_v1_to_v2()
+
+        # Set fallback icon-name
+        Gtk.Window.set_default_icon_name(shared.APP_ID)
+
+        # Create the main window
+        win = self.props.active_window  # pylint: disable=no-member
+        if not win:
+            shared.win = win = CartridgesWindow(application=self)
+
+        # Save window geometry
+        shared.state_schema.bind(
+            "width", shared.win, "default-width", Gio.SettingsBindFlags.DEFAULT
+        )
+        shared.state_schema.bind(
+            "height", shared.win, "default-height", Gio.SettingsBindFlags.DEFAULT
+        )
+        shared.state_schema.bind(
+            "is-maximized", shared.win, "maximized", Gio.SettingsBindFlags.DEFAULT
+        )
+
+        # Load games from disk
+        shared.store.add_manager(FileManager(), False)
+        shared.store.add_manager(DisplayManager())
+        self.state = shared.AppState.LOAD_FROM_DISK
+        self.load_games_from_disk()
+        self.state = shared.AppState.DEFAULT
+        shared.win.create_source_rows()
+
+        # Add rest of the managers for game imports
+        shared.store.add_manager(CoverManager())
+        shared.store.add_manager(SteamAPIManager())
+        shared.store.add_manager(SgdbManager())
+        shared.store.toggle_manager_in_pipelines(FileManager, True)
+
+        # Create actions
+        self.create_actions(
+            {
+                ("quit", ("<primary>q",)),
+                ("about",),
+                ("preferences", ("<primary>comma",)),
+                ("launch_game",),
+                ("hide_game",),
+                ("edit_game",),
+                ("add_game", ("<primary>n",)),
+                ("import", ("<primary>i",)),
+                ("remove_game_details_view", ("Delete",)),
+                ("remove_game",),
+                ("igdb_search",),
+                ("sgdb_search",),
+                ("protondb_search",),
+                ("lutris_search",),
+                ("hltb_search",),
+                ("show_sidebar", ("F9",), shared.win),
+                ("show_hidden", ("<primary>h",), shared.win),
+                ("go_to_parent", ("<alt>Up",), shared.win),
+                ("go_home", ("<alt>Home",), shared.win),
+                ("toggle_search", ("<primary>f",), shared.win),
+                ("escape", ("Escape",), shared.win),
+                ("undo", ("<primary>z",), shared.win),
+                ("open_menu", ("F10",), shared.win),
+                ("close", ("<primary>w",), shared.win),
+            }
+        )
+
+        sort_action = Gio.SimpleAction.new_stateful(
+            "sort_by",
+            GLib.VariantType.new("s"),
+            sort_mode := GLib.Variant("s", shared.state_schema.get_string("sort-mode")),
+        )
+        sort_action.connect("activate", shared.win.on_sort_action)
+        shared.win.add_action(sort_action)
+        shared.win.on_sort_action(sort_action, sort_mode)
+
+        if self.init_search_term:  # For command line activation
+            shared.win.search_bar.set_search_mode(True)
+            shared.win.search_entry.set_text(self.init_search_term)
+            shared.win.search_entry.set_position(-1)
+
+        shared.win.present()
+
+    def do_handle_local_options(self, options: GLib.VariantDict) -> int:
+        if search := options.lookup_value("search"):
+            self.init_search_term = search.get_string()
+        elif game_id := options.lookup_value("launch"):
+            try:
+                data = json.load(
+                    (path := shared.games_dir / (game_id.get_string() + ".json")).open(
+                        "r", encoding="utf-8"
+                    )
+                )
+                executable = (
+                    shlex.join(data["executable"])
+                    if isinstance(data["executable"], list)
+                    else data["executable"]
+                )
+                name = data["name"]
+
+                run_executable(executable)
+
+                data["last_played"] = int(time())
+                json.dump(data, path.open("w", encoding="utf-8"))
+
+            except (IndexError, KeyError, OSError, json.decoder.JSONDecodeError):
+                return 1
+
+            self.register()
+            notification = Gio.Notification.new(_("Cartridges"))
+            notification.set_body(_("{} launched").format(name))
+            self.send_notification(
+                "launch",
+                notification,
+            )
+            return 0
+        return -1
+
+    def load_games_from_disk(self) -> None:
+        if shared.games_dir.is_dir():
+            for game_file in shared.games_dir.iterdir():
+                try:
+                    data = json.load(game_file.open())
+                except (OSError, json.decoder.JSONDecodeError):
+                    continue
+                game = Game(data)
+                shared.store.add_game(game, {"skip_save": True})
+
+    def get_source_name(self, source_id: str) -> Any:
+        if source_id == "all":
+            name = _("All Games")
+        elif source_id == "imported":
+            name = _("Added")
+        else:
+            name = globals()[f'{source_id.split("_")[0].title()}Source'].name
+        return name
+
+    def on_about_action(self, *_args: Any) -> None:
+        # Get the debug info from the log files
+        debug_str = ""
+        for index, path in enumerate(shared.log_files):
+            # Add a horizontal line between runs
+            if index > 0:
+                debug_str += "─" * 37 + "\n"
+            # Add the run's logs
+            log_file = (
+                lzma.open(path, "rt", encoding="utf-8")
+                if path.name.endswith(".xz")
+                else open(path, "r", encoding="utf-8")
+            )
+            debug_str += log_file.read()
+            log_file.close()
+
+        about = Adw.AboutWindow.new_from_appdata(
+            shared.PREFIX + "/" + shared.APP_ID + ".metainfo.xml", shared.VERSION
+        )
+        about.set_transient_for(shared.win)
+        about.set_developers(
+            (
+                "kramo https://kramo.page",
+                "Geoffrey Coulaud https://geoffrey-coulaud.fr",
+                "Rilic https://rilic.red",
+                "Arcitec https://github.com/Arcitec",
+                "Paweł Lidwin https://github.com/imLinguin",
+                "Domenico https://github.com/Domefemia",
+                "Rafael Mardojai CM https://mardojai.com",
+                "Clara Hobbs https://github.com/Ratfink",
+                "Sabri Ünal https://github.com/sabriunal",
+            )
+        )
+        about.set_designers(("kramo https://kramo.page",))
+        about.set_copyright("© 2022-2023 kramo")
+        # Translators: Replace this with your name for it to show up in the about window
+        about.set_translator_credits = (_("translator_credits"),)
+        about.set_debug_info(debug_str)
+        about.set_debug_info_filename("cartridges.log")
+        about.add_legal_section(
+            "Steam Branding",
+            "© 2023 Valve Corporation",
+            Gtk.License.CUSTOM,
+            "Steam and the Steam logo are trademarks and/or registered trademarks of Valve Corporation in the U.S. and/or other countries.",  # pylint: disable=line-too-long
+        )
+        about.present()
+
+    def on_preferences_action(
+        self,
+        _action: Any = None,
+        _parameter: Any = None,
+        page_name: Optional[str] = None,
+        expander_row: Optional[str] = None,
+    ) -> CartridgesWindow:
+        win = PreferencesWindow()
+        if page_name:
+            win.set_visible_page_name(page_name)
+        if expander_row:
+            getattr(win, expander_row).set_expanded(True)
+        win.present()
+
+        return win
+
+    def on_launch_game_action(self, *_args: Any) -> None:
+        shared.win.active_game.launch()
+
+    def on_hide_game_action(self, *_args: Any) -> None:
+        shared.win.active_game.toggle_hidden()
+
+    def on_edit_game_action(self, *_args: Any) -> None:
+        DetailsWindow(shared.win.active_game)
+
+    def on_add_game_action(self, *_args: Any) -> None:
+        DetailsWindow()
+
+    def on_import_action(self, *_args: Any) -> None:
+        shared.importer = Importer()
+
+        if shared.schema.get_boolean("lutris"):
+            shared.importer.add_source(LutrisSource())
+
+        if shared.schema.get_boolean("steam"):
+            shared.importer.add_source(SteamSource())
+
+        if shared.schema.get_boolean("heroic"):
+            shared.importer.add_source(HeroicSource())
+
+        if shared.schema.get_boolean("bottles"):
+            shared.importer.add_source(BottlesSource())
+
+        if shared.schema.get_boolean("flatpak"):
+            shared.importer.add_source(FlatpakSource())
+
+        if shared.schema.get_boolean("desktop"):
+            shared.importer.add_source(DesktopSource())
+
+        if shared.schema.get_boolean("itch"):
+            shared.importer.add_source(ItchSource())
+
+        if shared.schema.get_boolean("legendary"):
+            shared.importer.add_source(LegendarySource())
+
+        if shared.schema.get_boolean("retroarch"):
+            shared.importer.add_source(RetroarchSource())
+
+        shared.importer.run()
+
+    def on_remove_game_action(self, *_args: Any) -> None:
+        shared.win.active_game.remove_game()
+
+    def on_remove_game_details_view_action(self, *_args: Any) -> None:
+        if shared.win.navigation_view.get_visible_page() == shared.win.details_page:
+            self.on_remove_game_action()
+
+    def search(self, uri: str) -> None:
+        Gio.AppInfo.launch_default_for_uri(f"{uri}{shared.win.active_game.name}")
+
+    def on_igdb_search_action(self, *_args: Any) -> None:
+        self.search("https://www.igdb.com/search?type=1&q=")
+
+    def on_sgdb_search_action(self, *_args: Any) -> None:
+        self.search("https://www.steamgriddb.com/search/grids?term=")
+
+    def on_protondb_search_action(self, *_args: Any) -> None:
+        self.search("https://www.protondb.com/search?q=")
+
+    def on_lutris_search_action(self, *_args: Any) -> None:
+        self.search("https://lutris.net/games?q=")
+
+    def on_hltb_search_action(self, *_args: Any) -> None:
+        self.search("https://howlongtobeat.com/?q=")
+
+    def on_quit_action(self, *_args: Any) -> None:
+        self.quit()
+
+    def create_actions(self, actions: set) -> None:
+        for action in actions:
+            simple_action = Gio.SimpleAction.new(action[0], None)
+
+            scope = action[2] if action[2:3] else self
+            simple_action.connect("activate", getattr(scope, f"on_{action[0]}_action"))
+
+            if action[1:2]:
+                self.set_accels_for_action(
+                    f"app.{action[0]}" if scope == self else f"win.{action[0]}",
+                    action[1],
+                )
+
+            scope.add_action(simple_action)
+
+
+def main(_version: int) -> Any:
+    """App entry point"""
+    app = CartridgesApplication()
+    return app.run(sys.argv)

cartridges/meson.build

@@ -0,0 +1,31 @@
+moduledir = join_paths(python_dir, 'cartridges')
+
+configure_file(
+  input: 'cartridges.in',
+  output: 'cartridges',
+  configuration: conf,
+  install: true,
+  install_dir: get_option('bindir')
+)
+
+install_subdir('importer', install_dir: moduledir)
+install_subdir('utils', install_dir: moduledir)
+install_subdir('store', install_dir: moduledir)
+install_subdir('logging', install_dir: moduledir)
+install_subdir('errors', install_dir: moduledir)
+install_data(
+  [
+    'main.py',
+    'window.py',
+    'preferences.py',
+    'details_window.py',
+    'game.py',
+    'game_cover.py',
+    configure_file(
+      input: 'shared.py.in',
+      output: 'shared.py',
+      configuration: conf
+    )
+  ],
+  install_dir: moduledir
+)

cartridges/preferences.py

@@ -0,0 +1,448 @@
+# preferences.py
+#
+# Copyright 2022-2023 kramo
+#
+# This program is free software: you can redistribute it and/or modify
+# it under the terms of the GNU General Public License as published by
+# the Free Software Foundation, either version 3 of the License, or
+# (at your option) any later version.
+#
+# This program is distributed in the hope that it will be useful,
+# but WITHOUT ANY WARRANTY; without even the implied warranty of
+# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+# GNU General Public License for more details.
+#
+# You should have received a copy of the GNU General Public License
+# along with this program.  If not, see <http://www.gnu.org/licenses/>.
+#
+# SPDX-License-Identifier: GPL-3.0-or-later
+
+import logging
+import re
+from pathlib import Path
+from shutil import rmtree
+from typing import Any, Callable, Optional
+
+from gi.repository import Adw, Gio, GLib, Gtk
+
+from cartridges import shared
+from cartridges.errors.friendly_error import FriendlyError
+from cartridges.game import Game
+from cartridges.importer.bottles_source import BottlesSource
+from cartridges.importer.flatpak_source import FlatpakSource
+from cartridges.importer.heroic_source import HeroicSource
+from cartridges.importer.itch_source import ItchSource
+from cartridges.importer.legendary_source import LegendarySource
+from cartridges.importer.location import UnresolvableLocationError
+from cartridges.importer.lutris_source import LutrisSource
+from cartridges.importer.retroarch_source import RetroarchSource
+from cartridges.importer.source import Source
+from cartridges.importer.steam_source import SteamSource
+from cartridges.store.managers.sgdb_manager import SgdbManager
+from cartridges.utils.create_dialog import create_dialog
+
+
+@Gtk.Template(resource_path=shared.PREFIX + "/gtk/preferences.ui")
+class PreferencesWindow(Adw.PreferencesWindow):
+    __gtype_name__ = "PreferencesWindow"
+
+    general_page = Gtk.Template.Child()
+    import_page = Gtk.Template.Child()
+    sgdb_page = Gtk.Template.Child()
+
+    sources_group = Gtk.Template.Child()
+
+    exit_after_launch_switch = Gtk.Template.Child()
+    cover_launches_game_switch = Gtk.Template.Child()
+    high_quality_images_switch = Gtk.Template.Child()
+
+    remove_missing_switch = Gtk.Template.Child()
+
+    steam_expander_row = Gtk.Template.Child()
+    steam_data_action_row = Gtk.Template.Child()
+    steam_data_file_chooser_button = Gtk.Template.Child()
+
+    lutris_expander_row = Gtk.Template.Child()
+    lutris_data_action_row = Gtk.Template.Child()
+    lutris_data_file_chooser_button = Gtk.Template.Child()
+    lutris_import_steam_switch = Gtk.Template.Child()
+    lutris_import_flatpak_switch = Gtk.Template.Child()
+
+    heroic_expander_row = Gtk.Template.Child()
+    heroic_config_action_row = Gtk.Template.Child()
+    heroic_config_file_chooser_button = Gtk.Template.Child()
+    heroic_import_epic_switch = Gtk.Template.Child()
+    heroic_import_gog_switch = Gtk.Template.Child()
+    heroic_import_amazon_switch = Gtk.Template.Child()
+    heroic_import_sideload_switch = Gtk.Template.Child()
+
+    bottles_expander_row = Gtk.Template.Child()
+    bottles_data_action_row = Gtk.Template.Child()
+    bottles_data_file_chooser_button = Gtk.Template.Child()
+
+    itch_expander_row = Gtk.Template.Child()
+    itch_config_action_row = Gtk.Template.Child()
+    itch_config_file_chooser_button = Gtk.Template.Child()
+
+    legendary_expander_row = Gtk.Template.Child()
+    legendary_config_action_row = Gtk.Template.Child()
+    legendary_config_file_chooser_button = Gtk.Template.Child()
+
+    retroarch_expander_row = Gtk.Template.Child()
+    retroarch_config_action_row = Gtk.Template.Child()
+    retroarch_config_file_chooser_button = Gtk.Template.Child()
+
+    flatpak_expander_row = Gtk.Template.Child()
+    flatpak_system_data_action_row = Gtk.Template.Child()
+    flatpak_system_data_file_chooser_button = Gtk.Template.Child()
+    flatpak_user_data_action_row = Gtk.Template.Child()
+    flatpak_user_data_file_chooser_button = Gtk.Template.Child()
+    flatpak_import_launchers_switch = Gtk.Template.Child()
+
+    desktop_switch = Gtk.Template.Child()
+
+    sgdb_key_group = Gtk.Template.Child()
+    sgdb_key_entry_row = Gtk.Template.Child()
+    sgdb_switch = Gtk.Template.Child()
+    sgdb_prefer_switch = Gtk.Template.Child()
+    sgdb_animated_switch = Gtk.Template.Child()
+    sgdb_fetch_button = Gtk.Template.Child()
+    sgdb_stack = Gtk.Template.Child()
+    sgdb_spinner = Gtk.Template.Child()
+
+    danger_zone_group = Gtk.Template.Child()
+    remove_all_games_list_box = Gtk.Template.Child()
+    reset_list_box = Gtk.Template.Child()
+    reset_group = Gtk.Template.Child()
+
+    removed_games: set[Game] = set()
+    warning_menu_buttons: dict = {}
+
+    def __init__(self, **kwargs: Any) -> None:
+        super().__init__(**kwargs)
+        self.file_chooser = Gtk.FileDialog()
+        self.set_transient_for(shared.win)
+
+        self.toast = Adw.Toast.new(_("All games removed"))
+        self.toast.set_button_label(_("Undo"))
+        self.toast.connect("button-clicked", self.undo_remove_all, None)
+        self.toast.set_priority(Adw.ToastPriority.HIGH)
+
+        (shortcut_controller := Gtk.ShortcutController()).add_shortcut(
+            Gtk.Shortcut.new(
+                Gtk.ShortcutTrigger.parse_string("<primary>z"),
+                Gtk.CallbackAction.new(self.undo_remove_all),
+            )
+        )
+        self.add_controller(shortcut_controller)
+
+        # General
+        self.remove_all_games_list_box.connect("row-activated", self.remove_all_games)
+
+        # Debug
+        if shared.PROFILE == "development":
+            self.reset_group.set_visible(True)
+            self.reset_list_box.connect("row-activated", self.reset_app)
+
+        # Sources settings
+        for source_class in (
+            BottlesSource,
+            FlatpakSource,
+            HeroicSource,
+            ItchSource,
+            LegendarySource,
+            LutrisSource,
+            RetroarchSource,
+            SteamSource,
+        ):
+            source = source_class()
+            if not source.is_available:
+                expander_row = getattr(self, f"{source.source_id}_expander_row")
+                expander_row.set_visible(False)
+            else:
+                self.init_source_row(source)
+
+        # SteamGridDB
+        def sgdb_key_changed(*_args: Any) -> None:
+            shared.schema.set_string("sgdb-key", self.sgdb_key_entry_row.get_text())
+
+        self.sgdb_key_entry_row.set_text(shared.schema.get_string("sgdb-key"))
+        self.sgdb_key_entry_row.connect("changed", sgdb_key_changed)
+
+        self.sgdb_key_group.set_description(
+            _(
+                "An API key is required to use SteamGridDB. You can generate one {}here{}."
+            ).format(
+                '<a href="https://www.steamgriddb.com/profile/preferences/api">', "</a>"
+            )
+        )
+
+        def update_sgdb(*_args: Any) -> None:
+            counter = 0
+            games_len = len(shared.store)
+            sgdb_manager = shared.store.managers[SgdbManager]
+            sgdb_manager.reset_cancellable()
+
+            self.sgdb_spinner.set_spinning(True)
+            self.sgdb_stack.set_visible_child(self.sgdb_spinner)
+
+            self.add_toast(download_toast := Adw.Toast.new(_("Downloading covers…")))
+
+            def update_cover_callback(manager: SgdbManager) -> None:
+                nonlocal counter
+                nonlocal games_len
+                nonlocal download_toast
+
+                counter += 1
+                if counter != games_len:
+                    return
+
+                for error in manager.collect_errors():
+                    if isinstance(error, FriendlyError):
+                        create_dialog(self, error.title, error.subtitle)
+                        break
+
+                for game in shared.store:
+                    game.update()
+
+                toast = Adw.Toast.new(_("Covers updated"))
+                toast.set_priority(Adw.ToastPriority.HIGH)
+                download_toast.dismiss()
+                self.add_toast(toast)
+
+                self.sgdb_spinner.set_spinning(False)
+                self.sgdb_stack.set_visible_child(self.sgdb_fetch_button)
+
+            for game in shared.store:
+                sgdb_manager.process_game(game, {}, update_cover_callback)
+
+        self.sgdb_fetch_button.connect("clicked", update_sgdb)
+
+        # Switches
+        self.bind_switches(
+            {
+                "exit-after-launch",
+                "cover-launches-game",
+                "high-quality-images",
+                "remove-missing",
+                "lutris-import-steam",
+                "lutris-import-flatpak",
+                "heroic-import-epic",
+                "heroic-import-gog",
+                "heroic-import-amazon",
+                "heroic-import-sideload",
+                "flatpak-import-launchers",
+                "sgdb",
+                "sgdb-prefer",
+                "sgdb-animated",
+                "desktop",
+            }
+        )
+
+        def set_sgdb_sensitive(widget: Adw.EntryRow) -> None:
+            if not widget.get_text():
+                shared.schema.set_boolean("sgdb", False)
+
+            self.sgdb_switch.set_sensitive(widget.get_text())
+
+        self.sgdb_key_entry_row.connect("changed", set_sgdb_sensitive)
+        set_sgdb_sensitive(self.sgdb_key_entry_row)
+
+    def get_switch(self, setting: str) -> Any:
+        return getattr(self, f'{setting.replace("-", "_")}_switch')
+
+    def bind_switches(self, settings: set[str]) -> None:
+        for setting in settings:
+            shared.schema.bind(
+                setting,
+                self.get_switch(setting),
+                "active",
+                Gio.SettingsBindFlags.DEFAULT,
+            )
+
+    def choose_folder(
+        self, _widget: Any, callback: Callable, callback_data: Optional[str] = None
+    ) -> None:
+        self.file_chooser.select_folder(shared.win, None, callback, callback_data)
+
+    def undo_remove_all(self, *_args: Any) -> None:
+        shared.win.get_application().state = shared.AppState.UNDO_REMOVE_ALL_GAMES
+        for game in self.removed_games:
+            game.removed = False
+            game.save()
+            game.update()
+
+        self.removed_games = set()
+        self.toast.dismiss()
+        shared.win.get_application().state = shared.AppState.DEFAULT
+        shared.win.create_source_rows()
+
+    def remove_all_games(self, *_args: Any) -> None:
+        shared.win.get_application().state = shared.AppState.REMOVE_ALL_GAMES
+        shared.win.row_selected(None, shared.win.all_games_row_box.get_parent())
+        for game in shared.store:
+            if not game.removed:
+                self.removed_games.add(game)
+                game.removed = True
+                game.save()
+                game.update()
+
+        if shared.win.navigation_view.get_visible_page() == shared.win.details_page:
+            shared.win.navigation_view.pop()
+
+        self.add_toast(self.toast)
+        shared.win.get_application().state = shared.AppState.DEFAULT
+        shared.win.create_source_rows()
+
+    def reset_app(self, *_args: Any) -> None:
+        rmtree(shared.data_dir / "cartridges", True)
+        rmtree(shared.config_dir / "cartridges", True)
+        rmtree(shared.cache_dir / "cartridges", True)
+
+        for key in (
+            (settings_schema_source := Gio.SettingsSchemaSource.get_default())
+            .lookup(shared.APP_ID, True)
+            .list_keys()
+        ):
+            shared.schema.reset(key)
+        for key in settings_schema_source.lookup(
+            shared.APP_ID + ".State", True
+        ).list_keys():
+            shared.state_schema.reset(key)
+
+        shared.win.get_application().quit()
+
+    def update_source_action_row_paths(self, source: Source) -> None:
+        """Set the dir subtitle for a source's action rows"""
+        for location_name, location in source.locations._asdict().items():
+            # Get the action row to subtitle
+            action_row = getattr(
+                self, f"{source.source_id}_{location_name}_action_row", None
+            )
+            if not action_row:
+                continue
+            path = Path(shared.schema.get_string(location.schema_key)).expanduser()
+            # Remove the path prefix if picked via Flatpak portal
+            subtitle = re.sub("/run/user/\\d*/doc/.*/", "", str(path))
+            action_row.set_subtitle(subtitle)
+
+    def resolve_locations(self, source: Source) -> None:
+        """Resolve locations and add a warning if location cannot be found"""
+
+        for location_name, location in source.locations._asdict().items():
+            action_row = getattr(
+                self, f"{source.source_id}_{location_name}_action_row", None
+            )
+            if not action_row:
+                continue
+
+            try:
+                location.resolve()
+
+            except UnresolvableLocationError:
+                title = _("Installation Not Found")
+                description = _("Select a valid directory.")
+                format_start = '<span rise="12pt"><b><big>'
+                format_end = "</big></b></span>\n"
+
+                popover = Gtk.Popover(
+                    focusable=True,
+                    child=(
+                        Gtk.Label(
+                            label=format_start + title + format_end + description,
+                            use_markup=True,
+                            wrap=True,
+                            max_width_chars=50,
+                            halign=Gtk.Align.CENTER,
+                            valign=Gtk.Align.CENTER,
+                            justify=Gtk.Justification.CENTER,
+                            margin_top=9,
+                            margin_bottom=9,
+                            margin_start=12,
+                            margin_end=12,
+                        )
+                    ),
+                )
+
+                popover.update_property(
+                    (Gtk.AccessibleProperty.LABEL,), (title + description,)
+                )
+
+                def set_a11y_label(widget: Gtk.Popover) -> None:
+                    self.set_focus(widget)
+
+                popover.connect("show", set_a11y_label)
+
+                menu_button = Gtk.MenuButton(
+                    icon_name="dialog-warning-symbolic",
+                    valign=Gtk.Align.CENTER,
+                    popover=popover,
+                    tooltip_text=_("Warning"),
+                )
+                menu_button.add_css_class("warning")
+
+                action_row.add_prefix(menu_button)
+                self.warning_menu_buttons[source.source_id] = menu_button
+
+    def init_source_row(self, source: Source) -> None:
+        """Initialize a preference row for a source class"""
+
+        def set_dir(_widget: Any, result: Gio.Task, location_name: str) -> None:
+            """Callback called when a dir picker button is clicked"""
+            try:
+                path = Path(self.file_chooser.select_folder_finish(result).get_path())
+            except GLib.Error:
+                return
+
+            # Good picked location
+            location = source.locations._asdict()[location_name]
+            if location.check_candidate(path):
+                shared.schema.set_string(location.schema_key, str(path))
+                self.update_source_action_row_paths(source)
+                if self.warning_menu_buttons.get(source.source_id):
+                    action_row = getattr(
+                        self, f"{source.source_id}_{location_name}_action_row", None
+                    )
+                    action_row.remove(  # type: ignore
+                        self.warning_menu_buttons[source.source_id]
+                    )
+                    self.warning_menu_buttons.pop(source.source_id)
+                logging.debug("User-set value for %s is %s", location.schema_key, path)
+
+            # Bad picked location, inform user
+            else:
+                title = _("Invalid Directory")
+                dialog = create_dialog(
+                    self,
+                    title,
+                    location.invalid_subtitle.format(source.name),
+                    "choose_folder",
+                    _("Set Location"),
+                )
+
+                def on_response(widget: Any, response: str) -> None:
+                    if response == "choose_folder":
+                        self.choose_folder(widget, set_dir, location_name)
+
+                dialog.connect("response", on_response)
+
+        # Bind expander row activation to source being enabled
+        expander_row = getattr(self, f"{source.source_id}_expander_row")
+        shared.schema.bind(
+            source.source_id,
+            expander_row,
+            "enable-expansion",
+            Gio.SettingsBindFlags.DEFAULT,
+        )
+
+        # Connect dir picker buttons
+        for location_name in source.locations._asdict():
+            button = getattr(
+                self, f"{source.source_id}_{location_name}_file_chooser_button", None
+            )
+            if button is not None:
+                button.connect("clicked", self.choose_folder, set_dir, location_name)
+
+        # Set the source row subtitles
+        self.resolve_locations(source)
+        self.update_source_action_row_paths(source)

cartridges/shared.py.in

@@ -0,0 +1,82 @@
+# shared.py.in
+#
+# Copyright 2022-2023 kramo
+#
+# This program is free software: you can redistribute it and/or modify
+# it under the terms of the GNU General Public License as published by
+# the Free Software Foundation, either version 3 of the License, or
+# (at your option) any later version.
+#
+# This program is distributed in the hope that it will be useful,
+# but WITHOUT ANY WARRANTY; without even the implied warranty of
+# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+# GNU General Public License for more details.
+#
+# You should have received a copy of the GNU General Public License
+# along with this program.  If not, see <http://www.gnu.org/licenses/>.
+#
+# SPDX-License-Identifier: GPL-3.0-or-later
+
+from enum import IntEnum, auto
+from os import getenv
+from pathlib import Path
+
+from gi.repository import Gdk, Gio, GLib
+
+
+class AppState(IntEnum):
+    DEFAULT = auto()
+    LOAD_FROM_DISK = auto()
+    IMPORT = auto()
+    REMOVE_ALL_GAMES = auto()
+    UNDO_REMOVE_ALL_GAMES = auto()
+
+
+APP_ID = "@APP_ID@"
+VERSION = "@VERSION@"
+PREFIX = "@PREFIX@"
+PROFILE = "@PROFILE@"
+TIFF_COMPRESSION = "@TIFF_COMPRESSION@"
+SPEC_VERSION = 1.5  # The version of the game_id.json spec
+
+schema = Gio.Settings.new(APP_ID)
+state_schema = Gio.Settings.new(APP_ID + ".State")
+
+home = Path.home()
+
+data_dir = Path(GLib.get_user_data_dir())
+host_data_dir = Path(getenv("HOST_XDG_DATA_HOME", Path.home() / ".local" / "share"))
+
+config_dir = Path(GLib.get_user_config_dir())
+host_config_dir = Path(getenv("HOST_XDG_CONFIG_HOME", Path.home() / ".config"))
+
+cache_dir = Path(GLib.get_user_cache_dir())
+host_cache_dir = Path(getenv("HOST_XDG_CACHE_HOME", Path.home() / ".cache"))
+
+flatpak_dir = home / ".var" / "app"
+
+games_dir = data_dir / "cartridges" / "games"
+covers_dir = data_dir / "cartridges" / "covers"
+
+appdata_dir = Path(getenv("appdata") or r"C:\Users\Default\AppData\Roaming")
+local_appdata_dir = Path(
+    getenv("csidl_local_appdata") or r"C:\Users\Default\AppData\Local"
+)
+programfiles32_dir = Path(getenv("programfiles(x86)") or r"C:\Program Files (x86)")
+
+try:
+    scale_factor = max(
+        monitor.get_scale_factor()
+        for monitor in Gdk.Display.get_default().get_monitors()
+    )
+except AttributeError:  # If shared.py is imported by the search provider
+    pass
+else:
+    image_size = (200 * scale_factor, 300 * scale_factor)
+
+# pylint: disable=invalid-name
+win = None
+importer = None
+import_time = None
+store = None
+log_files = None

cartridges/store/managers/async_manager.py

@@ -0,0 +1,62 @@
+# async_manager.py
+#
+# Copyright 2023 Geoffrey Coulaud
+#
+# This program is free software: you can redistribute it and/or modify
+# it under the terms of the GNU General Public License as published by
+# the Free Software Foundation, either version 3 of the License, or
+# (at your option) any later version.
+#
+# This program is distributed in the hope that it will be useful,
+# but WITHOUT ANY WARRANTY; without even the implied warranty of
+# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+# GNU General Public License for more details.
+#
+# You should have received a copy of the GNU General Public License
+# along with this program.  If not, see <http://www.gnu.org/licenses/>.
+#
+# SPDX-License-Identifier: GPL-3.0-or-later
+
+from typing import Any, Callable
+
+from gi.repository import Gio
+
+from cartridges.game import Game
+from cartridges.store.managers.manager import Manager
+
+
+class AsyncManager(Manager):
+    """Manager that can run asynchronously"""
+
+    blocking = False
+    cancellable: Gio.Cancellable = None
+
+    def __init__(self) -> None:
+        super().__init__()
+        self.cancellable = Gio.Cancellable()
+
+    def cancel_tasks(self):
+        """Cancel all tasks for this manager"""
+        self.cancellable.cancel()
+
+    def reset_cancellable(self):
+        """Reset the cancellable for this manager.
+        Already scheduled Tasks will no longer be cancellable."""
+        self.cancellable = Gio.Cancellable()
+
+    def process_game(
+        self, game: Game, additional_data: dict, callback: Callable[["Manager"], Any]
+    ) -> None:
+        """Create a task to process the game in a separate thread"""
+        task = Gio.Task.new(None, self.cancellable, self._task_callback, (callback,))
+        task.run_in_thread(lambda *_: self._task_thread_func((game, additional_data)))
+
+    def _task_thread_func(self, data):
+        """Task thread entry point"""
+        game, additional_data, *_rest = data
+        self.run(game, additional_data)
+
+    def _task_callback(self, _source_object, _result, data):
+        """Method run after the task is done"""
+        callback, *_rest = data
+        callback(self)

cartridges/store/managers/cover_manager.py

@@ -0,0 +1,198 @@
+# local_cover_manager.py
+#
+# Copyright 2023 Geoffrey Coulaud
+# Copyright 2023 kramo
+#
+# This program is free software: you can redistribute it and/or modify
+# it under the terms of the GNU General Public License as published by
+# the Free Software Foundation, either version 3 of the License, or
+# (at your option) any later version.
+#
+# This program is distributed in the hope that it will be useful,
+# but WITHOUT ANY WARRANTY; without even the implied warranty of
+# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+# GNU General Public License for more details.
+#
+# You should have received a copy of the GNU General Public License
+# along with this program.  If not, see <http://www.gnu.org/licenses/>.
+#
+# SPDX-License-Identifier: GPL-3.0-or-later
+
+from pathlib import Path
+from typing import NamedTuple
+
+import requests
+from gi.repository import GdkPixbuf, Gio
+from requests.exceptions import HTTPError, SSLError
+
+from cartridges import shared
+from cartridges.game import Game
+from cartridges.store.managers.manager import Manager
+from cartridges.store.managers.steam_api_manager import SteamAPIManager
+from cartridges.utils.save_cover import convert_cover, save_cover
+
+
+class ImageSize(NamedTuple):
+    width: float = 0
+    height: float = 0
+
+    @property
+    def aspect_ratio(self) -> float:
+        return self.width / self.height
+
+    def __str__(self):
+        return f"{self.width}x{self.height}"
+
+    def __mul__(self, scale: float | int) -> "ImageSize":
+        return ImageSize(
+            self.width * scale,
+            self.height * scale,
+        )
+
+    def __truediv__(self, divisor: float | int) -> "ImageSize":
+        return self * (1 / divisor)
+
+    def __add__(self, other_size: "ImageSize") -> "ImageSize":
+        return ImageSize(
+            self.width + other_size.width,
+            self.height + other_size.height,
+        )
+
+    def __sub__(self, other_size: "ImageSize") -> "ImageSize":
+        return self + (other_size * -1)
+
+    def element_wise_div(self, other_size: "ImageSize") -> "ImageSize":
+        """Divide every element of self by the equivalent in the other size"""
+        return ImageSize(
+            self.width / other_size.width,
+            self.height / other_size.height,
+        )
+
+    def element_wise_mul(self, other_size: "ImageSize") -> "ImageSize":
+        """Multiply every element of self by the equivalent in the other size"""
+        return ImageSize(
+            self.width * other_size.width,
+            self.height * other_size.height,
+        )
+
+    def invert(self) -> "ImageSize":
+        """Invert the element of self"""
+        return ImageSize(1, 1).element_wise_div(self)
+
+
+class CoverManager(Manager):
+    """
+    Manager in charge of adding the cover image of the game
+
+    Order of priority is:
+    1. local cover
+    2. icon cover
+    3. online cover
+    """
+
+    run_after = (SteamAPIManager,)
+    retryable_on = (HTTPError, SSLError, ConnectionError)
+
+    def download_image(self, url: str) -> Path:
+        image_file = Gio.File.new_tmp()[0]
+        path = Path(image_file.get_path())
+        with requests.get(url, timeout=5) as cover:
+            cover.raise_for_status()
+            path.write_bytes(cover.content)
+        return path
+
+    def is_stretchable(self, source_size: ImageSize, cover_size: ImageSize) -> bool:
+        is_taller = source_size.aspect_ratio < cover_size.aspect_ratio
+        if is_taller:
+            return True
+        max_stretch = 0.12
+        resized_height = (1 / source_size.aspect_ratio) * cover_size.width
+        stretch = 1 - (resized_height / cover_size.height)
+        return stretch <= max_stretch
+
+    def composite_cover(
+        self,
+        image_path: Path,
+        scale: float = 1,
+        blur_size: ImageSize = ImageSize(2, 2),
+    ) -> GdkPixbuf.Pixbuf:
+        """
+        Return the image composited with a background blur.
+        If the image is stretchable, just stretch it.
+
+        :param path: Path where the source image is located
+        :param scale:
+            Scale of the smalled image side
+            compared to the corresponding side in the cover
+        :param blur_size: Size of the downscaled image used for the blur
+        """
+
+        # Load source image
+        source = GdkPixbuf.Pixbuf.new_from_file(
+            str(convert_cover(image_path, resize=False))
+        )
+        source_size = ImageSize(source.get_width(), source.get_height())
+        cover_size = ImageSize._make(shared.image_size)
+
+        # Stretch if possible
+        if scale == 1 and self.is_stretchable(source_size, cover_size):
+            return source
+
+        # Create the blurred cover background
+        # fmt: off
+        cover = (
+            source
+            .scale_simple(*blur_size, GdkPixbuf.InterpType.BILINEAR)
+            .scale_simple(*cover_size, GdkPixbuf.InterpType.BILINEAR)
+        )
+        # fmt: on
+
+        # Scale to fit, apply scaling, then center
+        uniform_scale = scale * min(cover_size.element_wise_div(source_size))
+        source_in_cover_size = source_size * uniform_scale
+        source_in_cover_position = (cover_size - source_in_cover_size) / 2
+
+        # Center the scaled source image in the cover
+        source.composite(
+            cover,
+            *source_in_cover_position,
+            *source_in_cover_size,
+            *source_in_cover_position,
+            uniform_scale,
+            uniform_scale,
+            GdkPixbuf.InterpType.BILINEAR,
+            255,
+        )
+        return cover
+
+    def main(self, game: Game, additional_data: dict) -> None:
+        if game.blacklisted:
+            return
+        for key in (
+            "local_image_path",
+            "local_icon_path",
+            "online_cover_url",
+        ):
+            # Get an image path
+            if not (value := additional_data.get(key)):
+                continue
+            if key == "online_cover_url":
+                image_path = self.download_image(value)
+            else:
+                image_path = Path(value)
+            if not image_path.is_file():
+                continue
+
+            # Icon cover
+            composite_kwargs = {}
+
+            if key == "local_icon_path":
+                composite_kwargs["scale"] = 0.7
+                composite_kwargs["blur_size"] = ImageSize(1, 2)
+
+            save_cover(
+                game.game_id,
+                convert_cover(
+                    pixbuf=self.composite_cover(image_path, **composite_kwargs)
+                ),
+            )

cartridges/store/managers/display_manager.py

@@ -0,0 +1,76 @@
+# display_manager.py
+#
+# Copyright 2023 Geoffrey Coulaud
+#
+# This program is free software: you can redistribute it and/or modify
+# it under the terms of the GNU General Public License as published by
+# the Free Software Foundation, either version 3 of the License, or
+# (at your option) any later version.
+#
+# This program is distributed in the hope that it will be useful,
+# but WITHOUT ANY WARRANTY; without even the implied warranty of
+# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+# GNU General Public License for more details.
+#
+# You should have received a copy of the GNU General Public License
+# along with this program.  If not, see <http://www.gnu.org/licenses/>.
+#
+# SPDX-License-Identifier: GPL-3.0-or-later
+
+from cartridges import shared
+from cartridges.game import Game
+from cartridges.game_cover import GameCover
+from cartridges.store.managers.manager import Manager
+from cartridges.store.managers.sgdb_manager import SgdbManager
+from cartridges.store.managers.steam_api_manager import SteamAPIManager
+
+
+class DisplayManager(Manager):
+    """Manager in charge of adding a game to the UI"""
+
+    run_after = (SteamAPIManager, SgdbManager)
+    signals = {"update-ready"}
+
+    def main(self, game: Game, _additional_data: dict) -> None:
+        if game.get_parent():
+            game.get_parent().get_parent().remove(game)
+            if game.get_parent():
+                game.get_parent().set_child()
+
+        game.menu_button.set_menu_model(
+            game.hidden_game_options if game.hidden else game.game_options
+        )
+
+        game.title.set_label(game.name)
+
+        game.menu_button.get_popover().connect(
+            "notify::visible", game.toggle_play, None
+        )
+        game.menu_button.get_popover().connect(
+            "notify::visible", shared.win.set_active_game, game
+        )
+
+        if game.game_id in shared.win.game_covers:
+            game.game_cover = shared.win.game_covers[game.game_id]
+            game.game_cover.add_picture(game.cover)
+        else:
+            game.game_cover = GameCover({game.cover}, game.get_cover_path())
+            shared.win.game_covers[game.game_id] = game.game_cover
+
+        if (
+            shared.win.navigation_view.get_visible_page() == shared.win.details_page
+            and shared.win.active_game == game
+        ):
+            shared.win.show_details_page(game)
+
+        if not game.removed and not game.blacklisted:
+            if game.hidden:
+                shared.win.hidden_library.append(game)
+            else:
+                shared.win.library.append(game)
+            game.get_parent().set_focusable(False)
+
+        shared.win.set_library_child()
+
+        if shared.win.get_application().state == shared.AppState.DEFAULT:
+            shared.win.create_source_rows()

cartridges/store/managers/file_manager.py

@@ -0,0 +1,59 @@
+# file_manager.py
+#
+# Copyright 2023 Geoffrey Coulaud
+#
+# This program is free software: you can redistribute it and/or modify
+# it under the terms of the GNU General Public License as published by
+# the Free Software Foundation, either version 3 of the License, or
+# (at your option) any later version.
+#
+# This program is distributed in the hope that it will be useful,
+# but WITHOUT ANY WARRANTY; without even the implied warranty of
+# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+# GNU General Public License for more details.
+#
+# You should have received a copy of the GNU General Public License
+# along with this program.  If not, see <http://www.gnu.org/licenses/>.
+#
+# SPDX-License-Identifier: GPL-3.0-or-later
+
+import json
+
+from cartridges import shared
+from cartridges.game import Game
+from cartridges.store.managers.async_manager import AsyncManager
+from cartridges.store.managers.steam_api_manager import SteamAPIManager
+
+
+class FileManager(AsyncManager):
+    """Manager in charge of saving a game to a file"""
+
+    run_after = (SteamAPIManager,)
+    signals = {"save-ready"}
+
+    def main(self, game: Game, additional_data: dict) -> None:
+        if additional_data.get("skip_save"):  # Skip saving when loading games from disk
+            return
+
+        shared.games_dir.mkdir(parents=True, exist_ok=True)
+
+        attrs = (
+            "added",
+            "executable",
+            "game_id",
+            "source",
+            "hidden",
+            "last_played",
+            "name",
+            "developer",
+            "removed",
+            "blacklisted",
+            "version",
+        )
+
+        json.dump(
+            {attr: getattr(game, attr) for attr in attrs if attr},
+            (shared.games_dir / f"{game.game_id}.json").open("w", encoding="utf-8"),
+            indent=4,
+            sort_keys=True,
+        )

cartridges/store/managers/manager.py

@@ -0,0 +1,120 @@
+# manager.py
+#
+# Copyright 2023 Geoffrey Coulaud
+#
+# This program is free software: you can redistribute it and/or modify
+# it under the terms of the GNU General Public License as published by
+# the Free Software Foundation, either version 3 of the License, or
+# (at your option) any later version.
+#
+# This program is distributed in the hope that it will be useful,
+# but WITHOUT ANY WARRANTY; without even the implied warranty of
+# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+# GNU General Public License for more details.
+#
+# You should have received a copy of the GNU General Public License
+# along with this program.  If not, see <http://www.gnu.org/licenses/>.
+#
+# SPDX-License-Identifier: GPL-3.0-or-later
+
+import logging
+from abc import abstractmethod
+from time import sleep
+from typing import Any, Callable, Container
+
+from cartridges.errors.error_producer import ErrorProducer
+from cartridges.errors.friendly_error import FriendlyError
+from cartridges.game import Game
+
+
+class Manager(ErrorProducer):
+    """Class in charge of handling a post creation action for games.
+
+    * May connect to signals on the game to handle them.
+    * May cancel its running tasks on critical error,
+    in that case a new cancellable must be generated for new tasks to run.
+    * May be retried on some specific error types
+    """
+
+    run_after: Container[type["Manager"]] = tuple()
+    blocking: bool = True
+
+    retryable_on: Container[type[Exception]] = tuple()
+    continue_on: Container[type[Exception]] = tuple()
+    signals: Container[type[str]] = set()
+    retry_delay: int = 3
+    max_tries: int = 3
+
+    @property
+    def name(self) -> str:
+        return type(self).__name__
+
+    @abstractmethod
+    def main(self, game: Game, additional_data: dict) -> None:
+        """
+        Manager specific logic triggered by the run method
+        * Implemented by final child classes
+        * May block its thread
+        * May raise retryable exceptions that will trigger a retry if possible
+        * May raise other exceptions that will be reported
+        """
+
+    def run(self, game: Game, additional_data: dict) -> None:
+        """Handle errors (retry, ignore or raise) that occur in the manager logic"""
+
+        # Keep track of the number of tries
+        tries = 1
+
+        def handle_error(error: Exception) -> None:
+            nonlocal tries
+
+            # If FriendlyError, handle its cause instead
+            base_error = error
+            if isinstance(error, FriendlyError):
+                error = error.__cause__
+
+            log_args = (
+                type(error).__name__,
+                self.name,
+                f"{game.name} ({game.game_id})",
+            )
+
+            out_of_retries_format = "Out of retries dues to %s in %s for %s"
+            retrying_format = "Retrying %s in %s for %s"
+            unretryable_format = "Unretryable %s in %s for %s"
+
+            if type(error) in self.continue_on:
+                # Handle skippable errors (skip silently)
+                return
+
+            if type(error) in self.retryable_on:
+                if tries > self.max_tries:
+                    # Handle being out of retries
+                    logging.error(out_of_retries_format, *log_args)
+                    self.report_error(base_error)
+                else:
+                    # Handle retryable errors
+                    logging.error(retrying_format, *log_args)
+                    sleep(self.retry_delay)
+                    tries += 1
+                    try_manager_logic()
+
+            else:
+                # Handle unretryable errors
+                logging.error(unretryable_format, *log_args, exc_info=error)
+                self.report_error(base_error)
+
+        def try_manager_logic() -> None:
+            try:
+                self.main(game, additional_data)
+            except Exception as error:  # pylint: disable=broad-exception-caught
+                handle_error(error)
+
+        try_manager_logic()
+
+    def process_game(
+        self, game: Game, additional_data: dict, callback: Callable[["Manager"], Any]
+    ) -> None:
+        """Pass the game through the manager"""
+        self.run(game, additional_data)
+        callback(self)

cartridges/store/managers/sgdb_manager.py

@@ -0,0 +1,48 @@
+# sgdb_manager.py
+#
+# Copyright 2023 Geoffrey Coulaud
+#
+# This program is free software: you can redistribute it and/or modify
+# it under the terms of the GNU General Public License as published by
+# the Free Software Foundation, either version 3 of the License, or
+# (at your option) any later version.
+#
+# This program is distributed in the hope that it will be useful,
+# but WITHOUT ANY WARRANTY; without even the implied warranty of
+# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+# GNU General Public License for more details.
+#
+# You should have received a copy of the GNU General Public License
+# along with this program.  If not, see <http://www.gnu.org/licenses/>.
+#
+# SPDX-License-Identifier: GPL-3.0-or-later
+
+from json import JSONDecodeError
+
+from requests.exceptions import HTTPError, SSLError
+
+from cartridges.errors.friendly_error import FriendlyError
+from cartridges.game import Game
+from cartridges.store.managers.async_manager import AsyncManager
+from cartridges.store.managers.cover_manager import CoverManager
+from cartridges.store.managers.steam_api_manager import SteamAPIManager
+from cartridges.utils.steamgriddb import SgdbAuthError, SgdbHelper
+
+
+class SgdbManager(AsyncManager):
+    """Manager in charge of downloading a game's cover from SteamGridDB"""
+
+    run_after = (SteamAPIManager, CoverManager)
+    retryable_on = (HTTPError, SSLError, ConnectionError, JSONDecodeError)
+
+    def main(self, game: Game, _additional_data: dict) -> None:
+        try:
+            sgdb = SgdbHelper()
+            sgdb.conditionaly_update_cover(game)
+        except SgdbAuthError as error:
+            # If invalid auth, cancel all SGDBManager tasks
+            self.cancellable.cancel()
+            raise FriendlyError(
+                _("Couldn't Authenticate SteamGridDB"),
+                _("Verify your API key in preferences"),
+            ) from error

cartridges/store/managers/steam_api_manager.py

@@ -0,0 +1,63 @@
+# steam_api_manager.py
+#
+# Copyright 2023 Geoffrey Coulaud
+#
+# This program is free software: you can redistribute it and/or modify
+# it under the terms of the GNU General Public License as published by
+# the Free Software Foundation, either version 3 of the License, or
+# (at your option) any later version.
+#
+# This program is distributed in the hope that it will be useful,
+# but WITHOUT ANY WARRANTY; without even the implied warranty of
+# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+# GNU General Public License for more details.
+#
+# You should have received a copy of the GNU General Public License
+# along with this program.  If not, see <http://www.gnu.org/licenses/>.
+#
+# SPDX-License-Identifier: GPL-3.0-or-later
+
+from requests.exceptions import HTTPError, SSLError
+from urllib3.exceptions import ConnectionError as Urllib3ConnectionError
+
+from cartridges.game import Game
+from cartridges.store.managers.async_manager import AsyncManager
+from cartridges.utils.steam import (
+    SteamAPIHelper,
+    SteamGameNotFoundError,
+    SteamNotAGameError,
+    SteamRateLimiter,
+)
+
+
+class SteamAPIManager(AsyncManager):
+    """Manager in charge of completing a game's data from the Steam API"""
+
+    retryable_on = (HTTPError, SSLError, Urllib3ConnectionError)
+
+    steam_api_helper: SteamAPIHelper = None
+    steam_rate_limiter: SteamRateLimiter = None
+
+    def __init__(self) -> None:
+        super().__init__()
+        self.steam_rate_limiter = SteamRateLimiter()
+        self.steam_api_helper = SteamAPIHelper(self.steam_rate_limiter)
+
+    def main(self, game: Game, additional_data: dict) -> None:
+        # Skip non-Steam games
+        appid = additional_data.get("steam_appid", None)
+        if appid is None:
+            return
+
+        # Get online metadata
+        try:
+            online_data = self.steam_api_helper.get_api_data(appid=appid)
+
+        except SteamGameNotFoundError:
+            return
+
+        except SteamNotAGameError:
+            game.update_values({"blacklisted": True})
+
+        else:
+            game.update_values(online_data)

cartridges/store/pipeline.py

@@ -0,0 +1,110 @@
+# pipeline.py
+#
+# Copyright 2023 Geoffrey Coulaud
+#
+# This program is free software: you can redistribute it and/or modify
+# it under the terms of the GNU General Public License as published by
+# the Free Software Foundation, either version 3 of the License, or
+# (at your option) any later version.
+#
+# This program is distributed in the hope that it will be useful,
+# but WITHOUT ANY WARRANTY; without even the implied warranty of
+# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+# GNU General Public License for more details.
+#
+# You should have received a copy of the GNU General Public License
+# along with this program.  If not, see <http://www.gnu.org/licenses/>.
+#
+# SPDX-License-Identifier: GPL-3.0-or-later
+
+import logging
+from typing import Iterable
+
+from gi.repository import GObject
+
+from cartridges.game import Game
+from cartridges.store.managers.manager import Manager
+
+
+class Pipeline(GObject.Object):
+    """Class representing a set of managers for a game"""
+
+    game: Game
+    additional_data: dict
+
+    waiting: set[Manager]
+    running: set[Manager]
+    done: set[Manager]
+
+    def __init__(
+        self, game: Game, additional_data: dict, managers: Iterable[Manager]
+    ) -> None:
+        super().__init__()
+        self.game = game
+        self.additional_data = additional_data
+        self.waiting = set(managers)
+        self.running = set()
+        self.done = set()
+
+    @property
+    def not_done(self) -> set[Manager]:
+        """Get the managers that are not done yet"""
+        return self.waiting | self.running
+
+    @property
+    def is_done(self) -> bool:
+        return len(self.waiting) == 0 and len(self.running) == 0
+
+    @property
+    def blocked(self) -> set[Manager]:
+        """Get the managers that cannot run because their dependencies aren't done"""
+        blocked = set()
+        for waiting in self.waiting:
+            for not_done in self.not_done:
+                if waiting == not_done:
+                    continue
+                if type(not_done) in waiting.run_after:
+                    blocked.add(waiting)
+        return blocked
+
+    @property
+    def ready(self) -> set[Manager]:
+        """Get the managers that can be run"""
+        return self.waiting - self.blocked
+
+    @property
+    def progress(self) -> float:
+        """Get the pipeline progress. Should only be a rough idea."""
+        n_done = len(self.done)
+        n_total = len(self.waiting) + len(self.running) + n_done
+        try:
+            progress = n_done / n_total
+        except ZeroDivisionError:
+            progress = 1
+        return progress
+
+    def advance(self) -> None:
+        """Spawn tasks for managers that are able to run for a game"""
+
+        # Separate blocking / async managers
+        managers = self.ready
+        blocking = set(filter(lambda manager: manager.blocking, managers))
+        parallel = managers - blocking
+
+        # Schedule parallel managers, then run the blocking ones
+        for manager in (*parallel, *blocking):
+            self.waiting.remove(manager)
+            self.running.add(manager)
+            manager.process_game(self.game, self.additional_data, self.manager_callback)
+
+    def manager_callback(self, manager: Manager) -> None:
+        """Method called by a manager when it's done"""
+        logging.debug("%s done for %s", manager.name, self.game.game_id)
+        self.running.remove(manager)
+        self.done.add(manager)
+        self.emit("advanced")
+        self.advance()
+
+    @GObject.Signal(name="advanced")
+    def advanced(self):  # type: ignore
+        """Signal emitted when the pipeline has advanced"""

cartridges/store/store.py

@@ -0,0 +1,163 @@
+# store.py
+#
+# Copyright 2023 Geoffrey Coulaud
+#
+# This program is free software: you can redistribute it and/or modify
+# it under the terms of the GNU General Public License as published by
+# the Free Software Foundation, either version 3 of the License, or
+# (at your option) any later version.
+#
+# This program is distributed in the hope that it will be useful,
+# but WITHOUT ANY WARRANTY; without even the implied warranty of
+# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+# GNU General Public License for more details.
+#
+# You should have received a copy of the GNU General Public License
+# along with this program.  If not, see <http://www.gnu.org/licenses/>.
+#
+# SPDX-License-Identifier: GPL-3.0-or-later
+
+import logging
+from typing import Any, Generator, MutableMapping, Optional
+
+from cartridges import shared
+from cartridges.game import Game
+from cartridges.store.managers.manager import Manager
+from cartridges.store.pipeline import Pipeline
+
+
+class Store:
+    """Class in charge of handling games being added to the app."""
+
+    managers: dict[type[Manager], Manager]
+    pipeline_managers: set[Manager]
+    pipelines: dict[str, Pipeline]
+    source_games: MutableMapping[str, MutableMapping[str, Game]]
+    new_game_ids: set[str]
+    duplicate_game_ids: set[str]
+
+    def __init__(self) -> None:
+        self.managers = {}
+        self.pipeline_managers = set()
+        self.pipelines = {}
+        self.source_games = {}
+        self.new_game_ids = set()
+        self.duplicate_game_ids = set()
+
+    def __contains__(self, obj: object) -> bool:
+        """Check if the game is present in the store with the `in` keyword"""
+        if not isinstance(obj, Game):
+            return False
+        if not (source_mapping := self.source_games.get(obj.base_source)):
+            return False
+        return obj.game_id in source_mapping
+
+    def __iter__(self) -> Generator[Game, None, None]:
+        """Iterate through the games in the store with `for ... in`"""
+        for _source_id, games_mapping in self.source_games.items():
+            for _game_id, game in games_mapping.items():
+                yield game
+
+    def __len__(self) -> int:
+        """Get the number of games in the store with the `len` builtin"""
+        return sum(len(source_mapping) for source_mapping in self.source_games.values())
+
+    def __getitem__(self, game_id: str) -> Game:
+        """Get a game by its id with `store["game_id_goes_here"]`"""
+        for game in iter(self):
+            if game.game_id == game_id:
+                return game
+        raise KeyError("Game not found in store")
+
+    def get(self, game_id: str, default: Any = None) -> Game | Any:
+        """Get a game by its ID, with a fallback if not found"""
+        try:
+            game = self[game_id]
+            return game
+        except KeyError:
+            return default
+
+    def add_manager(self, manager: Manager, in_pipeline: bool = True) -> None:
+        """Add a manager to the store"""
+        manager_type = type(manager)
+        self.managers[manager_type] = manager
+        self.toggle_manager_in_pipelines(manager_type, in_pipeline)
+
+    def toggle_manager_in_pipelines(
+        self, manager_type: type[Manager], enable: bool
+    ) -> None:
+        """Change if a manager should run in new pipelines"""
+        if enable:
+            self.pipeline_managers.add(self.managers[manager_type])
+        else:
+            self.pipeline_managers.discard(self.managers[manager_type])
+
+    def cleanup_game(self, game: Game) -> None:
+        """Remove a game's files, dismiss any loose toasts"""
+        for path in (
+            shared.games_dir / f"{game.game_id}.json",
+            shared.covers_dir / f"{game.game_id}.tiff",
+            shared.covers_dir / f"{game.game_id}.gif",
+        ):
+            path.unlink(missing_ok=True)
+
+        # TODO: don't run this if the state is startup
+        for undo in ("remove", "hide"):
+            try:
+                shared.win.toasts[(game, undo)].dismiss()
+                shared.win.toasts.pop((game, undo))
+            except KeyError:
+                pass
+
+    def add_game(
+        self, game: Game, additional_data: dict, run_pipeline: bool = True
+    ) -> Optional[Pipeline]:
+        """Add a game to the app"""
+
+        # Ignore games from a newer spec version
+        if game.version > shared.SPEC_VERSION:
+            return None
+
+        # Scanned game is already removed, just clean it up
+        if game.removed:
+            self.cleanup_game(game)
+            return None
+
+        # Handle game duplicates
+        stored_game = self.get(game.game_id)
+        if not stored_game:
+            # New game, do as normal
+            logging.debug("New store game %s (%s)", game.name, game.game_id)
+            self.new_game_ids.add(game.game_id)
+        elif stored_game.removed:
+            # Will replace a removed game, cleanup its remains
+            logging.debug(
+                "New store game %s (%s) (replacing a removed one)",
+                game.name,
+                game.game_id,
+            )
+            self.cleanup_game(stored_game)
+            self.new_game_ids.add(game.game_id)
+        else:
+            # Duplicate game, ignore it
+            logging.debug("Duplicate store game %s (%s)", game.name, game.game_id)
+            self.duplicate_game_ids.add(game.game_id)
+            return None
+
+        # Connect signals
+        for manager in self.managers.values():
+            for signal in manager.signals:
+                game.connect(signal, manager.run)
+
+        # Add the game to the store
+        if not game.base_source in self.source_games:
+            self.source_games[game.base_source] = {}
+        self.source_games[game.base_source][game.game_id] = game
+
+        # Run the pipeline for the game
+        if not run_pipeline:
+            return None
+        pipeline = Pipeline(game, additional_data, self.pipeline_managers)
+        self.pipelines[game.game_id] = pipeline
+        pipeline.advance()
+        return pipeline

cartridges/utils/create_dialog.py

@@ -1,6 +1,6 @@
 # create_dialog.py
 #
-# Copyright 2022 kramo
+# Copyright 2022-2023 kramo
 #
 # This program is free software: you can redistribute it and/or modify
 # it under the terms of the GNU General Public License as published by
@@ -17,15 +17,23 @@
 #
 # SPDX-License-Identifier: GPL-3.0-or-later
 
+from typing import Optional
+
 from gi.repository import Adw, Gtk
 
 
-def create_dialog(parent_widget, heading, body, extra_option=None, extra_label=None):
+def create_dialog(
-    dialog = Adw.MessageDialog.new(parent_widget, _(heading), body)
+    win: Gtk.Window,
+    heading: str,
+    body: str,
+    extra_option: Optional[str] = None,
+    extra_label: Optional[str] = None,
+) -> Adw.MessageDialog:
+    dialog = Adw.MessageDialog.new(win, heading, body)
     dialog.add_response("dismiss", _("Dismiss"))
 
     if extra_option:
         dialog.add_response(extra_option, _(extra_label))
 
-    Gtk.Window.present(dialog)
+    dialog.present()
     return dialog

cartridges/utils/migrate_files_v1_to_v2.py

@@ -0,0 +1,128 @@
+# migrate_files_v1_to_v2.py
+#
+# Copyright 2023 Geoffrey Coulaud
+#
+# This program is free software: you can redistribute it and/or modify
+# it under the terms of the GNU General Public License as published by
+# the Free Software Foundation, either version 3 of the License, or
+# (at your option) any later version.
+#
+# This program is distributed in the hope that it will be useful,
+# but WITHOUT ANY WARRANTY; without even the implied warranty of
+# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+# GNU General Public License for more details.
+#
+# You should have received a copy of the GNU General Public License
+# along with this program.  If not, see <http://www.gnu.org/licenses/>.
+#
+# SPDX-License-Identifier: GPL-3.0-or-later
+
+import json
+import logging
+from pathlib import Path
+
+from cartridges import shared
+
+old_data_dir = shared.home / ".local" / "share"
+old_cartridges_data_dir = old_data_dir / "cartridges"
+migrated_file_path = old_cartridges_data_dir / ".migrated"
+old_games_dir = old_cartridges_data_dir / "games"
+old_covers_dir = old_cartridges_data_dir / "covers"
+
+
+def migrate_game_covers(game_path: Path) -> None:
+    """Migrate a game covers from a source game path to the current dir"""
+    for suffix in (".tiff", ".gif"):
+        cover_path = old_covers_dir / game_path.with_suffix(suffix).name
+        if not cover_path.is_file():
+            continue
+        destination_cover_path = shared.covers_dir / cover_path.name
+        logging.info("Moving %s -> %s", str(cover_path), str(destination_cover_path))
+        cover_path.rename(destination_cover_path)
+
+
+def migrate_files_v1_to_v2() -> None:
+    """
+    Migrate user data from the v1.X locations to the latest location.
+
+    Fix for commit 4a204442b5d8ba2e918f8c2605d72e483bf35efd
+    where the windows directories for data, config and cache changed.
+    """
+
+    # Skip if there is no old dir
+    # Skip if old == current
+    # Skip if already migrated
+    if (
+        not old_data_dir.is_dir()
+        or str(old_data_dir) == str(shared.data_dir)
+        or migrated_file_path.is_file()
+    ):
+        return
+
+    logging.info("Migrating data dir %s", str(old_data_dir))
+
+    # Create new directories
+    shared.games_dir.mkdir(parents=True, exist_ok=True)
+    shared.covers_dir.mkdir(parents=True, exist_ok=True)
+
+    old_game_paths = set(old_games_dir.glob("*.json"))
+    old_imported_game_paths = set(
+        filter(lambda path: path.name.startswith("imported_"), old_game_paths)
+    )
+    old_other_game_paths = old_game_paths - old_imported_game_paths
+
+    # Discover current imported games
+    imported_game_number = 0
+    imported_execs = set()
+    for game_path in shared.games_dir.glob("imported_*.json"):
+        try:
+            game_data = json.load(game_path.open("r", encoding="utf-8"))
+        except (OSError, json.JSONDecodeError):
+            continue
+        number = int(game_data["game_id"].replace("imported_", ""))
+        imported_game_number = max(number, imported_game_number)
+        imported_execs.add(game_data["executable"])
+
+    # Migrate imported game files
+    for game_path in old_imported_game_paths:
+        try:
+            game_data = json.load(game_path.open("r", encoding="utf-8"))
+        except (OSError, json.JSONDecodeError):
+            continue
+
+        # Don't migrate if there's a game with the same exec
+        if game_data["executable"] in imported_execs:
+            continue
+
+        # Migrate with updated index
+        imported_game_number += 1
+        game_id = f"imported_{imported_game_number}"
+        game_data["game_id"] = game_id
+        destination_game_path = shared.games_dir / f"{game_id}.json"
+        logging.info(
+            "Moving (updated id) %s -> %s", str(game_path), str(destination_game_path)
+        )
+        json.dump(
+            game_data,
+            destination_game_path.open("w", encoding="utf-8"),
+            indent=4,
+            sort_keys=True,
+        )
+        game_path.unlink()
+        migrate_game_covers(game_path)
+
+    # Migrate all other games
+    for game_path in old_other_game_paths:
+        # Do nothing if already in games dir
+        destination_game_path = shared.games_dir / game_path.name
+        if destination_game_path.exists():
+            continue
+
+        # Else, migrate the game
+        logging.info("Moving %s -> %s", str(game_path), str(destination_game_path))
+        game_path.rename(destination_game_path)
+        migrate_game_covers(game_path)
+
+    # Signal that this dir is migrated
+    migrated_file_path.touch()
+    logging.info("Migration done")

cartridges/utils/rate_limiter.py

@@ -0,0 +1,221 @@
+# rate_limiter.py
+#
+# Copyright 2023 Geoffrey Coulaud
+#
+# This program is free software: you can redistribute it and/or modify
+# it under the terms of the GNU General Public License as published by
+# the Free Software Foundation, either version 3 of the License, or
+# (at your option) any later version.
+#
+# This program is distributed in the hope that it will be useful,
+# but WITHOUT ANY WARRANTY; without even the implied warranty of
+# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+# GNU General Public License for more details.
+#
+# You should have received a copy of the GNU General Public License
+# along with this program.  If not, see <http://www.gnu.org/licenses/>.
+#
+# SPDX-License-Identifier: GPL-3.0-or-later
+
+from collections import deque
+from contextlib import AbstractContextManager
+from threading import BoundedSemaphore, Lock, Thread
+from time import sleep, time
+from typing import Any, Sized
+
+
+class PickHistory(Sized):
+    """Utility class used for rate limiters, counting how many picks
+    happened in a given period"""
+
+    period: int
+
+    timestamps: list[float]
+    timestamps_lock: Lock
+
+    def __init__(self, period: int) -> None:
+        self.period = period
+        self.timestamps = []
+        self.timestamps_lock = Lock()
+
+    def remove_old_entries(self) -> None:
+        """Remove history entries older than the period"""
+        now = time()
+        cutoff = now - self.period
+        with self.timestamps_lock:
+            self.timestamps = [entry for entry in self.timestamps if entry > cutoff]
+
+    def add(self, *new_timestamps: float) -> None:
+        """Add timestamps to the history.
+        If none given, will add the current timestamp"""
+        if len(new_timestamps) == 0:
+            new_timestamps = (time(),)
+        with self.timestamps_lock:
+            self.timestamps.extend(new_timestamps)
+
+    def __len__(self) -> int:
+        """How many entries were logged in the period"""
+        self.remove_old_entries()
+        with self.timestamps_lock:
+            return len(self.timestamps)
+
+    @property
+    def start(self) -> float:
+        """Get the time at which the history started"""
+        self.remove_old_entries()
+        with self.timestamps_lock:
+            try:
+                entry = self.timestamps[0]
+            except IndexError:
+                entry = time()
+        return entry
+
+    def copy_timestamps(self) -> list[float]:
+        """Get a copy of the timestamps history"""
+        self.remove_old_entries()
+        with self.timestamps_lock:
+            return self.timestamps.copy()
+
+
+# pylint: disable=too-many-instance-attributes
+class RateLimiter(AbstractContextManager):
+    """
+    Base rate limiter implementing the token bucket algorithm.
+
+    Do not use directly, create a child class to tailor the rate limiting to the
+    underlying service's limits.
+
+    Subclasses must provide values to the following attributes:
+    * refill_period_seconds - Period in which we have a max amount of tokens
+    * refill_period_tokens - Number of tokens allowed in this period
+    * burst_tokens - Max number of tokens that can be consumed instantly
+    """
+
+    refill_period_seconds: int
+    refill_period_tokens: int
+    burst_tokens: int
+
+    pick_history: PickHistory
+    bucket: BoundedSemaphore
+    queue: deque[Lock]
+    queue_lock: Lock
+
+    # Protect the number of tokens behind a lock
+    __n_tokens_lock: Lock
+    __n_tokens = 0
+
+    @property
+    def n_tokens(self) -> int:
+        with self.__n_tokens_lock:
+            return self.__n_tokens
+
+    @n_tokens.setter
+    def n_tokens(self, value: int) -> None:
+        with self.__n_tokens_lock:
+            self.__n_tokens = value
+
+    def _init_pick_history(self) -> None:
+        """
+        Initialize the tocken pick history
+        (only for use in this class and its children)
+
+        By default, creates an empty pick history.
+        Should be overriden or extended by subclasses.
+        """
+        self.pick_history = PickHistory(self.refill_period_seconds)
+
+    def __init__(self) -> None:
+        """Initialize the limiter"""
+
+        self._init_pick_history()
+
+        # Create synchronization data
+        self.__n_tokens_lock = Lock()
+        self.queue_lock = Lock()
+        self.queue = deque()
+
+        # Initialize the token bucket
+        self.bucket = BoundedSemaphore(self.burst_tokens)
+        self.n_tokens = self.burst_tokens
+
+        # Spawn daemon thread that refills the bucket
+        refill_thread = Thread(target=self.refill_thread_func, daemon=True)
+        refill_thread.start()
+
+    @property
+    def refill_spacing(self) -> float:
+        """
+        Get the current refill spacing.
+
+        Ensures that even with a burst in the period, the limit will not be exceeded.
+        """
+
+        # Compute ideal spacing
+        tokens_left = self.refill_period_tokens - len(self.pick_history)  # type: ignore
+        seconds_left = self.pick_history.start + self.refill_period_seconds - time()  # type: ignore
+        try:
+            spacing_seconds = seconds_left / tokens_left
+        except ZeroDivisionError:
+            # There were no remaining tokens, gotta wait until end of the period
+            spacing_seconds = seconds_left
+
+        # Prevent spacing dropping down lower than the natural spacing
+        natural_spacing = self.refill_period_seconds / self.refill_period_tokens
+        return max(natural_spacing, spacing_seconds)
+
+    def refill(self) -> None:
+        """Add a token back in the bucket"""
+        sleep(self.refill_spacing)
+        try:
+            self.bucket.release()
+        except ValueError:
+            # Bucket was full
+            pass
+        else:
+            self.n_tokens += 1
+
+    def refill_thread_func(self) -> None:
+        """Entry point for the daemon thread that is refilling the bucket"""
+        while True:
+            self.refill()
+
+    def update_queue(self) -> None:
+        """Update the queue, moving it forward if possible. Non-blocking."""
+        update_thread = Thread(target=self.queue_update_thread_func, daemon=True)
+        update_thread.start()
+
+    def queue_update_thread_func(self) -> None:
+        """Queue-updating thread's entry point"""
+        with self.queue_lock:
+            if len(self.queue) == 0:
+                return
+            # Not using with because we don't want to release to the bucket
+            self.bucket.acquire()  # pylint: disable=consider-using-with
+            self.n_tokens -= 1
+            lock = self.queue.pop()
+            lock.release()
+
+    def add_to_queue(self) -> Lock:
+        """Create a lock, add it to the queue and return it"""
+        lock = Lock()
+        # We want the lock locked until its turn in queue
+        lock.acquire()  # pylint: disable=consider-using-with
+        with self.queue_lock:
+            self.queue.appendleft(lock)
+        return lock
+
+    def acquire(self) -> None:
+        """Acquires a token from the bucket when it's your turn in queue"""
+        lock = self.add_to_queue()
+        self.update_queue()
+        # Wait until our turn in queue
+        lock.acquire()  # pylint: disable=consider-using-with
+        self.pick_history.add()  # type: ignore
+
+    # --- Support for use in with statements
+
+    def __enter__(self) -> None:
+        self.acquire()
+
+    def __exit__(self, *_args: Any) -> None:
+        pass

cartridges/utils/relative_date.py

@@ -0,0 +1,45 @@
+# relative_date.py
+#
+# Copyright 2022-2023 kramo
+#
+# This program is free software: you can redistribute it and/or modify
+# it under the terms of the GNU General Public License as published by
+# the Free Software Foundation, either version 3 of the License, or
+# (at your option) any later version.
+#
+# This program is distributed in the hope that it will be useful,
+# but WITHOUT ANY WARRANTY; without even the implied warranty of
+# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+# GNU General Public License for more details.
+#
+# You should have received a copy of the GNU General Public License
+# along with this program.  If not, see <http://www.gnu.org/licenses/>.
+#
+# SPDX-License-Identifier: GPL-3.0-or-later
+
+from datetime import datetime
+from typing import Any
+
+from gi.repository import GLib
+
+
+def relative_date(timestamp: int) -> Any:  # pylint: disable=too-many-return-statements
+    days_no = ((today := datetime.today()) - datetime.fromtimestamp(timestamp)).days
+
+    if days_no == 0:
+        return _("Today")
+    if days_no == 1:
+        return _("Yesterday")
+    if days_no <= (day_of_week := today.weekday()):
+        return GLib.DateTime.new_from_unix_utc(timestamp).format("%A")
+    if days_no <= day_of_week + 7:
+        return _("Last Week")
+    if days_no <= (day_of_month := today.day):
+        return _("This Month")
+    if days_no <= day_of_month + 30:
+        return _("Last Month")
+    if days_no < (day_of_year := today.timetuple().tm_yday):
+        return GLib.DateTime.new_from_unix_utc(timestamp).format("%B")
+    if days_no <= day_of_year + 365:
+        return _("Last Year")
+    return GLib.DateTime.new_from_unix_utc(timestamp).format("%Y")

cartridges/utils/run_executable.py

@@ -1,6 +1,6 @@
-# run_command.py
+# run_executable.py
 #
-# Copyright 2022 kramo
+# Copyright 2023 kramo
 #
 # This program is free software: you can redistribute it and/or modify
 # it under the terms of the GNU General Public License as published by
@@ -17,21 +17,27 @@
 #
 # SPDX-License-Identifier: GPL-3.0-or-later
 
+import logging
 import os
 import subprocess
-import sys
+from shlex import quote
 
-from gi.repository import Gio
+from cartridges import shared
 
 
-def run_command(executable):
+def run_executable(executable) -> None:
+    args = (
+        "flatpak-spawn --host /bin/sh -c " + quote(executable)  # Flatpak
+        if os.getenv("FLATPAK_ID") == shared.APP_ID
+        else executable  # Others
+    )
+
+    logging.info("Launching `%s`", str(args))
+    # pylint: disable=consider-using-with
     subprocess.Popen(
-        ["flatpak-spawn --host " + executable]
+        args,
-        if os.getenv("FLATPAK_ID") == "hu.kramo.Cartridges"
+        cwd=shared.home,
-        else [executable],
         shell=True,
         start_new_session=True,
-        creationflags=subprocess.CREATE_NEW_PROCESS_GROUP if os.name == "nt" else 0,
+        creationflags=subprocess.CREATE_NEW_PROCESS_GROUP if os.name == "nt" else 0,  # type: ignore
     )
-    if Gio.Settings.new("hu.kramo.Cartridges").get_boolean("exit-after-launch"):
-        sys.exit()

cartridges/utils/save_cover.py

@@ -0,0 +1,112 @@
+# save_cover.py
+#
+# Copyright 2022-2023 kramo
+#
+# This program is free software: you can redistribute it and/or modify
+# it under the terms of the GNU General Public License as published by
+# the Free Software Foundation, either version 3 of the License, or
+# (at your option) any later version.
+#
+# This program is distributed in the hope that it will be useful,
+# but WITHOUT ANY WARRANTY; without even the implied warranty of
+# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+# GNU General Public License for more details.
+#
+# You should have received a copy of the GNU General Public License
+# along with this program.  If not, see <http://www.gnu.org/licenses/>.
+#
+# SPDX-License-Identifier: GPL-3.0-or-later
+
+
+from pathlib import Path
+from shutil import copyfile
+from typing import Optional
+
+from gi.repository import Gdk, GdkPixbuf, Gio, GLib
+from PIL import Image, ImageSequence, UnidentifiedImageError
+
+from cartridges import shared
+
+
+def convert_cover(
+    cover_path: Optional[Path] = None,
+    pixbuf: Optional[GdkPixbuf.Pixbuf] = None,
+    resize: bool = True,
+) -> Optional[Path]:
+    if not cover_path and not pixbuf:
+        return None
+
+    pixbuf_extensions = set()
+    for pixbuf_format in GdkPixbuf.Pixbuf.get_formats():
+        for pixbuf_extension in pixbuf_format.get_extensions():
+            pixbuf_extensions.add(pixbuf_extension)
+
+    if not resize and cover_path and cover_path.suffix.lower()[1:] in pixbuf_extensions:
+        return cover_path
+
+    if pixbuf:
+        cover_path = Path(Gio.File.new_tmp("XXXXXX.tiff")[0].get_path())
+        pixbuf.savev(str(cover_path), "tiff", ["compression"], ["1"])
+
+    try:
+        with Image.open(cover_path) as image:
+            if getattr(image, "is_animated", False):
+                frames = tuple(
+                    frame.resize((200, 300)) if resize else frame
+                    for frame in ImageSequence.Iterator(image)
+                )
+
+                tmp_path = Path(Gio.File.new_tmp("XXXXXX.gif")[0].get_path())
+                frames[0].save(
+                    tmp_path,
+                    save_all=True,
+                    append_images=frames[1:],
+                )
+
+            else:
+                # This might not be necessary in the future
+                # https://github.com/python-pillow/Pillow/issues/2663
+                if image.mode not in ("RGB", "RGBA"):
+                    image = image.convert("RGBA")
+
+                tmp_path = Path(Gio.File.new_tmp("XXXXXX.tiff")[0].get_path())
+                (image.resize(shared.image_size) if resize else image).save(
+                    tmp_path,
+                    compression="tiff_adobe_deflate"
+                    if shared.schema.get_boolean("high-quality-images")
+                    else shared.TIFF_COMPRESSION,
+                )
+    except UnidentifiedImageError:
+        try:
+            Gdk.Texture.new_from_filename(str(cover_path)).save_to_tiff(
+                tmp_path := Gio.File.new_tmp("XXXXXX.tiff")[0].get_path()
+            )
+            return convert_cover(tmp_path)
+        except GLib.Error:
+            return None
+
+    return tmp_path
+
+
+def save_cover(game_id: str, cover_path: Path) -> None:
+    shared.covers_dir.mkdir(parents=True, exist_ok=True)
+
+    animated_path = shared.covers_dir / f"{game_id}.gif"
+    static_path = shared.covers_dir / f"{game_id}.tiff"
+
+    # Remove previous covers
+    animated_path.unlink(missing_ok=True)
+    static_path.unlink(missing_ok=True)
+
+    if not cover_path:
+        return
+
+    copyfile(
+        cover_path,
+        animated_path if cover_path.suffix == ".gif" else static_path,
+    )
+
+    if game_id in shared.win.game_covers:
+        shared.win.game_covers[game_id].new_cover(
+            animated_path if cover_path.suffix == ".gif" else static_path
+        )

cartridges/utils/sqlite.py

@@ -1,6 +1,7 @@
-# get_cover.py
+# sqlite.py
 #
-# Copyright 2022 kramo
+# Copyright 2022-2023 kramo
+# Copyright 2023 Geoffrey Coulaud
 #
 # This program is free software: you can redistribute it and/or modify
 # it under the terms of the GNU General Public License as published by
@@ -17,24 +18,20 @@
 #
 # SPDX-License-Identifier: GPL-3.0-or-later
 
-import os
+from glob import escape
+from pathlib import Path
+from shutil import copyfile
 
-from gi.repository import GdkPixbuf
+from gi.repository import GLib
 
 
-def get_cover(game_id, parent_widget):
+def copy_db(original_path: Path) -> Path:
-    if game_id in parent_widget.pixbufs.keys():
+    """
-        return parent_widget.pixbufs[game_id]
+    Copy a sqlite database to a cache dir and return its new path.
-
+    The caller in in charge of deleting the returned path's parent dir.
-    cover_path = os.path.join(
+    """
-        os.getenv("XDG_DATA_HOME")
+    tmp = Path(GLib.Dir.make_tmp())
-        or os.path.expanduser(os.path.join("~", ".local", "share")),
+    for file in original_path.parent.glob(f"{escape(original_path.name)}*"):
-        "cartridges",
+        copy = tmp / file.name
-        "covers",
+        copyfile(str(file), str(copy))
-        game_id + ".tiff",
+    return tmp / original_path.name
-    )
-
-    if not os.path.isfile(cover_path):
-        return parent_widget.placeholder_pixbuf
-
-    return GdkPixbuf.Pixbuf.new_from_file(cover_path)

cartridges/utils/steam.py

@@ -0,0 +1,158 @@
+# steam.py
+#
+# Copyright 2022-2023 kramo
+# Copyright 2023 Geoffrey Coulaud
+#
+# This program is free software: you can redistribute it and/or modify
+# it under the terms of the GNU General Public License as published by
+# the Free Software Foundation, either version 3 of the License, or
+# (at your option) any later version.
+#
+# This program is distributed in the hope that it will be useful,
+# but WITHOUT ANY WARRANTY; without even the implied warranty of
+# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+# GNU General Public License for more details.
+#
+# You should have received a copy of the GNU General Public License
+# along with this program.  If not, see <http://www.gnu.org/licenses/>.
+#
+# SPDX-License-Identifier: GPL-3.0-or-later
+
+import json
+import logging
+import re
+from pathlib import Path
+from typing import TypedDict
+
+import requests
+from requests.exceptions import HTTPError
+
+from cartridges import shared
+from cartridges.utils.rate_limiter import RateLimiter
+
+
+class SteamError(Exception):
+    pass
+
+
+class SteamGameNotFoundError(SteamError):
+    pass
+
+
+class SteamNotAGameError(SteamError):
+    pass
+
+
+class SteamInvalidManifestError(SteamError):
+    pass
+
+
+class SteamManifestData(TypedDict):
+    """Dict returned by SteamFileHelper.get_manifest_data"""
+
+    name: str
+    appid: str
+    stateflags: str
+
+
+class SteamAPIData(TypedDict):
+    """Dict returned by SteamAPIHelper.get_api_data"""
+
+    developer: str
+
+
+class SteamRateLimiter(RateLimiter):
+    """Rate limiter for the Steam web API"""
+
+    # Steam web API limit
+    # 200 requests per 5 min seems to be the limit
+    # https://stackoverflow.com/questions/76047820/how-am-i-exceeding-steam-apis-rate-limit
+    # https://stackoverflow.com/questions/51795457/avoiding-error-429-too-many-requests-steam-web-api
+    refill_period_seconds = 5 * 60
+    refill_period_tokens = 200
+    burst_tokens = 100
+
+    def _init_pick_history(self) -> None:
+        """
+        Load the pick history from schema.
+
+        Allows remembering API limits through restarts of Cartridges.
+        """
+        super()._init_pick_history()
+        timestamps_str = shared.state_schema.get_string("steam-limiter-tokens-history")
+        self.pick_history.add(*json.loads(timestamps_str))
+        self.pick_history.remove_old_entries()
+
+    def acquire(self) -> None:
+        """Get a token from the bucket and store the pick history in the schema"""
+        super().acquire()
+        timestamps_str = json.dumps(self.pick_history.copy_timestamps())
+        shared.state_schema.set_string("steam-limiter-tokens-history", timestamps_str)
+
+
+class SteamFileHelper:
+    """Helper for Steam file formats"""
+
+    def get_manifest_data(self, manifest_path: Path) -> SteamManifestData:
+        """Get local data for a game from its manifest"""
+
+        with open(manifest_path, "r", encoding="utf-8") as file:
+            contents = file.read()
+
+        data = {}
+
+        for key in SteamManifestData.__required_keys__:  # pylint: disable=no-member
+            regex = f'"{key}"\\s+"(.*)"\n'
+            if (match := re.search(regex, contents, re.IGNORECASE)) is None:
+                raise SteamInvalidManifestError()
+            data[key] = match.group(1)
+
+        return SteamManifestData(
+            name=data["name"],
+            appid=data["appid"],
+            stateflags=data["stateflags"],
+        )
+
+
+class SteamAPIHelper:
+    """Helper around the Steam API"""
+
+    base_url = "https://store.steampowered.com/api"
+    rate_limiter: RateLimiter
+
+    def __init__(self, rate_limiter: RateLimiter) -> None:
+        self.rate_limiter = rate_limiter
+
+    def get_api_data(self, appid: str) -> SteamAPIData:
+        """
+        Get online data for a game from its appid.
+        May block to satisfy the Steam web API limitations.
+
+        See https://wiki.teamfortress.com/wiki/User:RJackson/StorefrontAPI#appdetails
+        """
+
+        # Get data from the API (way block to satisfy its limits)
+        with self.rate_limiter:
+            try:
+                with requests.get(
+                    f"{self.base_url}/appdetails?appids={appid}", timeout=5
+                ) as response:
+                    response.raise_for_status()
+                    data = response.json()[appid]
+            except HTTPError as error:
+                logging.warning("Steam API HTTP error for %s", appid, exc_info=error)
+                raise error
+
+        # Handle not found
+        if not data["success"]:
+            logging.debug("Appid %s not found", appid)
+            raise SteamGameNotFoundError()
+
+        # Handle appid is not a game
+        if data["data"]["type"] not in {"game", "demo", "mod"}:
+            logging.debug("Appid %s is not a game", appid)
+            raise SteamNotAGameError()
+
+        # Return API values we're interested in
+        values = SteamAPIData(developer=", ".join(data["data"]["developers"]))
+        return values

cartridges/utils/steamgriddb.py

@@ -0,0 +1,159 @@
+# steamgriddb.py
+#
+# Copyright 2022-2023 kramo
+# Copyright 2023 Geoffrey Coulaud
+#
+# This program is free software: you can redistribute it and/or modify
+# it under the terms of the GNU General Public License as published by
+# the Free Software Foundation, either version 3 of the License, or
+# (at your option) any later version.
+#
+# This program is distributed in the hope that it will be useful,
+# but WITHOUT ANY WARRANTY; without even the implied warranty of
+# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+# GNU General Public License for more details.
+#
+# You should have received a copy of the GNU General Public License
+# along with this program.  If not, see <http://www.gnu.org/licenses/>.
+#
+# SPDX-License-Identifier: GPL-3.0-or-later
+
+import logging
+from pathlib import Path
+from typing import Any
+
+import requests
+from gi.repository import Gio
+from requests.exceptions import HTTPError
+
+from cartridges import shared
+from cartridges.game import Game
+from cartridges.utils.save_cover import convert_cover, save_cover
+
+
+class SgdbError(Exception):
+    pass
+
+
+class SgdbAuthError(SgdbError):
+    pass
+
+
+class SgdbGameNotFound(SgdbError):
+    pass
+
+
+class SgdbBadRequest(SgdbError):
+    pass
+
+
+class SgdbNoImageFound(SgdbError):
+    pass
+
+
+class SgdbHelper:
+    """Helper class to make queries to SteamGridDB"""
+
+    base_url = "https://www.steamgriddb.com/api/v2/"
+
+    @property
+    def auth_headers(self) -> dict[str, str]:
+        key = shared.schema.get_string("sgdb-key")
+        headers = {"Authorization": f"Bearer {key}"}
+        return headers
+
+    def get_game_id(self, game: Game) -> Any:
+        """Get grid results for a game. Can raise an exception."""
+        uri = f"{self.base_url}search/autocomplete/{game.name}"
+        res = requests.get(uri, headers=self.auth_headers, timeout=5)
+        match res.status_code:
+            case 200:
+                return res.json()["data"][0]["id"]
+            case 401:
+                raise SgdbAuthError(res.json()["errors"][0])
+            case 404:
+                raise SgdbGameNotFound(res.status_code)
+            case _:
+                res.raise_for_status()
+
+    def get_image_uri(self, game_id: str, animated: bool = False) -> Any:
+        """Get the image for a SGDB game id"""
+        uri = f"{self.base_url}grids/game/{game_id}?dimensions=600x900"
+        if animated:
+            uri += "&types=animated"
+        res = requests.get(uri, headers=self.auth_headers, timeout=5)
+        match res.status_code:
+            case 200:
+                data = res.json()["data"]
+                if len(data) == 0:
+                    raise SgdbNoImageFound()
+                return data[0]["url"]
+            case 401:
+                raise SgdbAuthError(res.json()["errors"][0])
+            case 404:
+                raise SgdbGameNotFound(res.status_code)
+            case _:
+                res.raise_for_status()
+
+    def conditionaly_update_cover(self, game: Game) -> None:
+        """Update the game's cover if appropriate"""
+
+        # Obvious skips
+        use_sgdb = shared.schema.get_boolean("sgdb")
+        if not use_sgdb or game.blacklisted:
+            return
+
+        image_trunk = shared.covers_dir / game.game_id
+        still = image_trunk.with_suffix(".tiff")
+        animated = image_trunk.with_suffix(".gif")
+        prefer_sgdb = shared.schema.get_boolean("sgdb-prefer")
+
+        # Do nothing if file present and not prefer SGDB
+        if not prefer_sgdb and (still.is_file() or animated.is_file()):
+            return
+
+        # Get ID for the game
+        try:
+            sgdb_id = self.get_game_id(game)
+        except (HTTPError, SgdbError) as error:
+            logging.warning(
+                "%s while getting SGDB ID for %s", type(error).__name__, game.name
+            )
+            raise error
+
+        # Build different SGDB options to try
+        image_uri_kwargs_sets = [{"animated": False}]
+        if shared.schema.get_boolean("sgdb-animated"):
+            image_uri_kwargs_sets.insert(0, {"animated": True})
+
+        # Download covers
+        for uri_kwargs in image_uri_kwargs_sets:
+            try:
+                uri = self.get_image_uri(sgdb_id, **uri_kwargs)
+                response = requests.get(uri, timeout=5)
+                tmp_file = Gio.File.new_tmp()[0]
+                tmp_file_path = tmp_file.get_path()
+                Path(tmp_file_path).write_bytes(response.content)
+                save_cover(game.game_id, convert_cover(tmp_file_path))
+            except SgdbAuthError as error:
+                # Let caller handle auth errors
+                raise error
+            except (HTTPError, SgdbError) as error:
+                logging.warning(
+                    "%s while getting image for %s kwargs=%s",
+                    type(error).__name__,
+                    game.name,
+                    str(uri_kwargs),
+                )
+                continue
+            else:
+                # Stop as soon as one is finished
+                return
+
+        # No image was added
+        logging.warning(
+            'No matching image found for game "%s" (SGDB ID %d)',
+            game.name,
+            sgdb_id,
+        )
+        raise SgdbNoImageFound()

cartridges/window.py

@@ -0,0 +1,532 @@
+# window.py
+#
+# Copyright 2022-2023 kramo
+#
+# This program is free software: you can redistribute it and/or modify
+# it under the terms of the GNU General Public License as published by
+# the Free Software Foundation, either version 3 of the License, or
+# (at your option) any later version.
+#
+# This program is distributed in the hope that it will be useful,
+# but WITHOUT ANY WARRANTY; without even the implied warranty of
+# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+# GNU General Public License for more details.
+#
+# You should have received a copy of the GNU General Public License
+# along with this program.  If not, see <http://www.gnu.org/licenses/>.
+#
+# SPDX-License-Identifier: GPL-3.0-or-later
+
+from typing import Any, Optional
+
+from gi.repository import Adw, Gio, GLib, Gtk
+
+from cartridges import shared
+from cartridges.game import Game
+from cartridges.game_cover import GameCover
+from cartridges.utils.relative_date import relative_date
+
+
+@Gtk.Template(resource_path=shared.PREFIX + "/gtk/window.ui")
+class CartridgesWindow(Adw.ApplicationWindow):
+    __gtype_name__ = "CartridgesWindow"
+
+    overlay_split_view = Gtk.Template.Child()
+    navigation_view = Gtk.Template.Child()
+    sidebar = Gtk.Template.Child()
+    all_games_row_box = Gtk.Template.Child()
+    all_games_no_label = Gtk.Template.Child()
+    added_row_box = Gtk.Template.Child()
+    added_games_no_label = Gtk.Template.Child()
+    toast_overlay = Gtk.Template.Child()
+    primary_menu_button = Gtk.Template.Child()
+    show_sidebar_button = Gtk.Template.Child()
+    details_view = Gtk.Template.Child()
+    library_page = Gtk.Template.Child()
+    library_view = Gtk.Template.Child()
+    library = Gtk.Template.Child()
+    scrolledwindow = Gtk.Template.Child()
+    library_overlay = Gtk.Template.Child()
+    notice_empty = Gtk.Template.Child()
+    notice_no_results = Gtk.Template.Child()
+    search_bar = Gtk.Template.Child()
+    search_entry = Gtk.Template.Child()
+    search_button = Gtk.Template.Child()
+
+    details_page = Gtk.Template.Child()
+    details_view_toolbar_view = Gtk.Template.Child()
+    details_view_cover = Gtk.Template.Child()
+    details_view_spinner = Gtk.Template.Child()
+    details_view_title = Gtk.Template.Child()
+    details_view_blurred_cover = Gtk.Template.Child()
+    details_view_play_button = Gtk.Template.Child()
+    details_view_developer = Gtk.Template.Child()
+    details_view_added = Gtk.Template.Child()
+    details_view_last_played = Gtk.Template.Child()
+    details_view_hide_button = Gtk.Template.Child()
+
+    hidden_library_page = Gtk.Template.Child()
+    hidden_primary_menu_button = Gtk.Template.Child()
+    hidden_library = Gtk.Template.Child()
+    hidden_library_view = Gtk.Template.Child()
+    hidden_scrolledwindow = Gtk.Template.Child()
+    hidden_library_overlay = Gtk.Template.Child()
+    hidden_notice_empty = Gtk.Template.Child()
+    hidden_notice_no_results = Gtk.Template.Child()
+    hidden_search_bar = Gtk.Template.Child()
+    hidden_search_entry = Gtk.Template.Child()
+    hidden_search_button = Gtk.Template.Child()
+
+    game_covers: dict = {}
+    toasts: dict = {}
+    active_game: Game
+    details_view_game_cover: Optional[GameCover] = None
+    sort_state: str = "last_played"
+    filter_state: str = "all"
+    source_rows: dict = {}
+
+    def create_source_rows(self) -> None:
+        def get_removed(source_id: str) -> Any:
+            removed = tuple(
+                game.removed or game.hidden or game.blacklisted
+                for game in shared.store.source_games[source_id].values()
+            )
+            return (
+                (count,) if (count := sum(removed)) != len(removed) else False
+            )  # Return a tuple because 0 == False and 1 == True
+
+        total_games_no = 0
+        restored = False
+
+        selected_id = (
+            self.source_rows[selected_row][0]
+            if (selected_row := self.sidebar.get_selected_row()) in self.source_rows
+            else None
+        )
+
+        if selected_row == self.added_row_box.get_parent():
+            self.sidebar.select_row(self.added_row_box.get_parent())
+            restored = True
+
+        if added_missing := (
+            not shared.store.source_games.get("imported")
+            or not (removed := get_removed("imported"))
+        ):
+            self.sidebar.select_row(self.all_games_row_box.get_parent())
+        else:
+            games_no = len(shared.store.source_games["imported"]) - removed[0]
+            self.added_games_no_label.set_label(str(games_no))
+            total_games_no += games_no
+        self.added_row_box.get_parent().set_visible(not added_missing)
+
+        self.sidebar.get_row_at_index(2).set_visible(False)
+
+        while row := self.sidebar.get_row_at_index(3):
+            self.sidebar.remove(row)
+
+        for source_id in shared.store.source_games:
+            if source_id == "imported":
+                continue
+            if not (removed := get_removed(source_id)):
+                continue
+
+            row = Gtk.Box(
+                margin_top=12,
+                margin_bottom=12,
+                margin_start=6,
+                margin_end=6,
+                spacing=12,
+            )
+            games_no = len(shared.store.source_games[source_id]) - removed[0]
+            total_games_no += games_no
+
+            row.append(
+                Gtk.Image.new_from_icon_name(
+                    "user-desktop-symbolic"
+                    if (split_id := source_id.split("_")[0]) == "desktop"
+                    else f"{split_id}-source-symbolic"
+                )
+            )
+
+            row.append(
+                Gtk.Label(
+                    label=self.get_application().get_source_name(source_id),
+                    halign=Gtk.Align.START,
+                )
+            )
+
+            row.append(
+                games_no_label := Gtk.Label(
+                    label=games_no,
+                    hexpand=True,
+                    halign=Gtk.Align.END,
+                )
+            )
+
+            games_no_label.add_css_class("dim-label")
+
+            # Order rows based on the number of games in them
+            index = 3
+            while source_row := self.sidebar.get_row_at_index(index):
+                if self.source_rows[source_row][1] < games_no:
+                    self.sidebar.insert(row, index)
+                    break
+                index += 1
+            if not row.get_parent():
+                self.sidebar.append(row)
+
+            self.source_rows[row.get_parent()] = (
+                source_id,
+                games_no,
+            )
+
+            if source_id == selected_id:
+                self.sidebar.select_row(row.get_parent())
+                restored = True
+
+            self.sidebar.get_row_at_index(2).set_visible(True)
+
+        self.all_games_no_label.set_label(str(total_games_no))
+
+        if not restored:
+            self.sidebar.select_row(self.all_games_row_box.get_parent())
+
+    def row_selected(self, _widget: Any, row: Gtk.ListBoxRow | None) -> None:
+        if not row:
+            return
+        match row.get_child():
+            case self.all_games_row_box:
+                value = "all"
+            case self.added_row_box:
+                value = "imported"
+            case _:
+                value = self.source_rows[row][0]
+
+        self.library_page.set_title(self.get_application().get_source_name(value))
+
+        self.filter_state = value
+        self.library.invalidate_filter()
+
+        if self.overlay_split_view.get_collapsed():
+            self.overlay_split_view.set_show_sidebar(False)
+
+    def __init__(self, **kwargs: Any) -> None:
+        super().__init__(**kwargs)
+
+        self.details_view.set_measure_overlay(self.details_view_toolbar_view, True)
+        self.details_view.set_clip_overlay(self.details_view_toolbar_view, False)
+
+        self.library.set_filter_func(self.filter_func)
+        self.hidden_library.set_filter_func(self.filter_func)
+
+        self.library.set_sort_func(self.sort_func)
+        self.hidden_library.set_sort_func(self.sort_func)
+
+        self.set_library_child()
+
+        self.notice_empty.set_icon_name(shared.APP_ID + "-symbolic")
+
+        self.overlay_split_view.set_show_sidebar(
+            shared.state_schema.get_boolean("show-sidebar")
+        )
+
+        self.sidebar.select_row(self.all_games_row_box.get_parent())
+
+        if shared.PROFILE == "development":
+            self.add_css_class("devel")
+
+        # Connect search entries
+        self.search_bar.connect_entry(self.search_entry)
+        self.hidden_search_bar.connect_entry(self.hidden_search_entry)
+
+        # Connect signals
+        self.search_entry.connect("search-changed", self.search_changed, False)
+        self.hidden_search_entry.connect("search-changed", self.search_changed, True)
+
+        self.search_entry.connect("activate", self.show_details_page_search)
+        self.hidden_search_entry.connect("activate", self.show_details_page_search)
+
+        self.navigation_view.connect("popped", self.set_show_hidden)
+        self.navigation_view.connect("pushed", self.set_show_hidden)
+
+        self.sidebar.connect("row-selected", self.row_selected)
+
+        style_manager = Adw.StyleManager.get_default()
+        style_manager.connect("notify::dark", self.set_details_view_opacity)
+        style_manager.connect("notify::high-contrast", self.set_details_view_opacity)
+
+        # Allow for a custom number of rows for the library
+        if shared.schema.get_uint("library-rows"):
+            shared.schema.bind(
+                "library-rows",
+                self.library,
+                "max-children-per-line",
+                Gio.SettingsBindFlags.DEFAULT,
+            )
+            shared.schema.bind(
+                "library-rows",
+                self.hidden_library,
+                "max-children-per-line",
+                Gio.SettingsBindFlags.DEFAULT,
+            )
+
+    def search_changed(self, _widget: Any, hidden: bool) -> None:
+        # Refresh search filter on keystroke in search box
+        (self.hidden_library if hidden else self.library).invalidate_filter()
+
+    def set_library_child(self) -> None:
+        child, hidden_child = self.notice_empty, self.hidden_notice_empty
+
+        for game in shared.store:
+            if game.removed or game.blacklisted:
+                continue
+            if game.hidden:
+                if game.filtered and hidden_child:
+                    hidden_child = self.hidden_notice_no_results
+                    continue
+                hidden_child = None
+            else:
+                if game.filtered and child:
+                    child = self.notice_no_results
+                    continue
+                child = None
+
+        def remove_from_overlay(widget: Gtk.Widget) -> None:
+            if isinstance(widget.get_parent(), Gtk.Overlay):
+                widget.get_parent().remove_overlay(widget)
+
+        if child:
+            self.library_overlay.add_overlay(child)
+        else:
+            remove_from_overlay(self.notice_empty)
+            remove_from_overlay(self.notice_no_results)
+
+        if hidden_child:
+            self.hidden_library_overlay.add_overlay(hidden_child)
+        else:
+            remove_from_overlay(self.hidden_notice_empty)
+            remove_from_overlay(self.hidden_notice_no_results)
+
+    def filter_func(self, child: Gtk.Widget) -> bool:
+        game = child.get_child()
+        text = (
+            (
+                self.hidden_search_entry
+                if self.navigation_view.get_visible_page() == self.hidden_library_page
+                else self.search_entry
+            )
+            .get_text()
+            .lower()
+        )
+
+        filtered = text != "" and not (
+            text in game.name.lower()
+            or (text in game.developer.lower() if game.developer else False)
+        )
+
+        if not filtered:
+            if self.filter_state == "all":
+                pass
+            elif game.base_source != self.filter_state:
+                filtered = True
+
+        game.filtered = filtered
+        self.set_library_child()
+
+        return not filtered
+
+    def set_active_game(self, _widget: Any, _pspec: Any, game: Game) -> None:
+        self.active_game = game
+
+    def show_details_page(self, game: Game) -> None:
+        self.active_game = game
+
+        self.details_view_cover.set_opacity(int(not game.loading))
+        self.details_view_spinner.set_spinning(game.loading)
+
+        self.details_view_developer.set_label(game.developer or "")
+        self.details_view_developer.set_visible(bool(game.developer))
+
+        icon, text = "view-conceal-symbolic", _("Hide")
+        if game.hidden:
+            icon, text = "view-reveal-symbolic", _("Unhide")
+
+        self.details_view_hide_button.set_icon_name(icon)
+        self.details_view_hide_button.set_tooltip_text(text)
+
+        if self.details_view_game_cover:
+            self.details_view_game_cover.pictures.remove(self.details_view_cover)
+
+        self.details_view_game_cover = game.game_cover
+        self.details_view_game_cover.add_picture(self.details_view_cover)
+
+        self.details_view_blurred_cover.set_paintable(
+            self.details_view_game_cover.get_blurred()
+        )
+
+        self.details_view_title.set_label(game.name)
+        self.details_page.set_title(game.name)
+
+        date = relative_date(game.added)
+        self.details_view_added.set_label(
+            # The variable is the date when the game was added
+            _("Added: {}").format(date)
+        )
+        last_played_date = (
+            relative_date(game.last_played) if game.last_played else _("Never")
+        )
+        self.details_view_last_played.set_label(
+            # The variable is the date when the game was last played
+            _("Last played: {}").format(last_played_date)
+        )
+
+        if self.navigation_view.get_visible_page() != self.details_page:
+            self.navigation_view.push(self.details_page)
+            self.set_focus(self.details_view_play_button)
+
+        self.set_details_view_opacity()
+
+    def set_details_view_opacity(self, *_args: Any) -> None:
+        if self.navigation_view.get_visible_page() != self.details_page:
+            return
+
+        if (
+            style_manager := Adw.StyleManager.get_default()
+        ).get_high_contrast() or not style_manager.get_system_supports_color_schemes():
+            self.details_view_blurred_cover.set_opacity(0.3)
+            return
+
+        self.details_view_blurred_cover.set_opacity(
+            1 - self.details_view_game_cover.luminance[0]  # type: ignore
+            if style_manager.get_dark()
+            else self.details_view_game_cover.luminance[1]  # type: ignore
+        )
+
+    def sort_func(self, child1: Gtk.Widget, child2: Gtk.Widget) -> int:
+        var, order = "name", True
+
+        if self.sort_state in ("newest", "oldest"):
+            var, order = "added", self.sort_state == "newest"
+        elif self.sort_state == "last_played":
+            var = "last_played"
+        elif self.sort_state == "a-z":
+            order = False
+
+        def get_value(index: int) -> str:
+            return (
+                str(getattr((child1.get_child(), child2.get_child())[index], var))
+                .lower()
+                .removeprefix("the ")
+            )
+
+        if var != "name" and get_value(0) == get_value(1):
+            var, order = "name", False
+
+        return ((get_value(0) > get_value(1)) ^ order) * 2 - 1
+
+    def set_show_hidden(self, navigation_view: Adw.NavigationView, *_args: Any) -> None:
+        self.lookup_action("show_hidden").set_enabled(
+            navigation_view.get_visible_page() == self.library_page
+        )
+
+    def on_show_sidebar_action(self, *_args: Any) -> None:
+        shared.state_schema.set_boolean(
+            "show-sidebar", (value := not self.overlay_split_view.get_show_sidebar())
+        )
+        self.overlay_split_view.set_show_sidebar(value)
+
+    def on_go_to_parent_action(self, *_args: Any) -> None:
+        if self.navigation_view.get_visible_page() == self.details_page:
+            self.navigation_view.pop()
+
+    def on_go_home_action(self, *_args: Any) -> None:
+        self.navigation_view.pop_to_page(self.library_page)
+
+    def on_show_hidden_action(self, *_args: Any) -> None:
+        self.navigation_view.push(self.hidden_library_page)
+
+    def on_sort_action(self, action: Gio.SimpleAction, state: GLib.Variant) -> None:
+        action.set_state(state)
+        self.sort_state = str(state).strip("'")
+        self.library.invalidate_sort()
+
+        shared.state_schema.set_string("sort-mode", self.sort_state)
+
+    def on_toggle_search_action(self, *_args: Any) -> None:
+        if self.navigation_view.get_visible_page() == self.library_page:
+            search_bar = self.search_bar
+            search_entry = self.search_entry
+        elif self.navigation_view.get_visible_page() == self.hidden_library_page:
+            search_bar = self.hidden_search_bar
+            search_entry = self.hidden_search_entry
+        else:
+            return
+
+        search_bar.set_search_mode(not (search_mode := search_bar.get_search_mode()))
+
+        if not search_mode:
+            self.set_focus(search_entry)
+
+        search_entry.set_text("")
+
+    def on_escape_action(self, *_args: Any) -> None:
+        if (
+            self.get_focus() == self.search_entry.get_focus_child()
+            or self.hidden_search_entry.get_focus_child()
+        ):
+            self.on_toggle_search_action()
+        else:
+            self.navigation_view.pop()
+
+    def show_details_page_search(self, widget: Gtk.Widget) -> None:
+        library = (
+            self.hidden_library if widget == self.hidden_search_entry else self.library
+        )
+        index = 0
+
+        while True:
+            if not (child := library.get_child_at_index(index)):
+                break
+
+            if self.filter_func(child):
+                self.show_details_page(child.get_child())
+                break
+
+            index += 1
+
+    def on_undo_action(
+        self, _widget: Any, game: Optional[Game] = None, undo: Optional[str] = None
+    ) -> None:
+        if not game:  # If the action was activated via Ctrl + Z
+            if shared.importer and (
+                shared.importer.imported_game_ids or shared.importer.removed_game_ids
+            ):
+                shared.importer.undo_import()
+                return
+
+            try:
+                game = tuple(self.toasts.keys())[-1][0]
+                undo = tuple(self.toasts.keys())[-1][1]
+            except IndexError:
+                return
+
+        if game:
+            if undo == "hide":
+                game.toggle_hidden(False)
+
+            elif undo == "remove":
+                game.removed = False
+                game.save()
+                game.update()
+
+            self.toasts[(game, undo)].dismiss()
+            self.toasts.pop((game, undo))
+
+    def on_open_menu_action(self, *_args: Any) -> None:
+        if self.navigation_view.get_visible_page() == self.library_page:
+            self.primary_menu_button.popup()
+        elif self.navigation_view.get_visible_page() == self.hidden_library_page:
+            self.hidden_primary_menu_button.popup()
+
+    def on_close_action(self, *_args: Any) -> None:
+        self.close()

data/cartridges.gresource.xml

@@ -1,12 +0,0 @@
-<?xml version="1.0" encoding="UTF-8"?>
-<gresources>
-  <gresource prefix="/hu/kramo/Cartridges">
-    <file preprocess="xml-stripblanks">gtk/window.ui</file>
-    <file preprocess="xml-stripblanks">gtk/help-overlay.ui</file>
-    <file preprocess="xml-stripblanks">gtk/game.ui</file>
-    <file preprocess="xml-stripblanks">gtk/preferences.ui</file>
-    <file alias="style.css">gtk/style.css</file>
-    <file alias="style-dark.css">gtk/style-dark.css</file>
-    <file>library_placeholder.svg</file>
-  </gresource>
-</gresources>

data/cartridges.gresource.xml.in

@@ -0,0 +1,25 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<gresources>
+  <gresource prefix="@PREFIX@">
+    <file preprocess="xml-stripblanks">@APP_ID@.metainfo.xml</file>
+    <file preprocess="xml-stripblanks">gtk/window.ui</file>
+    <file preprocess="xml-stripblanks">gtk/help-overlay.ui</file>
+    <file preprocess="xml-stripblanks">gtk/game.ui</file>
+    <file preprocess="xml-stripblanks">gtk/preferences.ui</file>
+    <file preprocess="xml-stripblanks">gtk/details-window.ui</file>
+    <file alias="style.css">gtk/style.css</file>
+    <file alias="style-dark.css">gtk/style-dark.css</file>
+    <file>library_placeholder.svg</file>
+    <file>library_placeholder_small.svg</file>
+  </gresource>
+  <gresource prefix="@PREFIX@/icons/scalable/categories/">
+  <file alias="bottles-source-symbolic.svg">icons/sources/bottles-source-symbolic.svg</file>
+  <file alias="flatpak-source-symbolic.svg">icons/sources/flatpak-source-symbolic.svg</file>
+  <file alias="heroic-source-symbolic.svg">icons/sources/heroic-source-symbolic.svg</file>
+  <file alias="itch-source-symbolic.svg">icons/sources/itch-source-symbolic.svg</file>
+  <file alias="legendary-source-symbolic.svg">icons/sources/legendary-source-symbolic.svg</file>
+  <file alias="lutris-source-symbolic.svg">icons/sources/lutris-source-symbolic.svg</file>
+  <file alias="retroarch-source-symbolic.svg">icons/sources/retroarch-source-symbolic.svg</file>
+  <file alias="steam-source-symbolic.svg">icons/sources/steam-source-symbolic.svg</file>
+  </gresource>
+</gresources>

data/gtk/details-window.blp

@@ -0,0 +1,152 @@
+using Gtk 4.0;
+using Adw 1;
+
+template $DetailsWindow : Adw.Window {
+    default-width: 480; // Same as Nautilus' properties window
+    default-height: -1;
+    modal: true;
+
+    ShortcutController {
+        Shortcut {
+            trigger: "Escape";
+            action: "action(window.close)";
+        }
+    }
+
+    Adw.ToolbarView {
+
+        [top]
+        Adw.HeaderBar HeaderBar {
+            show-start-title-buttons: false;
+            show-end-title-buttons: false;
+
+            [start]
+            Button cancel_button {
+                label: _("Cancel");
+                action-name: "window.close";
+            }
+
+            [end]
+            Button apply_button {
+                styles [
+                    "suggested-action"
+                ]
+            }
+        }
+
+        Adw.PreferencesPage {
+            Adw.PreferencesGroup cover_group {
+                Adw.Clamp cover_clamp {
+                    maximum-size: 200;
+                    Overlay {
+                        [overlay]
+                        Spinner spinner {
+                            margin-start: 72;
+                            margin-end: 72;
+                        }
+
+                        Overlay cover_overlay {
+                            halign: center;
+                            valign: center;
+
+                            [overlay]
+                            Button cover_button_edit {
+                                icon-name: "document-edit-symbolic";
+                                tooltip-text: _("New Cover");
+                                halign: end;
+                                valign: end;
+                                margin-bottom: 6;
+                                margin-end: 6;
+
+                                styles [
+                                    "circular", "osd"
+                                ]
+                            }
+
+                            [overlay]
+                            Revealer cover_button_delete_revealer {
+                                transition-type: crossfade;
+                                margin-end: 40;
+
+                                Button cover_button_delete {
+                                    icon-name: "user-trash-symbolic";
+                                    tooltip-text: _("Delete Cover");
+                                    halign: end;
+                                    valign: end;
+                                    margin-bottom: 6;
+                                    margin-end: 6;
+
+                                    styles [
+                                        "circular", "osd"
+                                    ]
+                                }
+                            }
+
+                            Picture cover {
+                                width-request: 200;
+                                height-request: 300;
+                                
+                                styles [
+                                    "card"
+                                ]
+                            }
+                        }
+                    }
+                }
+            }
+
+            Adw.PreferencesGroup {
+                Adw.EntryRow name {
+                    title: _("Title");
+                }
+                Adw.EntryRow developer {
+                    title: _("Developer (optional)");
+                }
+            }
+            Adw.PreferencesGroup {
+                Adw.EntryRow executable {
+                    title: _("Executable");
+
+                    [suffix]
+                    Button file_chooser_button {
+                      valign: center;
+                      icon-name: "document-open-symbolic";
+                      tooltip-text: _("Select File");
+
+                      styles [
+                        "flat",
+                      ]
+                    }
+
+                    [suffix]
+                    MenuButton exec_info_button {
+                    valign: center;
+                    icon-name: "help-about-symbolic";
+                    tooltip-text: _("More Info");
+
+                    popover: Popover exec_info_popover {
+                        focusable: true;
+
+                        Label exec_info_label {
+                            use-markup: true;
+                            wrap: true;
+                            max-width-chars: 50;
+                            halign: center;
+                            valign: center;
+                            margin-top: 6;
+                            margin-bottom: 6;
+                            margin-start: 6;
+                            margin-end: 6;
+                        }
+                    };
+
+                    styles [
+                        "flat"
+                    ]
+                }
+
+                }
+            }
+        }
+    }
+}

data/gtk/game.blp

@@ -1,120 +1,114 @@
 using Gtk 4.0;
 using Adw 1;
 
-template game : Box {
+template $Game : Box {
   orientation: vertical;
   halign: center;
   valign: start;
 
   Adw.Clamp {
     maximum-size: 200;
+    unit: px;
+
+    Overlay {
+      [overlay]
+      Revealer play_revealer {
+        transition-type: crossfade;
+        valign: start;
+        halign: start;
+
+        Button play_button {
+          icon-name: "media-playback-start-symbolic";
+          margin-start: 6;
+          margin-end: 3;
+          margin-top: 6;
+          margin-bottom: 3;
+
+          styles [
+            "circular",
+            "osd",
+          ]
+        }
+      }
+
+      [overlay]
+      Revealer menu_revealer {
+        transition-type: crossfade;
+        valign: start;
+        halign: end;
+
+        MenuButton menu_button {
+          icon-name: "view-more-symbolic";
+          margin-start: 3;
+          margin-end: 6;
+          margin-top: 6;
+          margin-bottom: 3;
+
+          styles [
+            "circular",
+            "osd",
+          ]
+        }
+      }
+
+      Button cover_button {
+        name: "cover_button";
+        overflow: hidden;
+
+        accessibility {
+          labelled-by: title;
+        }
+
         Box {
           orientation: vertical;
-      Button cover_button {
+
+          Overlay {
+            [overlay]
+            Spinner spinner {
+              margin-start: 72;
+              margin-end: 72;
+            }
+
             Picture cover {
               width-request: 200;
               height-request: 300;
               hexpand: true;
               vexpand: true;
-
+            }
-          styles [
-            "card",
-          ]
           }
 
-        styles [
-          "card",
-          "flat",
-        ]
-      }
-      Overlay overlay {
-        [overlay]
-        Revealer play_revealer {
-          reveal-child: false;
-          transition-type: crossfade;
-          Box {
-            Button button_play {
-              halign: start;
-              label: _("Play");
-              margin-start: 6;
-              margin-end: 6;
-              margin-top: 6;
-              margin-bottom: 6;
-            }
-            MenuButton menu_button {
-              icon-name: "view-more-symbolic";
-              margin-top: 6;
-              margin-bottom: 6;
-              margin-end: 6;
-              margin-start: 6;
-              menu-model: game_options;
-              hexpand: true;
-              halign: end;
-
-              styles [
-                "flat",
-              ]
-            }
-          }
-        }
-        Revealer title_revealer {
-          transition-type: slide_down;
-          reveal-child: true;
-          valign: start;
           Label title {
             label: _("Title");
             ellipsize: end;
             hexpand: true;
             halign: start;
-            margin-top: 14;
+            margin-top: 15;
-            margin-bottom: 14;
+            margin-bottom: 15;
             margin-start: 12;
             margin-end: 12;
           }
         }
-      }
-    }
-  }
 
         styles [
           "card",
         ]
       }
+    }
+  }
+}
 
 menu game_options {
   section {
-    item {
+    item (_("Edit"), "app.edit_game")
-      label: _("Edit");
+    item (_("Hide"), "app.hide_game")
-      action: "app.edit_details";
+    item (_("Remove"), "app.remove_game")
-    }
-
-    item {
-      label: _("Hide");
-      action: "app.hide_game";
-    }
-
-    item {
-      label: _("Remove");
-      action: "app.remove_game";
-    }
   }
 }
 
 menu hidden_game_options {
   section {
-    item {
+    item (_("Edit"), "app.edit_game")
-      label: _("Edit");
+    item (_("Unhide"), "app.hide_game")
-      action: "app.edit_details";
+    item (_("Remove"), "app.remove_game")
-    }
-
-    item {
-      label: _("Unhide");
-      action: "app.hide_game";
-    }
-
-    item {
-      label: _("Remove");
-      action: "app.remove_game";
-    }
   }
 }

data/gtk/help-overlay.blp

@@ -8,51 +8,66 @@ ShortcutsWindow help_overlay {
     max-height: 10;
 
     ShortcutsGroup {
-      title: C_("shortcut window", "General");
+      title: _("General");
 
       ShortcutsShortcut {
-        title: C_("shortcut window", "Quit");
+        title: _("Search");
-        action-name: "app.quit";
-      }
-
-      ShortcutsShortcut {
-        title: C_("shortcut window", "Search");
         action-name: "win.toggle_search";
       }
 
       ShortcutsShortcut {
-        title: C_("shortcut window", "Show preferences");
+        title: _("Preferences");
         action-name: "app.preferences";
       }
 
       ShortcutsShortcut {
-        title: C_("shortcut window", "Shortcuts");
+        title: _("Keyboard Shortcuts");
         action-name: "win.show-help-overlay";
       }
 
       ShortcutsShortcut {
-        title: C_("shortcut window", "Undo");
+        title: _("Undo");
-        action-name: "win.undo_remove";
+        action-name: "win.undo";
       }
 
       ShortcutsShortcut {
-        title: C_("shortcut window", "Open menu");
+        title: _("Quit");
+        action-name: "app.quit";
+      }
+
+      ShortcutsShortcut {
+        title: _("Toggle Sidebar");
+        action-name: "win.show_sidebar";
+      }
+
+      ShortcutsShortcut {
+        title: _("Main Menu");
         action-name: "win.open_menu";
       }
     }
 
     ShortcutsGroup {
-      title: C_("shortcut window", "Games");
+      title: _("Games");
 
       ShortcutsShortcut {
-        title: C_("shortcut window", "Add new game");
+        title: _("Add Game");
         action-name: "app.add_game";
       }
 
       ShortcutsShortcut {
-        title: C_("shortcut window", "Show hidden games");
+        title: _("Import");
+        action-name: "app.import";
+      }
+
+      ShortcutsShortcut {
+        title: _("Show Hidden Games");
         action-name: "win.show_hidden";
       }
+
+      ShortcutsShortcut {
+        title: _("Remove Game");
+        action-name: "app.remove_game_details_view";
+      }
     }
   }
 }

data/gtk/preferences.blp

@@ -1,85 +1,401 @@
 using Gtk 4.0;
 using Adw 1;
 
-template PreferencesWindow : Adw.PreferencesWindow {
+template $PreferencesWindow : Adw.PreferencesWindow {
-  search-enabled: false;
-  default-height: 500;
 
-  Adw.PreferencesPage page {
+  Adw.PreferencesPage general_page {
-    Adw.PreferencesGroup {
+    name: "general";
     title: _("General");
+    icon-name: "user-home-symbolic";
 
-      Adw.ActionRow {
+    Adw.PreferencesGroup behavior_group {
+      title: _("Behavior");
+
+      Adw.SwitchRow exit_after_launch_switch {
         title: _("Exit After Launching Games");
+      }
 
-        Switch exit_after_launch_switch {
+      Adw.SwitchRow cover_launches_game_switch {
+        title: _("Cover Image Launches Game");
+        subtitle: _("Swaps the behavior of the cover image and the play button");
+      }
+    }
+
+    Adw.PreferencesGroup images_group {
+      title: _("Images");
+
+      Adw.SwitchRow high_quality_images_switch {
+        title: _("High Quality Images");
+        subtitle: _("Save game covers losslessly at the cost of storage");
+      }
+    }
+
+    Adw.PreferencesGroup danger_zone_group {
+      title: _("Danger Zone");
+
+      ListBox remove_all_games_list_box {
+        Adw.PreferencesRow {
+        activatable: true;
+        selectable: false;
+
+        Box {
+          spacing: 6;
           valign: center;
+          halign: center;
+
+          Label {
+            label: _("Remove All Games");
+            ellipsize: end;
+
+            styles [
+              "heading",
+            ]
+          }
+
+          styles [
+            "header",
+          ]
+        }
+
+          styles [
+            "error",
+          ]
+        }
+
+        styles [
+          "boxed-list",
+        ]
+      }
+    }
+
+    Adw.PreferencesGroup reset_group {
+      visible: false;
+
+      ListBox reset_list_box {
+        Adw.PreferencesRow {
+        activatable: true;
+        selectable: false;
+
+        Box {
+          spacing: 6;
+          valign: center;
+          halign: center;
+
+          Label {
+            label: "Reset App";
+            ellipsize: end;
+
+            styles [
+              "heading",
+            ]
+          }
+
+          styles [
+            "header",
+          ]
+        }
+
+          styles [
+            "error",
+          ]
+        }
+
+        styles [
+          "boxed-list",
+        ]
       }
     }
   }
 
-    Adw.PreferencesGroup steam_group {
+  Adw.PreferencesPage import_page {
-      title: "Steam";
+    name: "import";
+    title: _("Import");
+    icon-name: "document-save-symbolic";
 
-      Adw.ActionRow {
+    Adw.PreferencesGroup import_behavior_group {
-        title: _("Steam Install Location");
+      title: _("Behavior");
-        subtitle: _("Directory to use when importing games");
 
-        Button steam_file_chooser_button {
+      Adw.SwitchRow remove_missing_switch {
+        title: _("Remove Uninstalled Games");
+      }
+    }
+
+    Adw.PreferencesGroup sources_group {
+      title: _("Sources");
+
+      Adw.ExpanderRow steam_expander_row {
+        title: _("Steam");
+        show-enable-switch: true;
+
+        [prefix]
+        Image {
+          icon-name: "steam-source-symbolic";
+        }
+
+        Adw.ActionRow steam_data_action_row {
+          title: _("Install Location");
+
+          Button steam_data_file_chooser_button {
             icon-name: "folder-symbolic";
             valign: center;
+            styles [
+              "flat"
+            ]
           }
         }
       }
 
-    Adw.PreferencesGroup heroic_group {
+      Adw.ExpanderRow lutris_expander_row {
-      title: "Heroic";
+        title: _("Lutris");
+        show-enable-switch: true;
 
-      Adw.ActionRow {
+        [prefix]
-        title: _("Heroic Install Location");
+        Image {
-        subtitle: _("Directory to use when importing games");
+          icon-name: "lutris-source-symbolic";
+        }
 
-        Button heroic_file_chooser_button {
+        Adw.ActionRow lutris_data_action_row {
+          title: _("Install Location");
+
+          Button lutris_data_file_chooser_button {
             icon-name: "folder-symbolic";
             valign: center;
+            styles [
+              "flat"
+            ]
           }
         }
 
-      Adw.ActionRow {
+        Adw.SwitchRow lutris_import_steam_switch {
+          title: _("Import Steam Games");
+        }
+
+        Adw.SwitchRow lutris_import_flatpak_switch {
+          title: _("Import Flatpak Games");
+        }
+      }
+
+      Adw.ExpanderRow heroic_expander_row {
+        title: _("Heroic");
+        show-enable-switch: true;
+
+        [prefix]
+        Image {
+          icon-name: "heroic-source-symbolic";
+        }
+
+        Adw.ActionRow heroic_config_action_row {
+          title: _("Install Location");
+
+          Button heroic_config_file_chooser_button {
+            icon-name: "folder-symbolic";
+            valign: center;
+            styles [
+              "flat"
+            ]
+          }
+        }
+
+        Adw.SwitchRow heroic_import_epic_switch {
           title: _("Import Epic Games");
-
-        Switch import_epic_games_switch {
-          valign: center;
-        }
         }
 
-      Adw.ActionRow {
+        Adw.SwitchRow heroic_import_gog_switch {
           title: _("Import GOG Games");
-
-        Switch import_gog_games_switch {
-          valign: center;
-        }
         }
 
-      Adw.ActionRow {
+        Adw.SwitchRow heroic_import_amazon_switch  {
+          title: _("Import Amazon Games");
+        }
+
+        Adw.SwitchRow heroic_import_sideload_switch {
           title: _("Import Sideloaded Games");
-
-        Switch import_sideload_games_switch {
-          valign: center;
         }
       }
+
+      Adw.ExpanderRow bottles_expander_row {
+        title: _("Bottles");
+        show-enable-switch: true;
+
+        [prefix]
+        Image {
+          icon-name: "bottles-source-symbolic";
         }
 
-    Adw.PreferencesGroup bottles_group {
+        Adw.ActionRow bottles_data_action_row {
-      title: "Bottles";
+          title: _("Install Location");
 
-      Adw.ActionRow {
+          Button bottles_data_file_chooser_button {
-        title: _("Bottles Install Location");
-        subtitle: _("Directory to use when importing games");
-
-        Button bottles_file_chooser_button {
             icon-name: "folder-symbolic";
             valign: center;
+            styles [
+              "flat"
+            ]
+          }
+        }
+      }
+
+      Adw.ExpanderRow itch_expander_row {
+        title: _("itch");
+        show-enable-switch: true;
+
+        [prefix]
+        Image {
+          icon-name: "itch-source-symbolic";
+        }
+
+        Adw.ActionRow itch_config_action_row {
+          title: _("Install Location");
+
+          Button itch_config_file_chooser_button {
+            icon-name: "folder-symbolic";
+            valign: center;
+            styles [
+              "flat"
+            ]
+          }
+        }
+      }
+
+      Adw.ExpanderRow legendary_expander_row {
+        title: _("Legendary");
+        show-enable-switch: true;
+
+        [prefix]
+        Image {
+          icon-name: "legendary-source-symbolic";
+        }
+
+        Adw.ActionRow legendary_config_action_row {
+          title: _("Install Location");
+
+          Button legendary_config_file_chooser_button {
+            icon-name: "folder-symbolic";
+            valign: center;
+            styles [
+              "flat"
+            ]
+          }
+        }
+      }
+
+      Adw.ExpanderRow retroarch_expander_row {
+        title: _("RetroArch");
+        show-enable-switch: true;
+
+        [prefix]
+        Image {
+          icon-name: "retroarch-source-symbolic";
+        }
+
+        Adw.ActionRow retroarch_config_action_row {
+          title: _("Install Location");
+
+          Button retroarch_config_file_chooser_button {
+            icon-name: "folder-symbolic";
+            valign: center;
+            styles [
+              "flat"
+            ]
+          }
+        }
+      }
+
+      Adw.ExpanderRow flatpak_expander_row {
+        title: _("Flatpak");
+        show-enable-switch: true;
+
+        [prefix]
+        Image {
+          icon-name: "flatpak-source-symbolic";
+        }
+
+        Adw.ActionRow flatpak_system_data_action_row {
+          // The location of the system-wide data directory
+          title: _("System Location");
+
+          Button flatpak_system_data_file_chooser_button {
+            icon-name: "folder-symbolic";
+            valign: center;
+            styles [
+              "flat"
+            ]
+          }
+        }
+
+        Adw.ActionRow flatpak_user_data_action_row {
+          // The location of the user-specific data directory
+          title: _("User Location");
+
+          Button flatpak_user_data_file_chooser_button {
+            icon-name: "folder-symbolic";
+            valign: center;
+            styles [
+              "flat"
+            ]
+          }
+        }
+
+        Adw.SwitchRow flatpak_import_launchers_switch {
+          title: _("Import Game Launchers");
+        }
+      }
+
+      Adw.SwitchRow desktop_switch {
+        title: _("Desktop Entries");
+
+        [prefix]
+        Image {
+          icon-name: "user-desktop-symbolic";
+        }
+      }
+    }
+  }
+
+  Adw.PreferencesPage sgdb_page {
+    name: "sgdb";
+    title: _("SteamGridDB");
+    icon-name: "image-x-generic-symbolic";
+
+    Adw.PreferencesGroup sgdb_key_group {
+      title: _("Authentication");
+
+      Adw.EntryRow sgdb_key_entry_row {
+        title: _("API Key");
+      }
+    }
+
+    Adw.PreferencesGroup sgdb_behavior_group {
+      title: _("Behavior");
+
+      Adw.SwitchRow sgdb_switch {
+        title: _("Use SteamGridDB");
+        subtitle: _("Download images when adding or importing games");
+      }
+
+      Adw.SwitchRow sgdb_prefer_switch {
+        title: _("Prefer Over Official Images");
+      }
+
+      Adw.SwitchRow sgdb_animated_switch {
+        title: _("Prefer Animated Images");
+      }
+    }
+
+    Adw.PreferencesGroup {
+      Adw.ActionRow {
+        title: _("Update Covers");
+        subtitle: _("Fetch covers for games already in your library");
+        sensitive: bind sgdb_switch.active;
+
+        Stack sgdb_stack {
+          Button sgdb_fetch_button {
+            label: _("Update");
+            valign: center;
+          }
+          Spinner sgdb_spinner {
+            valign: center;
+          }
         }
       }
     }

data/gtk/style-dark.css

@@ -1,2 +1,11 @@
 @define-color accent_color @purple_1;
 @define-color accent_bg_color @purple_4;
+
+#details_view {
+    background-color: black;
+}
+
+#details_view_play_button {
+    color: rgba(0, 0, 0, .8);
+    background-color: white;
+}

data/gtk/style.css

@@ -1,2 +1,11 @@
 @define-color accent_color @purple_5;
 @define-color accent_bg_color @purple_3;
+
+#details_view {
+    background-color: white;
+}
+
+#details_view_play_button {
+    color: white;
+    background-color: rgba(0, 0, 0, .8);
+}

data/gtk/window.blp

@@ -9,12 +9,30 @@ Adw.StatusPage notice_no_results {
   valign: center;
 }
 
-Adw.StatusPage notice_empty {
+Adw.StatusPage hidden_notice_no_results {
-  icon-name: "applications-games-symbolic";
+  icon-name: "system-search-symbolic";
   title: _("No Games Found");
+  description: _("Try a different search.");
+  vexpand: true;
+  valign: center;
+}
+
+Adw.StatusPage notice_empty {
+  title: _("No Games");
   description: _("Use the + button to add games.");
   vexpand: true;
   valign: center;
+
+  Button {
+    label: _("Import");
+    halign: center;
+    action-name: "app.import";
+
+    styles [
+      "pill",
+      "suggested-action",
+    ]
+  }
 }
 
 Adw.StatusPage hidden_notice_empty {
@@ -25,41 +43,264 @@ Adw.StatusPage hidden_notice_empty {
   valign: center;
 }
 
-template CartridgesWindow : Adw.ApplicationWindow {
+template $CartridgesWindow : Adw.ApplicationWindow {
   title: _("Cartridges");
+  width-request: 281;
+  height-request: 100;
 
-  Adw.ToastOverlay toast_overlay {
+  Adw.Breakpoint {
-    Stack stack {
+    condition ("max-width: 564px")
-      visible-child: library_view;
+    setters {
-      transition-type: over_left;
+      overlay_split_view.collapsed: true;
-
+      details_view_box.orientation: vertical;
-      Overlay overview {
+      details_view_box.margin-top: 12;
-        [overlay]
+      details_view_box.margin-start: 12;
-        Box overview_box {
+      details_view_box.margin-end: 12;
-          orientation: vertical;
+      details_view_details_box.margin-start: 0;
-
+      details_view_details_box.margin-end: 0;
-          Adw.HeaderBar {
+      details_view_title.margin-top: 30;
-            [start]
+      details_view_title.halign: center;
-            Button back_button {
+      details_view_developer.halign: center;
-              action-name: "win.go_back";
+      details_view_date_box.halign: center;
-              icon-name: "go-previous-symbolic";
+      details_view_toolbar.halign: center;
+      details_view_toolbar.orientation: vertical;
+      details_view_play_button.halign: center;
+      details_view_toolbar_buttons.margin-start: 0;
+    }
   }
 
-            [title]
+  Adw.ToastOverlay toast_overlay {
-            Adw.WindowTitle overview_header_bar_title {
+    Adw.NavigationView navigation_view {
-              title: _("Game Details");
+        Adw.NavigationPage library_page {
+          title: _("All Games");
+
+          Adw.OverlaySplitView overlay_split_view {
+            [sidebar]
+            Adw.NavigationPage {
+              title: _("Cartridges");
+              Adw.ToolbarView {
+                [top]
+                Adw.HeaderBar {
+                  [start]
+                  Button {
+                    icon-name: "sidebar-show-symbolic";
+                    action-name: "win.show_sidebar";
+                    tooltip-text: _("Toggle Sidebar");
+                  }
+                }
+
+                ScrolledWindow {
+                  ListBox sidebar {
+                    Box all_games_row_box {
+                      margin-top: 12;
+                      margin-bottom: 12;
+                      margin-start: 6;
+                      margin-end: 6;
+                      spacing: 12;
+
+                      Image {
+                        icon-name: "view-grid-symbolic";
+                      }
+                      Label {
+                        halign: start;
+                        label: _("All Games");
+                      }
+                      Label all_games_no_label {
+                        hexpand: true;
+                        halign: end;
+
+                        styles ["dim-label"]
+                      }
+                    }
+                    Box added_row_box {
+                      margin-top: 12;
+                      margin-bottom: 12;
+                      margin-start: 6;
+                      spacing: 12;
+
+                      Image {
+                        icon-name: "list-add-symbolic";
+                      }
+                      Label {
+                        halign: start;
+                        label: _("Added");
+                        margin-end: 6;
+                      }
+                      Label added_games_no_label {
+                        hexpand: true;
+                        halign: end;
+                        margin-end: 6;
+
+                        styles ["dim-label"]
+                      }
+                    }
+                    ListBoxRow {
+                      selectable: false;
+                      activatable: false;
+                      Label {
+                        label: _("Imported");
+                        styles ["heading"]
+                        halign: start;
+                      }
+                    }
+                    styles ["navigation-sidebar"]
+                  }
+                }
+              }
+            }
+
+            Adw.ToolbarView library_view {
+
+              [top]
+              Adw.HeaderBar header_bar {
+
+                [start]
+                Revealer {
+                  transition-type: slide_right;
+                  reveal-child: bind overlay_split_view.show-sidebar inverted;
+                  Button show_sidebar_button {
+                    icon-name: "sidebar-show-symbolic";
+                    action-name: "win.show_sidebar";
+                    tooltip-text: _("Toggle Sidebar");
+                  }
+                }
+
+                [start]
+                MenuButton {
+                  tooltip-text: _("Add Game");
+                  icon-name: "list-add-symbolic";
+                  menu-model: add_games;
+                }
+
+                [end]
+                MenuButton primary_menu_button {
+                  tooltip-text: _("Main Menu");
+                  icon-name: "open-menu-symbolic";
+                  menu-model: primary_menu;
+                }
+
+                [end]
+                ToggleButton search_button {
+                  tooltip-text: _("Search");
+                  icon-name: "system-search-symbolic";
+                  action-name: "win.toggle_search";
+                }
+              }
+
+              [top]
+              SearchBar search_bar {
+                search-mode-enabled: bind search_button.active bidirectional;
+                key-capture-widget: navigation_view;
+
+                Adw.Clamp {
+                  maximum-size: 500;
+                  tightening-threshold: 500;
+
+                  SearchEntry search_entry {
+                    placeholder-text: _("Search");
+                    hexpand: true;
+                  }
+                }
+              }
+
+              Overlay library_overlay {
+                ScrolledWindow scrolledwindow {
+                  FlowBox library {
+                    homogeneous: true;
+                    halign: center;
+                    valign: start;
+                    column-spacing: 12;
+                    row-spacing: 12;
+                    margin-top: 15;
+                    margin-bottom: 15;
+                    margin-start: 15;
+                    margin-end: 15;
+                    selection-mode: none;
+                  }
+                }
+              }
+            }
+          }
+        }
+      }
+    }
+  }
+
+Adw.NavigationPage hidden_library_page {
+  title: _("Hidden Games");
+
+  Adw.ToolbarView hidden_library_view {
+    [top]
+    Adw.HeaderBar hidden_header_bar {
+      [end]
+      MenuButton hidden_primary_menu_button {
+        tooltip-text: _("Main Menu");
+        icon-name: "open-menu-symbolic";
+        menu-model: primary_menu;
+      }
+
+      [end]
+      ToggleButton hidden_search_button {
+        tooltip-text: _("Search");
+        icon-name: "system-search-symbolic";
+        action-name: "win.toggle_search";
+      }
+    }
+
+    [top]
+    SearchBar hidden_search_bar {
+      search-mode-enabled: bind hidden_search_button.active bidirectional;
+      key-capture-widget: hidden_library_view;
+
+      Adw.Clamp {
+        maximum-size: 500;
+        tightening-threshold: 500;
+
+        SearchEntry hidden_search_entry {
+          placeholder-text: _("Search");
+          hexpand: true;
+        }
+      }
+    }
+
+    Overlay hidden_library_overlay {
+      ScrolledWindow hidden_scrolledwindow {
+        FlowBox hidden_library {
+          homogeneous: true;
+          halign: center;
+          valign: start;
+          column-spacing: 12;
+          row-spacing: 12;
+          margin-top: 15;
+          margin-bottom: 15;
+          margin-start: 15;
+          margin-end: 15;
+          selection-mode: none;
+        }
+      }
     }
 
     styles [
-              "flat",
+      "background",
     ]
   }
+}
 
-          Adw.Bin {
+Adw.NavigationPage details_page {
-            hexpand: true;
+  title: _("Game Details");
-            vexpand: true;
 
-            Box {
+  Overlay details_view {
+    name: "details_view";
+
+    [overlay]
+    Adw.ToolbarView details_view_toolbar_view {
+
+      [top]
+      Adw.HeaderBar {
+      }
+
+      ScrolledWindow {
+        Box details_view_box {
           halign: center;
           valign: center;
           margin-start: 24;
@@ -69,7 +310,15 @@ template CartridgesWindow : Adw.ApplicationWindow {
 
           Adw.Clamp {
             maximum-size: 200;
-                Picture overview_cover {
+
+            Overlay {
+              [overlay]
+              Spinner details_view_spinner {
+                margin-start: 72;
+                margin-end: 72;
+              }
+
+              Picture details_view_cover {
                 halign: end;
                 valign: start;
                 width-request: 200;
@@ -80,17 +329,19 @@ template CartridgesWindow : Adw.ApplicationWindow {
                 ]
               }
             }
+          }
 
-              Box {
+          Box details_view_details_box {
             orientation: vertical;
             margin-start: 48;
             vexpand: true;
             valign: center;
 
-                Label overview_title {
+            Label details_view_title {
               label: _("Game Title");
               hexpand: true;
               halign: start;
+              max-width-chars: 24;
               wrap: true;
               wrap-mode: word_char;
               natural-wrap-mode: word;
@@ -100,210 +351,120 @@ template CartridgesWindow : Adw.ApplicationWindow {
               ]
             }
 
-                Label overview_developer {
+            Label details_view_developer {
-                  margin-top: 3;
-                  hexpand: true;
-                  halign: start;
-                  wrap: true;
-                  wrap-mode: word_char;
-                  natural-wrap-mode: word;
-
-                  styles [
-                    "heading"
-                  ]
-                }
-
-                Label overview_added {
-                  margin-top: 12;
-                  hexpand: true;
-                  halign: start;
-                  wrap: true;
-                  wrap-mode: word_char;
-                  natural-wrap-mode: word;
-
-                  styles [
-                    "dim-label",
-                  ]
-                }
-                Label overview_last_played {
               margin-top: 6;
               hexpand: true;
               halign: start;
+              max-width-chars: 36;
               wrap: true;
               wrap-mode: word_char;
               natural-wrap-mode: word;
 
               styles [
-                    "dim-label",
+                "heading",
               ]
             }
-                Box {
+
+            Box details_view_date_box {
+              orientation: horizontal;
+              margin-top: 15;
+              hexpand: true;
+              halign: start;
+
+              Label details_view_added {
+                wrap: true;
+                wrap-mode: word_char;
+                natural-wrap-mode: word;
+                justify: center;
+              }
+
+              Label details_view_last_played {
+                margin-start: 12;
+                wrap: true;
+                wrap-mode: word_char;
+                natural-wrap-mode: word;
+                justify: center;
+              }
+            }
+
+            Box details_view_toolbar {
               hexpand: true;
               vexpand: true;
               valign: center;
 
-                  Button overview_launch {
+              Button details_view_play_button {
+                name: "details_view_play_button";
                 action-name: "app.launch_game";
                 label: _("Play");
                 halign: start;
                 margin-top: 24;
 
                 styles [
-                      "suggested-action",
+                  "opaque",
                   "pill",
                 ]
               }
 
-                  MenuButton overview_menu_button {
+              Box details_view_toolbar_buttons {
-                    icon-name: "view-more-symbolic";
-                    hexpand: true;
-                    vexpand: true;
                 halign: start;
                 valign: center;
                 margin-top: 24;
-                    margin-start: 6;
+                margin-start: 9;
+
+                Button {
+                  icon-name: "document-edit-symbolic";
+                  action-name: "app.edit_game";
+                  tooltip-text: _("Edit");
 
                   styles [
+                    "raised",
                     "circular",
                   ]
                 }
+
+                Button details_view_hide_button {
+                  action-name: "app.hide_game";
+
+                  styles [
+                    "raised",
+                    "circular",
+                  ]
                 }
+
+                Button {
+                  icon-name: "user-trash-symbolic";
+                  action-name: "app.remove_game";
+                  tooltip-text: _("Remove");
+
+                  styles [
+                    "raised",
+                    "circular",
+                  ]
                 }
-            }
+
-          }
+                MenuButton {
+                  icon-name: "system-search-symbolic";
+                  menu-model: search;
+                  tooltip-text: _("Search");
+
+                  styles [
+                    "raised",
+                    "circular",
+                  ]
                 }
 
                 styles [
-          "background",
+                  "toolbar",
                 ]
+              }
+            }
+          }
+        }
+      }
+    }
 
-        Picture overview_blurred_cover {
+    Picture details_view_blurred_cover {
-          opacity: 0.2;
-          can-shrink: true;
       keep-aspect-ratio: false;
-          hexpand: true;
-          vexpand: true;
-        }
-      }
-
-      Box library_view {
-        orientation: vertical;
-
-        Adw.HeaderBar header_bar {
-          [start]
-          MenuButton {
-            icon-name: "list-add-symbolic";
-            menu-model: add_games;
-          }
-
-          [end]
-          MenuButton primary_menu_button {
-            icon-name: "open-menu-symbolic";
-            menu-model: primary_menu;
-          }
-
-          [end]
-          ToggleButton search_button {
-            icon-name: "system-search-symbolic";
-            action-name: "win.toggle_search";
-          }
-        }
-
-        SearchBar search_bar {
-          Adw.Clamp {
-            maximum-size: 500;
-            tightening-threshold: 500;
-
-            SearchEntry search_entry {
-              hexpand: true;
-            }
-          }
-        }
-
-        Adw.Bin library_bin {
-          ScrolledWindow scrolledwindow {
-            hexpand: true;
-            vexpand: true;
-
-            FlowBox library {
-              homogeneous: true;
-              halign: center;
-              valign: start;
-              column-spacing: 12;
-              row-spacing: 12;
-              margin-top: 16;
-              margin-bottom: 16;
-              margin-start: 16;
-              margin-end: 16;
-              selection-mode: none;
-            }
-          }
-        }
-      }
-
-      Box hidden_library_view {
-        orientation: vertical;
-
-        Adw.HeaderBar hidden_header_bar {
-          [start]
-          Button hidden_back_button {
-            action-name: "win.go_back";
-            icon-name: "go-previous-symbolic";
-          }
-
-          [title]
-          Adw.WindowTitle {
-            title: _("Hidden Games");
-          }
-
-          [end]
-          MenuButton {
-            icon-name: "open-menu-symbolic";
-            menu-model: primary_menu;
-          }
-
-          [end]
-          ToggleButton hidden_search_button {
-            icon-name: "system-search-symbolic";
-            action-name: "win.toggle_search";
-          }
-        }
-
-        SearchBar hidden_search_bar {
-          Adw.Clamp {
-            maximum-size: 500;
-            tightening-threshold: 500;
-
-            SearchEntry hidden_search_entry {
-              hexpand: true;
-            }
-          }
-        }
-
-        Adw.Bin hidden_library_bin {
-          ScrolledWindow hidden_scrolledwindow {
-            hexpand: true;
-            vexpand: true;
-
-            FlowBox hidden_library {
-              homogeneous: true;
-              halign: center;
-              valign: start;
-              column-spacing: 12;
-              row-spacing: 12;
-              margin-top: 16;
-              margin-bottom: 16;
-              margin-start: 16;
-              margin-end: 16;
-              selection-mode: none;
-            }
-          }
-        }
-
-        styles [
-          "background",
-        ]
-      }
     }
   }
 }
@@ -352,86 +513,30 @@ menu primary_menu {
   }
 
   section {
-    item {
+    item (_("Preferences"), "app.preferences")
-      label: _("Preferences");
+    item (_("Keyboard Shortcuts"), "win.show-help-overlay")
-      action: "app.preferences";
+    item (_("About Cartridges"), "app.about")
-    }
-
-    item {
-      label: _("Keyboard Shortcuts");
-      action: "win.show-help-overlay";
-    }
-
-    item {
-      label: _("About Cartridges");
-      action: "app.about";
-    }
   }
 }
 
 menu add_games {
   section {
-    item {
+    item (_("Add Game"), "app.add_game")
-      label: _("Add Game");
-      action: "app.add_game";
-    }
   }
+
   section {
-    submenu {
+    item (_("Import"), "app.import")
-      label: _("Import from");
-      item {
-        label: _("Steam");
-        action: "app.steam_import";
-      }
-
-      item {
-        label: _("Heroic");
-        action: "app.heroic_import";
-      }
-
-      item {
-        label: _("Bottles");
-        action: "app.bottles_import";
-        hidden-when: "action-disabled";
-      }
-    }
   }
 }
 
-menu game_options {
+menu search {
   section {
-    item {
+    label: "Search on…";
-      label: _("Edit");
-      action: "app.edit_details";
-    }
 
-    item {
+    item (_("IGDB"), "app.igdb_search")
-      label: _("Hide");
+    item (_("SteamGridDB"), "app.sgdb_search")
-      action: "app.hide_game";
+    item (_("ProtonDB"), "app.protondb_search")
-    }
+    item (_("Lutris"), "app.lutris_search")
-
+    item (_("HowLongToBeat"), "app.hltb_search")
-    item {
-      label: _("Remove");
-      action: "app.remove_game";
-    }
-  }
-}
-
-menu hidden_game_options {
-  section {
-    item {
-      label: _("Edit");
-      action: "app.edit_details";
-    }
-
-    item {
-      label: _("Unhide");
-      action: "app.hide_game";
-    }
-
-    item {
-      label: _("Remove");
-      action: "app.remove_game";
-    }
   }
 }

data/hu.kramo.Cartridges.desktop.in

@@ -1,10 +1,11 @@
 [Desktop Entry]
 Name=Cartridges
 GenericName=Game Launcher
-Comment=Launch your games
+Comment=Launch all your games
 Exec=cartridges
-Icon=hu.kramo.Cartridges
+Icon=@APP_ID@
 Terminal=false
 Type=Application
 Categories=GNOME;GTK;Game;
+Keywords=gaming;launcher;steam;lutris;heroic;bottles;itch;flatpak;legendary;retroarch;
 StartupNotify=true

data/hu.kramo.Cartridges.gschema.xml

@@ -1,47 +0,0 @@
-<?xml version="1.0" encoding="UTF-8"?>
-<schemalist gettext-domain="cartridges">
-	<schema id="hu.kramo.Cartridges" path="/hu/kramo/Cartridges/">
-	  <key name="exit-after-launch" type="b">
-	    <default>false</default>
-	  </key>
-	  <key name="heroic-import-epic" type="b">
-	    <default>true</default>
-	  </key>
-	  <key name="heroic-import-gog" type="b">
-	    <default>true</default>
-	  </key>
-	  <key name="heroic-import-sideload" type="b">
-	    <default>true</default>
-	  </key>
-	  <key name="steam-location" type="s">
-      <default>"~/.steam/"</default>
-    </key>
-	  <key name="heroic-location" type="s">
-      <default>"~/.var/app/com.heroicgameslauncher.hgl/config/heroic/"</default>
-    </key>
-	  <key name="bottles-location" type="s">
-      <default>"~/.var/app/com.usebottles.bottles/data/bottles/"</default>
-    </key>
-	</schema>
-  <schema id="hu.kramo.Cartridge.State" path="/hu/kramo/Cartridges/State/">
-    <key name="width" type="i">
-      <default>1110</default>
-    </key>
-    <key name="height" type="i">
-      <default>820</default>
-    </key>
-    <key name="is-maximized" type="b">
-      <default>false</default>
-    </key>
-    <key name="sort-mode" type="s">
-      <choices>
-        <choice value="a-z"/>
-        <choice value="z-a"/>
-        <choice value="newest"/>
-        <choice value="oldest"/>
-        <choice value="last_played"/>
-      </choices>
-      <default>"a-z"</default>
-    </key>
-  </schema>
-</schemalist>

data/hu.kramo.Cartridges.gschema.xml.in

@@ -0,0 +1,139 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<schemalist gettext-domain="cartridges">
+
+  <schema id="@APP_ID@" path="@PREFIX@/">
+    <key name="exit-after-launch" type="b">
+      <default>false</default>
+    </key>
+    <key name="cover-launches-game" type="b">
+      <default>false</default>
+    </key>
+    <key name="high-quality-images" type="b">
+      <default>false</default>
+    </key>
+    <key name="remove-missing" type="b">
+      <default>true</default>
+    </key>
+    <key name="steam" type="b">
+      <default>true</default>
+    </key>
+    <key name="steam-location" type="s">
+      <default>"~/.steam/steam"</default>
+    </key>
+    <key name="lutris" type="b">
+      <default>true</default>
+    </key>
+    <key name="lutris-location" type="s">
+      <default>"~/.var/app/net.lutris.Lutris/data/lutris/"</default>
+    </key>
+    <key name="lutris-cache-location" type="s">
+      <default>"~/.var/app/net.lutris.Lutris/cache/lutris"</default>
+    </key>
+    <key name="lutris-import-steam" type="b">
+      <default>false</default>
+    </key>
+    <key name="lutris-import-flatpak" type="b">
+      <default>false</default>
+    </key>
+    <key name="heroic" type="b">
+      <default>true</default>
+    </key>
+    <key name="heroic-location" type="s">
+      <default>"~/.config/heroic/"</default>
+    </key>
+    <key name="heroic-import-epic" type="b">
+      <default>true</default>
+    </key>
+    <key name="heroic-import-gog" type="b">
+      <default>true</default>
+    </key>
+    <key name="heroic-import-amazon" type="b">
+      <default>true</default>
+    </key>
+    <key name="heroic-import-sideload" type="b">
+      <default>true</default>
+    </key>
+    <key name="bottles" type="b">
+      <default>true</default>
+    </key>
+    <key name="bottles-location" type="s">
+      <default>"~/.var/app/com.usebottles.bottles/data/bottles/"</default>
+    </key>
+    <key name="itch" type="b">
+      <default>true</default>
+    </key>
+    <key name="itch-location" type="s">
+      <default>"~/.var/app/io.itch.itch/config/itch/"</default>
+    </key>
+    <key name="legendary" type="b">
+      <default>true</default>
+    </key>
+    <key name="legendary-location" type="s">
+      <default>"~/.config/legendary/"</default>
+    </key>
+    <key name="retroarch" type="b">
+      <default>true</default>
+    </key>
+    <key name="retroarch-location" type="s">
+      <default>"~/.var/app/org.libretro.RetroArch/config/retroarch/"</default>
+    </key>
+    <key name="desktop" type="b">
+      <default>true</default>
+    </key>
+    <key name="flatpak" type="b">
+      <default>true</default>
+    </key>
+    <key name="flatpak-system-location" type="s">
+      <default>"/var/lib/flatpak/"</default>
+    </key>
+    <key name="flatpak-user-location" type="s">
+      <default>"~/.local/share/flatpak/"</default>
+    </key>
+    <key name="flatpak-import-launchers" type="b">
+      <default>false</default>
+    </key>
+    <key name="sgdb-key" type="s">
+      <default>""</default>
+    </key>
+    <key name="sgdb" type="b">
+      <default>false</default>
+    </key>
+    <key name="sgdb-prefer" type="b">
+      <default>false</default>
+    </key>
+    <key name="sgdb-animated" type="b">
+      <default>false</default>
+    </key>
+    <key name="library-rows" type="u">
+      <default>0</default>
+    </key>
+  </schema>
+
+  <schema id="@APP_ID@.State" path="@PREFIX@/State/">
+    <key name="width" type="i">
+      <default>1170</default>
+    </key>
+    <key name="height" type="i">
+      <default>795</default>
+    </key>
+    <key name="is-maximized" type="b">
+      <default>false</default>
+    </key>
+    <key name="sort-mode" type="s">
+      <choices>
+        <choice value="a-z" />
+        <choice value="z-a" />
+        <choice value="newest" />
+        <choice value="oldest" />
+        <choice value="last_played" />
+      </choices>
+      <default>"last_played"</default>
+    </key>
+    <key name="show-sidebar" type="b">
+      <default>false</default>
+    </key>
+    <key name="steam-limiter-tokens-history" type="s">
+      <default>"[]"</default>
+    </key>
+  </schema>
+</schemalist>

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

@@ -1,13 +1,193 @@
 <?xml version="1.0" encoding="UTF-8"?>
 <component type="desktop-application">
-  <id>hu.kramo.Cartridges.desktop</id>
+  <id>@APP_ID@</id>
 	<metadata_license>CC0-1.0</metadata_license>
 	<project_license>GPL-3.0-or-later</project_license>
   <name>Cartridges</name>
   <summary>Launch all your games</summary>
 	<description>
-	  <p>Cartridges is a simple game launcher. It has support for importing your games from Steam, Heroic and Bottles with organizational features such as hiding and sorting by date added or last played.</p>
+	  <p>Cartridges is a simple game launcher for all of your games. It has support for importing games from Steam, Lutris, Heroic and more with no login necessary. You can sort and hide games or download cover art from SteamGridDB.</p>
 	</description>
-  <launchable type="desktop-id">hu.kramo.Cartridges.desktop</launchable>
+  <url type="homepage">https://github.com/kra-mo/cartridges</url>
+  <url type="bugtracker">https://github.com/kra-mo/cartridges/issues</url>
+  <url type="translate">https://hosted.weblate.org/engage/cartridges/</url>
+  <url type="contact">https://www.kramo.page/about/</url>
+  <url type="vcs-browser">https://github.com/kra-mo/cartridges</url>
+  <url type="contribute">https://github.com/kra-mo/cartridges/blob/main/CONTRIBUTING.md</url>
+  <!-- developer_name tag deprecated with Appstream 1.0 -->
   <developer_name translatable="no">kramo</developer_name>
+  <developer id="kramo.page">
+      <name translatable="no">kramo</name>
+  </developer>
+  <launchable type="desktop-id">@APP_ID@.desktop</launchable>
+  <translation type="gettext">cartridges</translation>
+  <supports>
+    <control>pointing</control>
+    <control>keyboard</control>
+    <control>touch</control>
+  </supports>
+  <recommends>
+    <display_length compare="gt">280</display_length>
+  </recommends>
+  <screenshots>
+    <screenshot type="default">
+      <image>https://raw.githubusercontent.com/kra-mo/cartridges/main/data/screenshots/1.png</image>
+      <caption>Cartridges</caption>
+    </screenshot>
+    <screenshot>
+      <image>https://raw.githubusercontent.com/kra-mo/cartridges/main/data/screenshots/2.png</image>
+      <caption>Game Details</caption>
+    </screenshot>
+    <screenshot>
+      <image>https://raw.githubusercontent.com/kra-mo/cartridges/main/data/screenshots/3.png</image>
+      <caption>Edit Game Details</caption>
+    </screenshot>
+    <screenshot>
+      <image>https://raw.githubusercontent.com/kra-mo/cartridges/main/data/screenshots/4.png</image>
+      <caption>Preferences</caption>
+    </screenshot>
+  </screenshots>
+  <content_rating type="oars-1.1" />
+  <releases>
+    <release version="2.7.3" date="2024-02-17">
+      <description translatable="no">
+        <ul>
+          <li>Updated Lutris locations so importing works again</li>
+          <li>Other miscellaneous bug fixes</li>
+        </ul>
+      </description>
+    </release>
+    <release version="2.7" date="2023-12-12">
+      <description translatable="no">
+        <ul>
+          <li>Flatpaks installed for the user and system-wide ones can now be imported separately</li>
+        </ul>
+      </description>
+    </release>
+    <release version="2.6" date="2023-10-11">
+      <description translatable="no">
+        <p>You can now search your Cartridges library from GNOME!</p>
+        <p>To enable the functionality, go to "Search" in the Settings app and toggle "Cartridges" on.</p>
+      </description>
+    </release>
+    <release version="2.5" date="2023-10-06">
+      <description translatable="no">
+        <ul>
+          <li>Added the ability to refetch covers from SteamGridDB</li>
+          <li>Fixed an issue with fractional scaling</li>
+          <li>Translations since 2.4</li>
+        </ul>
+        <p>The project now accepts donations. Thank you so much if you decide to donate! 💜</p>
+      </description>
+    </release>
+    <release version="2.4" date="2023-09-21">
+      <description translatable="no">
+        <ul>
+          <li>Cartridges now adapts to smaller screen sizes</li>
+          <li>You can now filter games by import source</li>
+          <li>Ported to Libadwaita 1.4</li>
+          <li>Translations since 2.3</li>
+        </ul>
+      </description>
+    </release>
+    <release version="2.3" date="2023-08-29">
+      <description translatable="no">
+        <ul>
+          <li>New import source: desktop entries</li>
+          <li>Added the ability to pick executables via the file picker</li>
+          <li>Manually added covers are now padded if they are too short</li>
+          <li>Translations since 2.2</li>
+        </ul>
+      </description>
+    </release>
+    <release version="2.2" date="2023-08-17">
+      <description translatable="no">
+        <ul>
+          <li>New import source: RetroArch</li>
+          <li>Added the option to automatically remove uninstalled games on import</li>
+          <li>Added the ability to undo an import</li>
+          <li>Various UX improvements</li>
+          <li>Translations since 2.1</li>
+        </ul>
+      </description>
+    </release>
+    <release version="2.1" date="2023-07-25">
+      <description translatable="no">
+        <ul>
+          <li>Added support for Amazon Games in the Heroic importer</li>
+          <li>Translations since 2.0</li>
+        </ul>
+      </description>
+    </release>
+    <release version="2.0" date="2023-07-05">
+      <description translatable="no">
+        <p>After months of work, Cartridges 2.0 is here:</p>
+        <ul>
+          <li>New import source: Legendary</li>
+          <li>New import source: Flatpak</li>
+          <li>Importing games should be much quicker</li>
+          <li>Error handling has been improved</li>
+          <li>Various UX improvements</li>
+          <li>Translations since 1.5</li>
+        </ul>
+        <p>Thanks to the new import backend, adding new sources is much easier and a lot more are coming soon!</p>
+      </description>
+    </release>
+    <release version="1.5" date="2023-05-23">
+      <description translatable="no">
+        <ul>
+          <li>Cartridges is now part of GNOME Circle!</li>
+          <li>Extra Steam libraries are now detected automatically</li>
+          <li>Executables are now passed directly to the shell</li>
+          <li>Various UX improvements</li>
+          <li>Translations since 1.4</li>
+        </ul>
+      </description>
+    </release>
+    <release version="1.4" date="2023-04-16">
+      <description translatable="no">
+        <ul>
+          <li>Support for animated covers</li>
+          <li>Redesigned details view</li>
+          <li>Easily search for games on various databases</li>
+          <li>Translations since 1.3</li>
+        </ul>
+      </description>
+    </release>
+    <release version="1.3" date="2023-04-06">
+      <description translatable="no">
+        <ul>
+          <li>Support for importing game covers from SteamGridDB!</li>
+          <li>New import source: Lutris</li>
+          <li>New import source: itch</li>
+          <li>Better feedback for hiding and launching games</li>
+          <li>UX improvements</li>
+          <li>Translations since 1.2</li>
+        </ul>
+      </description>
+    </release>
+    <release version="1.2" date="2023-03-30">
+      <description translatable="no">
+        <ul>
+          <li>Refined the user experience for importing games</li>
+          <li>Added option to remove all games</li>
+          <li>Translations since 1.1</li>
+        </ul>
+      </description>
+    </release>
+    <release version="1.1" date="2023-03-26">
+      <description translatable="no">
+        <ul>
+          <li>Added option to launch games by clicking the cover image</li>
+          <li>Added option to save cover art losslessly</li>
+          <li>Translations since 1.0</li>
+        </ul>
+      </description>
+    </release>
+    <release version="1.0" date="2023-03-25">
+      <description translatable="no">
+        <p>First stable release</p>
+      </description>
+    </release>
+  </releases>
 </component>

data/icons/hicolor/scalable/apps/hu.kramo.Cartridges.Devel.svg

@@ -0,0 +1,85 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<svg height="128px" viewBox="0 0 128 128" width="128px" xmlns="http://www.w3.org/2000/svg" xmlns:xlink="http://www.w3.org/1999/xlink">
+    <linearGradient id="a" gradientUnits="userSpaceOnUse" x1="9" x2="119" y1="115" y2="115">
+        <stop offset="0" stop-color="#613583"/>
+        <stop offset="0.05" stop-color="#9141ac"/>
+        <stop offset="0.22" stop-color="#613583"/>
+        <stop offset="0.78" stop-color="#613583"/>
+        <stop offset="0.95" stop-color="#9141ac"/>
+        <stop offset="1" stop-color="#613583"/>
+    </linearGradient>
+    <linearGradient id="b" gradientUnits="userSpaceOnUse" x1="45" x2="45" y1="50" y2="82">
+        <stop offset="0" stop-color="#bdd0d5"/>
+        <stop offset="1" stop-color="#305749"/>
+    </linearGradient>
+    <clipPath id="c">
+        <rect height="128" width="128"/>
+    </clipPath>
+    <clipPath id="d">
+        <rect height="128" width="128"/>
+    </clipPath>
+    <filter id="e" height="100%" width="100%" x="0%" y="0%">
+        <feColorMatrix in="SourceGraphic" type="matrix" values="0 0 0 0 1 0 0 0 0 1 0 0 0 0 1 0 0 0 1 0"/>
+    </filter>
+    <mask id="f">
+        <g clip-path="url(#d)" filter="url(#e)">
+            <g clip-path="url(#c)">
+                <path d="m 111 29 h -94 c -4.417969 0 -8 3.582031 -8 8 v 70 c 0 4.417969 3.582031 8 8 8 h 94 c 4.417969 0 8 -3.582031 8 -8 v -70 c 0 -4.417969 -3.582031 -8 -8 -8 z m 0 0" fill="url(#a)"/>
+                <path d="m 111 29 h -94 c -4.417969 0 -8 3.679688 -8 8.222656 v 57.554688 c 0 4.539062 3.582031 8.222656 8 8.222656 h 94 c 4.417969 0 8 -3.679688 8 -8.222656 v -57.554688 c 0 -4.539062 -3.582031 -8.222656 -8 -8.222656 z m 0 0" fill="#c061cb"/>
+                <path d="m 84 42 h -40 c -2.210938 0 -4 1.789062 -4 4 v 40 c 0 2.210938 1.789062 4 4 4 h 40 c 2.210938 0 4 -1.789062 4 -4 v -40 c 0 -2.210938 -1.789062 -4 -4 -4 z m 0 0"/>
+                <path d="m 81 50 h -34 c -1.105469 0 -2 0.894531 -2 2 v 28 c 0 1.105469 0.894531 2 2 2 h 34 c 1.105469 0 2 -0.894531 2 -2 v -28 c 0 -1.105469 -0.894531 -2 -2 -2 z m 0 0" fill="url(#b)"/>
+                <path d="m 102 61 v -1 c 0 -2.761719 -2.238281 -5 -5 -5 s -5 2.238281 -5 5 v 1 c 0 2.761719 2.238281 5 5 5 s 5 -2.238281 5 -5 z m 12 -6 v -1 c 0 -2.761719 -2.238281 -5 -5 -5 s -5 2.238281 -5 5 v 1 c 0 2.761719 2.238281 5 5 5 s 5 -2.238281 5 -5 z m 0 0"/>
+                <path d="m 97 64 c 2.761719 0 5 -2.015625 5 -4.5 s -2.238281 -4.5 -5 -4.5 s -5 2.015625 -5 4.5 s 2.238281 4.5 5 4.5 z m 12 -6 c 2.761719 0 5 -2.015625 5 -4.5 s -2.238281 -4.5 -5 -4.5 s -5 2.015625 -5 4.5 s 2.238281 4.5 5 4.5 z m 0 0" fill="#3d3846"/>
+                <path d="m 29 56.5 c 0 -1.933594 -1.566406 -3.5 -3.5 -3.5 s -3.5 1.566406 -3.5 3.5 v 13 c 0 1.933594 1.566406 3.5 3.5 3.5 s 3.5 -1.566406 3.5 -3.5 z m 0 0"/>
+                <path d="m 33 58 h -15 c -1.65625 0 -3 1.34375 -3 3 v 2 c 0 1.65625 1.34375 3 3 3 h 15 c 1.65625 0 3 -1.34375 3 -3 v -2 c 0 -1.65625 -1.34375 -3 -3 -3 z m 0 0"/>
+                <path d="m 29 54.5 c 0 -1.933594 -1.566406 -3.5 -3.5 -3.5 s -3.5 1.566406 -3.5 3.5 v 13 c 0 1.933594 1.566406 3.5 3.5 3.5 s 3.5 -1.566406 3.5 -3.5 z m 0 0" fill="#3d3846"/>
+                <path d="m 33 58 h -15 c -1.65625 0 -3 1.34375 -3 3 s 1.34375 3 3 3 h 15 c 1.65625 0 3 -1.34375 3 -3 s -1.34375 -3 -3 -3 z m 0 0" fill="#3d3846"/>
+                <path d="m 71 109 c 0 -1.105469 0.894531 -2 2 -2 s 2 0.894531 2 2 s -0.894531 2 -2 2 s -2 -0.894531 -2 -2 z m 0 0"/>
+                <path d="m 71.0625 108.5 c 0.226562 0.882812 1.023438 1.503906 1.9375 1.503906 s 1.710938 -0.621094 1.9375 -1.503906 c 0.195312 0.757812 -0.066406 1.558594 -0.671875 2.050781 c -0.605469 0.492188 -1.445313 0.585938 -2.144531 0.242188 c -0.855469 -0.414063 -1.296875 -1.375 -1.058594 -2.292969 z m 0 0" fill="#9141ac"/>
+                <path d="m 66 107 h -10 c -1.105469 0 -2 0.894531 -2 2 s 0.894531 2 2 2 h 10 c 1.105469 0 2 -0.894531 2 -2 s -0.894531 -2 -2 -2 z m 0 0"/>
+                <path d="m 54.0625 108.5 c -0.152344 0.597656 -0.023438 1.234375 0.355469 1.726562 c 0.378906 0.488282 0.964843 0.773438 1.582031 0.773438 h 10 c 0.617188 0 1.203125 -0.285156 1.582031 -0.773438 c 0.378907 -0.492187 0.511719 -1.128906 0.355469 -1.726562 c -0.226562 0.882812 -1.023438 1.5 -1.9375 1.5 h -10 c -0.914062 0 -1.710938 -0.617188 -1.9375 -1.5 z m 0 0" fill="#9141ac"/>
+                <path d="m 110 74 h -14 c -0.550781 0 -1 0.449219 -1 1 s 0.449219 1 1 1 h 14 c 0.550781 0 1 -0.449219 1 -1 s -0.449219 -1 -1 -1 z m 0 5 h -14 c -0.550781 0 -1 0.449219 -1 1 s 0.449219 1 1 1 h 14 c 0.550781 0 1 -0.449219 1 -1 s -0.449219 -1 -1 -1 z m 0 5 h -14 c -0.550781 0 -1 0.449219 -1 1 s 0.449219 1 1 1 h 14 c 0.550781 0 1 -0.449219 1 -1 s -0.449219 -1 -1 -1 z m 0 0" fill="#613583"/>
+                <path d="m 21.5 79 h -3 c -1.378906 0 -2.5 1.121094 -2.5 2.5 s 1.121094 2.5 2.5 2.5 h 3 c 1.378906 0 2.5 -1.121094 2.5 -2.5 s -1.121094 -2.5 -2.5 -2.5 z m 11 0 h -3 c -1.378906 0 -2.5 1.121094 -2.5 2.5 s 1.121094 2.5 2.5 2.5 h 3 c 1.378906 0 2.5 -1.121094 2.5 -2.5 s -1.121094 -2.5 -2.5 -2.5 z m 0 0"/>
+                <path d="m 22 79 h -4 c -1.105469 0 -2 0.894531 -2 2 s 0.894531 2 2 2 h 4 c 1.105469 0 2 -0.894531 2 -2 s -0.894531 -2 -2 -2 z m 11 0 h -4 c -1.105469 0 -2 0.894531 -2 2 s 0.894531 2 2 2 h 4 c 1.105469 0 2 -0.894531 2 -2 s -0.894531 -2 -2 -2 z m 0 0" fill="#3d3846"/>
+            </g>
+        </g>
+    </mask>
+    <mask id="g">
+        <g filter="url(#e)">
+            <rect fill-opacity="0.8" height="128" width="128"/>
+        </g>
+    </mask>
+    <linearGradient id="h" gradientTransform="matrix(0 0.37 -0.98462 0 295.38501 -30.360001)" gradientUnits="userSpaceOnUse" x1="300" x2="428" y1="235" y2="235">
+        <stop offset="0" stop-color="#f9f06b"/>
+        <stop offset="1" stop-color="#f5c211"/>
+    </linearGradient>
+    <clipPath id="i">
+        <rect height="128" width="128"/>
+    </clipPath>
+    <clipPath id="j">
+        <rect height="128" width="128"/>
+    </clipPath>
+    <path d="m 111 29 h -94 c -4.417969 0 -8 3.582031 -8 8 v 70 c 0 4.417969 3.582031 8 8 8 h 94 c 4.417969 0 8 -3.582031 8 -8 v -70 c 0 -4.417969 -3.582031 -8 -8 -8 z m 0 0" fill="url(#a)"/>
+    <path d="m 111 29 h -94 c -4.417969 0 -8 3.679688 -8 8.222656 v 57.554688 c 0 4.539062 3.582031 8.222656 8 8.222656 h 94 c 4.417969 0 8 -3.679688 8 -8.222656 v -57.554688 c 0 -4.539062 -3.582031 -8.222656 -8 -8.222656 z m 0 0" fill="#c061cb"/>
+    <path d="m 84 42 h -40 c -2.210938 0 -4 1.789062 -4 4 v 40 c 0 2.210938 1.789062 4 4 4 h 40 c 2.210938 0 4 -1.789062 4 -4 v -40 c 0 -2.210938 -1.789062 -4 -4 -4 z m 0 0"/>
+    <path d="m 81 50 h -34 c -1.105469 0 -2 0.894531 -2 2 v 28 c 0 1.105469 0.894531 2 2 2 h 34 c 1.105469 0 2 -0.894531 2 -2 v -28 c 0 -1.105469 -0.894531 -2 -2 -2 z m 0 0" fill="url(#b)"/>
+    <path d="m 102 61 v -1 c 0 -2.761719 -2.238281 -5 -5 -5 s -5 2.238281 -5 5 v 1 c 0 2.761719 2.238281 5 5 5 s 5 -2.238281 5 -5 z m 12 -6 v -1 c 0 -2.761719 -2.238281 -5 -5 -5 s -5 2.238281 -5 5 v 1 c 0 2.761719 2.238281 5 5 5 s 5 -2.238281 5 -5 z m 0 0"/>
+    <path d="m 97 64 c 2.761719 0 5 -2.015625 5 -4.5 s -2.238281 -4.5 -5 -4.5 s -5 2.015625 -5 4.5 s 2.238281 4.5 5 4.5 z m 12 -6 c 2.761719 0 5 -2.015625 5 -4.5 s -2.238281 -4.5 -5 -4.5 s -5 2.015625 -5 4.5 s 2.238281 4.5 5 4.5 z m 0 0" fill="#3d3846"/>
+    <path d="m 29 56.5 c 0 -1.933594 -1.566406 -3.5 -3.5 -3.5 s -3.5 1.566406 -3.5 3.5 v 13 c 0 1.933594 1.566406 3.5 3.5 3.5 s 3.5 -1.566406 3.5 -3.5 z m 0 0"/>
+    <path d="m 33 58 h -15 c -1.65625 0 -3 1.34375 -3 3 v 2 c 0 1.65625 1.34375 3 3 3 h 15 c 1.65625 0 3 -1.34375 3 -3 v -2 c 0 -1.65625 -1.34375 -3 -3 -3 z m 0 0"/>
+    <path d="m 29 54.5 c 0 -1.933594 -1.566406 -3.5 -3.5 -3.5 s -3.5 1.566406 -3.5 3.5 v 13 c 0 1.933594 1.566406 3.5 3.5 3.5 s 3.5 -1.566406 3.5 -3.5 z m 0 0" fill="#3d3846"/>
+    <path d="m 33 58 h -15 c -1.65625 0 -3 1.34375 -3 3 s 1.34375 3 3 3 h 15 c 1.65625 0 3 -1.34375 3 -3 s -1.34375 -3 -3 -3 z m 0 0" fill="#3d3846"/>
+    <path d="m 71 109 c 0 -1.105469 0.894531 -2 2 -2 s 2 0.894531 2 2 s -0.894531 2 -2 2 s -2 -0.894531 -2 -2 z m 0 0"/>
+    <path d="m 71.0625 108.5 c 0.226562 0.882812 1.023438 1.503906 1.9375 1.503906 s 1.710938 -0.621094 1.9375 -1.503906 c 0.195312 0.757812 -0.066406 1.558594 -0.671875 2.050781 c -0.605469 0.492188 -1.445313 0.585938 -2.144531 0.242188 c -0.855469 -0.414063 -1.296875 -1.375 -1.058594 -2.292969 z m 0 0" fill="#9141ac"/>
+    <path d="m 66 107 h -10 c -1.105469 0 -2 0.894531 -2 2 s 0.894531 2 2 2 h 10 c 1.105469 0 2 -0.894531 2 -2 s -0.894531 -2 -2 -2 z m 0 0"/>
+    <path d="m 54.0625 108.5 c -0.152344 0.597656 -0.023438 1.234375 0.355469 1.726562 c 0.378906 0.488282 0.964843 0.773438 1.582031 0.773438 h 10 c 0.617188 0 1.203125 -0.285156 1.582031 -0.773438 c 0.378907 -0.492187 0.511719 -1.128906 0.355469 -1.726562 c -0.226562 0.882812 -1.023438 1.5 -1.9375 1.5 h -10 c -0.914062 0 -1.710938 -0.617188 -1.9375 -1.5 z m 0 0" fill="#9141ac"/>
+    <path d="m 110 74 h -14 c -0.550781 0 -1 0.449219 -1 1 s 0.449219 1 1 1 h 14 c 0.550781 0 1 -0.449219 1 -1 s -0.449219 -1 -1 -1 z m 0 5 h -14 c -0.550781 0 -1 0.449219 -1 1 s 0.449219 1 1 1 h 14 c 0.550781 0 1 -0.449219 1 -1 s -0.449219 -1 -1 -1 z m 0 5 h -14 c -0.550781 0 -1 0.449219 -1 1 s 0.449219 1 1 1 h 14 c 0.550781 0 1 -0.449219 1 -1 s -0.449219 -1 -1 -1 z m 0 0" fill="#613583"/>
+    <path d="m 21.5 79 h -3 c -1.378906 0 -2.5 1.121094 -2.5 2.5 s 1.121094 2.5 2.5 2.5 h 3 c 1.378906 0 2.5 -1.121094 2.5 -2.5 s -1.121094 -2.5 -2.5 -2.5 z m 11 0 h -3 c -1.378906 0 -2.5 1.121094 -2.5 2.5 s 1.121094 2.5 2.5 2.5 h 3 c 1.378906 0 2.5 -1.121094 2.5 -2.5 s -1.121094 -2.5 -2.5 -2.5 z m 0 0"/>
+    <path d="m 22 79 h -4 c -1.105469 0 -2 0.894531 -2 2 s 0.894531 2 2 2 h 4 c 1.105469 0 2 -0.894531 2 -2 s -0.894531 -2 -2 -2 z m 11 0 h -4 c -1.105469 0 -2 0.894531 -2 2 s 0.894531 2 2 2 h 4 c 1.105469 0 2 -0.894531 2 -2 s -0.894531 -2 -2 -2 z m 0 0" fill="#3d3846"/>
+    <g clip-path="url(#j)" mask="url(#f)">
+        <g clip-path="url(#i)" mask="url(#g)">
+            <path d="m 128 80.640625 v 47.359375 h -128 v -47.359375 z m 0 0" fill="url(#h)"/>
+            <path d="m 13.308594 80.640625 l 47.355468 47.359375 h 21.214844 l -47.359375 -47.359375 z m 42.421875 0 l 47.363281 47.359375 h 21.214844 l -47.363282 -47.359375 z m 42.429687 0 l 29.839844 29.839844 v -21.210938 l -8.628906 -8.628906 z m -98.160156 7.90625 v 21.214844 l 18.238281 18.238281 h 21.214844 z m 0 0"/>
+        </g>
+    </g>
+</svg>

data/icons/hicolor/symbolic/apps/hu.kramo.Cartridges.Devel-symbolic.svg

@@ -0,0 +1,3 @@
+<svg width="16" height="16" viewBox="0 0 16 16" fill="none" xmlns="http://www.w3.org/2000/svg">
+<path fill-rule="evenodd" clip-rule="evenodd" d="M3 3C1.89543 3 1 3.89543 1 5V11C1 12.1046 1.89543 13 3 13H13C14.1046 13 15 12.1046 15 11V5C15 3.89543 14.1046 3 13 3H3ZM6 5C5.44772 5 5 5.44772 5 6V10C5 10.5523 5.44772 11 6 11H10C10.5523 11 11 10.5523 11 10V6C11 5.44772 10.5523 5 10 5H6ZM12 8C12 7.44772 12.4477 7 13 7C13.5523 7 14 7.44772 14 8C14 8.55228 13.5523 9 13 9C12.4477 9 12 8.55228 12 8ZM3 7C2.44772 7 2 7.44772 2 8C2 8.55228 2.44772 9 3 9C3.55228 9 4 8.55228 4 8C4 7.44772 3.55228 7 3 7Z" fill="black"/>
+</svg>

data/icons/meson.build

@@ -1,13 +1,11 @@
-application_id = 'hu.kramo.Cartridges'
-
 scalable_dir = join_paths('hicolor', 'scalable', 'apps')
 install_data(
-  join_paths(scalable_dir, ('@0@.svg').format(application_id)),
+  join_paths(scalable_dir, ('@0@.svg').format(app_id)),
   install_dir: join_paths(get_option('datadir'), 'icons', scalable_dir)
 )
 
 symbolic_dir = join_paths('hicolor', 'symbolic', 'apps')
 install_data(
-  join_paths(symbolic_dir, ('@0@-symbolic.svg').format(application_id)),
+  join_paths(symbolic_dir, ('@0@-symbolic.svg').format(app_id)),
   install_dir: join_paths(get_option('datadir'), 'icons', symbolic_dir)
 )

data/icons/sources/bottles-source-symbolic.svg

@@ -0,0 +1 @@
+<svg width="16" height="16" fill="none" xmlns="http://www.w3.org/2000/svg"><path d="M2.847 0v.616c0 .371-.17.786-.405 1.239C1.812 2.95 1.163 4.02 1.01 5.288L1 16h2l.01-10.712c.153-1.267.802-2.337 1.432-3.433.235-.453.405-.868.405-1.24V0h-2Zm4 0v.616c0 .371-.17.786-.404 1.239C5.812 2.95 5.163 4.02 5.01 5.288L5 16h2.001l.01-10.712c.153-1.267.801-2.337 1.432-3.433.235-.453.405-.868.405-1.24V0h-2Zm4.001 0v.616c-.315 1.678-1.632 3.165-1.837 4.672L9.001 16h5.693l-.008-10.7c-.32-1.815-1.385-3.08-1.838-4.684V0h-2Z" fill="#000"/></svg>

data/icons/sources/flatpak-source-symbolic.svg

@@ -0,0 +1 @@
+<svg width="16" height="16" fill="none" xmlns="http://www.w3.org/2000/svg"><path d="M7.805.02a.971.971 0 0 0-.36.148l-6 4A.998.998 0 0 0 1 5v6a1 1 0 0 0 .445.833l6 4c.337.223.774.223 1.11 0l6-4a.998.998 0 0 0 .446-.832V5a.998.998 0 0 0-.445-.832l-6-4a.994.994 0 0 0-.75-.149Zm.196 2.179V9l5-3.332v4.797l-5 3.337V9L3 5.668v-.133L8 2.2Z" fill="#000"/></svg>

data/icons/sources/heroic-source-symbolic.svg

@@ -0,0 +1 @@
+<svg width="16" height="16" fill="none" xmlns="http://www.w3.org/2000/svg"><path fill-rule="evenodd" clip-rule="evenodd" d="m7.872 16-3.817-3.083L2 2.79 7.872 0l5.871 2.789-2.055 10.128L7.872 16Zm0-4.257-.294-.293-.88-7.927 1.1-1.908 1.174 1.908-.807 7.927-.293.293Zm-.294.367-.147.367-1.761.294-.294-.66.294-.662 1.761.294.147.367Zm-.073.734-.22 1.541.587.294.587-.294-.22-1.541-.367-.22-.367.22Zm.807-.367-.147-.367.147-.367 1.761-.293.294.66-.294.66-1.761-.293Z" fill="#000"/></svg>

data/icons/sources/itch-source-symbolic.svg

@@ -0,0 +1 @@
+<svg width="16" height="16" fill="none" xmlns="http://www.w3.org/2000/svg"><path d="M1.965 1.992C1.43 2.08 1 2.58 1 3.115V15.18c0 .534.43.894.965.806l12.066-1.979c.534-.088.964-.588.964-1.122V.82c0-.535-.43-.894-.964-.807L1.964 1.992Zm3.41 3.33c.555-.091.95.204 1.09.722l3.068-.503c.14-.564.532-.988 1.087-1.08.882-.144 1.851.602 2.154 1.659l.723 2.523c.302 1.056-.172 2.04-1.054 2.184-.774.127-1.615-.432-2.014-1.286l-4.863.798c-.399.984-1.24 1.82-2.014 1.946-.882.145-1.356-.683-1.054-1.838l.723-2.76c.303-1.157 1.272-2.22 2.154-2.365ZM7.282 6.58v.986l-.791.13L7.997 9.36 9.505 7.2l-.743.122v-.985l-1.48.243Z" fill="#000"/></svg>

data/icons/sources/legendary-source-symbolic.svg

@@ -0,0 +1 @@
+<svg width="16" height="16" fill="none" xmlns="http://www.w3.org/2000/svg"><g clip-path="url(#a)"><path fill-rule="evenodd" clip-rule="evenodd" d="M0 6.355V1a1 1 0 0 1 1-1h2.893a1 1 0 0 1 .708.293l.645.645a1 1 0 0 0 .707.293h4.094a1 1 0 0 0 .707-.293L11.4.293A1 1 0 0 1 12.107 0H15a1 1 0 0 1 1 1v5.355a1 1 0 0 1-.293.707l-.23.23a1 1 0 0 0 0 1.415l.23.23a1 1 0 0 1 .293.708V15a1 1 0 0 1-1 1h-2.893a1 1 0 0 1-.708-.293l-.645-.645a1 1 0 0 0-.707-.293H5.953a1 1 0 0 0-.707.293l-.645.645a1 1 0 0 1-.708.293H1a1 1 0 0 1-1-1V9.645a1 1 0 0 1 .293-.707l.23-.23a1 1 0 0 0 0-1.415l-.23-.23A1 1 0 0 1 0 6.354ZM8 5a1 1 0 0 0-2 0v5.5a1 1 0 0 0 1 1h3a1 1 0 1 0 0-2H8V5Z" fill="#000"/></g><defs><clipPath id="a"><path fill="#fff" d="M0 0h16v16H0z"/></clipPath></defs></svg>

data/icons/sources/lutris-source-symbolic.svg

@@ -0,0 +1 @@
+<svg width="16" height="16" fill="none" xmlns="http://www.w3.org/2000/svg"><g clip-path="url(#a)"><path fill-rule="evenodd" clip-rule="evenodd" d="M0 7.937C0 3.554 3.518 0 7.857 0c1.196 0 2.33.27 3.344.753.055-.118.181-.363.301-.371.158-.012.248.09.35.203l.001.002c.102.115.306.287.306.287s.929-.32 1.97.251c1.043.572 1.19.744 1.394 1.144.144.284.14.87.126 1.19a.248.248 0 0 0-.039-.004c-.17 0-.308.174-.308.387 0 .214.138.387.308.387a.256.256 0 0 0 .133-.039c.153.292.233.562.255.806-.05-.348-.544-.586-.544-.586s-.077.135-.243.215c-.025.012-.056.01-.091.006-.063-.007-.138-.014-.21.06-.239.484.345.888.617.877.265-.011.476-.276.475-.512.047.92-.74 1.461-1.495 1.374-.493-.058-.907-.249-1.383-.469a10.262 10.262 0 0 0-1.187-.483c-.951-.307-1.569-.47-2.322-.585-1.486-.227-2.557.12-3.061.424a5.84 5.84 0 0 0-.427.284c.772.15 1.236 1.329 1.25 1.65l.002.013v.007l.001.033c-.021.484-.247.845-.725.83a.823.823 0 0 1-.713-.426c-.014-.024-.028-.049-.044-.072a1.92 1.92 0 0 0-.965-.795c-.46.705-.715 1.548-.715 2.53 0 2.897 2.345 5.052 5.213 5.052.907 0 2.817-.309 4-1.28.226-.207.485-.438.725-.55-.862 2.161-3.479 3.488-6.299 3.403C3.534 15.996 0 12.321 0 7.937ZM13.415 4.02a.596.596 0 0 0 .593-.6.596.596 0 0 0-.593-.599.597.597 0 0 0-.594.6c0 .33.266.6.594.6Z" fill="#000"/></g><defs><clipPath id="a"><path fill="#fff" d="M0 0h16v16H0z"/></clipPath></defs></svg>

data/icons/sources/retroarch-source-symbolic.svg

@@ -0,0 +1 @@
+<svg width="16" height="16" fill="none" xmlns="http://www.w3.org/2000/svg"><path d="M4.56 4 5.6 5.28H3.52L3.04 7.2H1.76l.48-1.92H.96L0 9.12h2.56l-.32 1.28h2.24L2.8 12.32h1.88l1.56-1.92h3.52l1.56 1.92h1.88l-1.68-1.92h2.24l-.32-1.28H16l-.96-3.84h-1.28l.48 1.92h-1.28l-.48-1.92H10.4L11.44 4h-1.36L8.96 5.28H7.04L5.92 4H4.56Zm.16 2.56H6v1.28H4.72V6.56Zm5.283 0h1.28v1.28h-1.28V6.56Z" fill="#000"/></svg>

data/icons/sources/steam-source-symbolic.svg

@@ -0,0 +1 @@
+<svg width="16" height="16" fill="none" xmlns="http://www.w3.org/2000/svg"><g clip-path="url(#a)"><path fill-rule="evenodd" clip-rule="evenodd" d="M9.352 5.1a1.509 1.509 0 1 0 2.51 1.675A1.509 1.509 0 0 0 9.352 5.1Zm2.923-.277a2.009 2.009 0 1 1-3.34 2.231 2.009 2.009 0 0 1 3.34-2.23ZM5.01 12.131l-.983-.407a1.7 1.7 0 0 0 3.108-.103 1.696 1.696 0 0 0-1.213-2.29 1.699 1.699 0 0 0-.966.07l1.015.421a1.249 1.249 0 0 1-.96 2.307v.002ZM2.546 2.121A7.996 7.996 0 0 1 7.966 0l.003.013a7.988 7.988 0 0 1 7.159 4.432 7.996 7.996 0 0 1-4.277 11.018 7.99 7.99 0 0 1-8.274-1.558A7.989 7.989 0 0 1 .279 10.18l3.064 1.267A2.264 2.264 0 0 0 7.823 11v-.107l2.718-1.938h.063A3.016 3.016 0 1 0 7.589 5.94v.031l-1.906 2.76h-.126c-.454 0-.898.138-1.273.395L0 7.354A7.995 7.995 0 0 1 2.546 2.12Z" fill="#000"/></g><defs><clipPath id="a"><path fill="#fff" d="M0 0h16v16H0z"/></clipPath></defs></svg>

data/library_placeholder.svg

@@ -1,15 +1 @@
-<svg xmlns="http://www.w3.org/2000/svg" width="200" height="300" fill="none">
+<svg width="200" height="300" fill="none" xmlns="http://www.w3.org/2000/svg"><path fill="url(#a)" d="M0 0h200v300H0z"/><path fill-rule="evenodd" clip-rule="evenodd" d="M63.125 113.125c-8.146 0-14.75 6.604-14.75 14.75v44.25c0 8.146 6.604 14.75 14.75 14.75h73.75c8.146 0 14.75-6.604 14.75-14.75v-44.25c0-8.146-6.604-14.75-14.75-14.75h-73.75Zm22.125 14.75a7.375 7.375 0 0 0-7.375 7.375v29.5a7.375 7.375 0 0 0 7.375 7.375h29.5a7.375 7.375 0 0 0 7.375-7.375v-29.5a7.375 7.375 0 0 0-7.375-7.375h-29.5ZM129.5 150a7.375 7.375 0 1 1 14.75 0 7.375 7.375 0 0 1-14.75 0Zm-66.375-7.375a7.375 7.375 0 1 0 0 14.75 7.375 7.375 0 0 0 0-14.75Z" fill="#fff"/><defs><linearGradient id="a" x1="100" y1="0" x2="100" y2="300" gradientUnits="userSpaceOnUse"><stop stop-color="#9A9996"/><stop offset="1" stop-color="#5E5C64"/></linearGradient></defs></svg>
-    <path fill="url(#a)" d="M0 0h200v300H0z"/>
-    <g fill="#241F31" clip-path="url(#b)">
-        <path d="M49 169.125v15.937C49 193.853 56.147 201 64.938 201h3.187c7.047 0 12.75-5.703 12.75-12.75s5.703-12.75 12.75-12.75 12.75 5.703 12.75 12.75c.872 7.919 8.019 13.622 15.937 12.75 8.791 0 15.938-7.122 15.938-15.938v-15.937c0-14.095-11.405-25.5-25.5-25.5H74.5c-14.095 0-25.5 11.405-25.5 25.5Zm20.719-12.75h3.187c.872 0 1.594.722 1.594 1.594v4.781h4.781c.872 0 1.594.722 1.594 1.594v3.187c0 .897-.722 1.594-1.594 1.594H74.5v4.781c0 .897-.722 1.594-1.594 1.594H69.72a1.573 1.573 0 0 1-1.594-1.594v-4.781h-4.781a1.573 1.573 0 0 1-1.594-1.594v-3.187c0-.872.697-1.594 1.594-1.594h4.781v-4.781c0-.872.697-1.594 1.594-1.594Zm39.843 4.781a4.783 4.783 0 0 1 4.782 4.782 4.783 4.783 0 0 1-4.782 4.781 4.783 4.783 0 0 1-4.781-4.781 4.783 4.783 0 0 1 4.781-4.782Zm12.75 6.375a4.783 4.783 0 0 1 4.782 4.781 4.783 4.783 0 0 1-4.782 4.782 4.783 4.783 0 0 1-4.781-4.782 4.783 4.783 0 0 1 4.781-4.781ZM61.75 118.225c.05 10.558 8.666 19.075 19.225 19.025h50.8c10.609 0 19.225-8.616 19.225-19.225-.05-10.558-8.666-19.075-19.225-19.025h-50.8c-10.609 0-19.225 8.616-19.225 19.225Zm20.52-12.85h3.187c.872 0 1.594.722 1.594 1.594v4.781h4.781c.872 0 1.594.722 1.594 1.594v3.187c0 .897-.722 1.594-1.594 1.594h-4.781v4.781c0 .897-.722 1.594-1.594 1.594h-3.188a1.573 1.573 0 0 1-1.593-1.594v-4.781h-4.782a1.573 1.573 0 0 1-1.593-1.594v-3.187c0-.872.697-1.594 1.593-1.594h4.782v-4.781c0-.872.697-1.594 1.593-1.594Zm39.843 4.781a4.783 4.783 0 0 1 4.782 4.782 4.783 4.783 0 0 1-4.782 4.781 4.783 4.783 0 0 1-4.781-4.781 4.783 4.783 0 0 1 4.781-4.782Zm12.75.199a4.783 4.783 0 0 1 4.782 4.782 4.783 4.783 0 0 1-4.782 4.781 4.783 4.783 0 0 1-4.781-4.781 4.783 4.783 0 0 1 4.781-4.782Z"/>
-    </g>
-    <defs>
-        <linearGradient id="a" x1="100" x2="100" y1="0" y2="300" gradientUnits="userSpaceOnUse">
-            <stop stop-color="#DEDDDA"/>
-            <stop offset="1" stop-color="#9A9996"/>
-        </linearGradient>
-        <clipPath id="b">
-            <path fill="#fff" d="M49 99h102v102H49z"/>
-        </clipPath>
-    </defs>
-</svg>

data/library_placeholder_small.svg

@@ -0,0 +1 @@
+<svg width="2" height="2" fill="none" xmlns="http://www.w3.org/2000/svg"><path fill="url(#a)" d="M0 0h2v2H0z"/><defs><linearGradient id="a" x1="1" y1="0" x2="1" y2="2" gradientUnits="userSpaceOnUse"><stop stop-color="#9A9996"/><stop offset="1" stop-color="#5E5C64"/></linearGradient></defs></svg>

data/meson.build

@@ -3,14 +3,19 @@ blueprints = custom_target('blueprints',
     'gtk/help-overlay.blp',
     'gtk/window.blp',
     'gtk/game.blp',
-    'gtk/preferences.blp'
+    'gtk/preferences.blp',
+    'gtk/details-window.blp'
   ),
   output: '.',
   command: [find_program('blueprint-compiler'), 'batch-compile', '@OUTPUT@', '@CURRENT_SOURCE_DIR@', '@INPUT@'],
 )
 
 gnome.compile_resources('cartridges',
-  'cartridges.gresource.xml',
+  configure_file(
+    input: 'cartridges.gresource.xml.in',
+    output: 'cartridges.gresource.xml',
+    configuration: conf
+  ),
   gresource_bundle: true,
   install: true,
   install_dir: pkgdatadir,
@@ -18,8 +23,12 @@ gnome.compile_resources('cartridges',
 )
 
 desktop_file = i18n.merge_file(
+        input: configure_file(
           input: 'hu.kramo.Cartridges.desktop.in',
-       output: 'hu.kramo.Cartridges.desktop',
+          output: app_id + '.desktop.in',
+          configuration: conf
+        ),
+       output: app_id + '.desktop',
          type: 'desktop',
        po_dir: '../po',
       install: true,
@@ -32,19 +41,32 @@ if desktop_utils.found()
 endif
 
 appstream_file = i18n.merge_file(
+        input: configure_file(
           input: 'hu.kramo.Cartridges.metainfo.xml.in',
-       output: 'hu.kramo.Cartridges.metainfo.xml',
+          output: app_id + '.metainfo.xml.in',
+          configuration: conf
+        ),
+       output: app_id + '.metainfo.xml',
        po_dir: '../po',
       install: true,
   install_dir: join_paths(get_option('datadir'), 'metainfo')
 )
 
-appstream_util = find_program('appstream-util', required: false)
+appstreamcli = find_program('appstreamcli', required: false)
-if appstream_util.found()
+if appstreamcli.found()
-  test('Validate appstream file', appstream_util, args: ['validate', appstream_file])
+  test('Validate appstream file',
+    appstreamcli,
+    args: ['validate', '--no-net', '--explain', appstream_file],
+    workdir: meson.current_build_dir()
+  )
 endif
 
-install_data('hu.kramo.Cartridges.gschema.xml',
+install_data(
+  configure_file(
+    input: 'hu.kramo.Cartridges.gschema.xml.in',
+    output: app_id + '.gschema.xml',
+    configuration: conf
+  ),
   install_dir: join_paths(get_option('datadir'), 'glib-2.0/schemas')
 )
 

docs/game_id.json.md

@@ -0,0 +1,116 @@
+# [game_id].json specification
+#### Version 2.0
+
+Games are saved to disk in the form of [game_id].json files. These files contain all information about a game excluding its cover, which is handled separately.
+
+## Location
+
+The standard location for these files is `/cartridges/games/` under the data directory of the user (`XDG_DATA_HOME` on Linux).
+
+## Contents
+
+The following attributes are saved:
+
+- [added](#added)
+- [executable](#executable)
+- [game_id](#game_id)
+- [source](#source)
+- [hidden](#hidden)
+- [last_played](#last_played)
+- [name](#name)
+- [developer](#developer)
+- [removed](#removed)
+- [blacklisted](#blacklisted)
+- [version](#version)
+
+### added
+
+The date at which the game was added.
+
+Cartridges will set the value for itself. Don't touch it.
+
+Stored as a Unix time stamp.
+
+### executable
+
+The executable to run when launching a game.
+
+If the source has a URL handler, using that is preferred. In that case, the value should be `"xdg-open url://example/url"` for Linux and `"start url://example/url"` for Windows.
+
+Stored as either a string (preferred) or an argument vector to be passed to the shell through [subprocess.Popen](https://docs.python.org/3/library/subprocess.html#popen-constructor).
+
+### game_id
+
+The unique ID of the game, prefixed with [`[source]_`](#source) to avoid clashes.
+
+If the game's source uses a consistent internal ID system, use the ID from there. If not, use a hash function that always returns the same hash for the same game, even if some of its attributes change inside of the source.
+
+Stored as a string.
+
+### source
+
+A unique ID for the source of the game in lowercase, without spaces or underscores.
+
+If a source provides multiple internal sources, these should be separately labeled, but share a common prefix. eg. `heoic_gog`, `heroic_epic`. This is the only place you should use an underscore.
+
+Stored as a string.
+
+### hidden
+
+Whether or not a game is hidden.
+
+If the source provides a way of hiding games, take the value from there. Otherwise it should be set to false by default.
+
+Stored as a boolean.
+
+### last_played
+
+The date at which the game was last launched from Cartridges.
+
+Cartridges will set the value for itself. Don't touch it.
+
+Stored as a Unix time stamp. 0 if the game hasn't been played yet.
+
+### name
+
+The title of the game.
+
+Stored as a string.
+
+### developer
+
+The developer or publisher of the game.
+
+If there are multiple developers or publishers, they should be joined with a comma and a space (`, `) into one string.
+
+This is an optional attribute. If it can't be retrieved from the source, don't touch it.
+
+Stored as a string.
+
+### removed
+
+Whether or not a game has been removed.
+
+Cartridges will set the value for itself. Don't touch it.
+
+Stored as a boolean.
+
+### blacklisted
+
+Whether or not a game is blacklisted. Blacklisting a game means it is going to still be imported, but not displayed to the user.
+
+You should only blacklist a game based on information you pull from the web. This is to ensure that games which you would skip based on information online are still skipped even if the user loses their internet connection. If an entry is broken locally, just skip it.
+
+The only reason to blacklist a game is if you find out that the locally cached entry is not actually a game (eg. Proton) or is otherwise invalid.
+
+Unless the above criteria is met, don't touch the attribute.
+
+Stored as a boolean.
+
+### version
+
+The version number of the [game_id].json specification.
+
+Cartridges will set the value for itself. Don't touch it.
+
+Stored as a number.

flatpak/hu.kramo.Cartridges.Devel.json

@@ -0,0 +1,138 @@
+{
+    "id" : "hu.kramo.Cartridges.Devel",
+    "runtime" : "org.gnome.Platform",
+    "runtime-version" : "45",
+    "sdk" : "org.gnome.Sdk",
+    "command" : "cartridges",
+    "finish-args" : [
+        "--share=network",
+        "--share=ipc",
+        "--socket=fallback-x11",
+        "--device=dri",
+        "--socket=wayland",
+        "--talk-name=org.freedesktop.Flatpak",
+        "--filesystem=host",
+        "--filesystem=~/.var/app/com.valvesoftware.Steam/data/Steam/:ro",
+        "--filesystem=~/.var/app/net.lutris.Lutris/:ro",
+        "--filesystem=~/.var/app/com.heroicgameslauncher.hgl/config/heroic/:ro",
+        "--filesystem=~/.var/app/com.heroicgameslauncher.hgl/config/legendary/:ro",
+        "--filesystem=~/.var/app/com.usebottles.bottles/data/bottles/:ro",
+        "--filesystem=~/.var/app/io.itch.itch/config/itch/:ro",
+        "--filesystem=~/.var/app/org.libretro.RetroArch/config/retroarch/:ro",
+        "--filesystem=/var/lib/flatpak/app:ro",
+        "--filesystem=/var/lib/flatpak/exports:ro",
+        "--filesystem=xdg-data/flatpak/app:ro",
+        "--filesystem=xdg-data/flatpak/exports:ro"
+    ],
+    "cleanup" : [
+        "/include",
+        "/lib/pkgconfig",
+        "/man",
+        "/share/doc",
+        "/share/gtk-doc",
+        "/share/man",
+        "/share/pkgconfig",
+        "*.la",
+        "*.a"
+    ],
+    "modules" : [
+        {
+            "name": "python3-modules",
+            "buildsystem": "simple",
+            "build-commands": [],
+            "modules": [
+                {
+                    "name": "python3-pyyaml",
+                    "buildsystem": "simple",
+                    "build-commands": [
+                        "pip3 install --verbose --exists-action=i --no-index --find-links=\"file://${PWD}\" --prefix=${FLATPAK_DEST} \"pyyaml\" --no-build-isolation"
+                    ],
+                    "sources": [
+                        {
+                            "type": "file",
+                            "url": "https://files.pythonhosted.org/packages/36/2b/61d51a2c4f25ef062ae3f74576b01638bebad5e045f747ff12643df63844/PyYAML-6.0.tar.gz",
+                            "sha256": "68fb519c14306fec9720a2a5b45bc9f0c8d1b9c72adf45c37baedfcd949c35a2"
+                        }
+                    ]
+                },
+                {
+                    "name": "python3-requests",
+                    "buildsystem": "simple",
+                    "build-commands": [
+                        "pip3 install --verbose --exists-action=i --no-index --find-links=\"file://${PWD}\" --prefix=${FLATPAK_DEST} \"requests\" --no-build-isolation"
+                    ],
+                    "sources": [
+                        {
+                            "type": "file",
+                            "url": "https://files.pythonhosted.org/packages/71/4c/3db2b8021bd6f2f0ceb0e088d6b2d49147671f25832fb17970e9b583d742/certifi-2022.12.7-py3-none-any.whl",
+                            "sha256": "4ad3232f5e926d6718ec31cfc1fcadfde020920e278684144551c91769c7bc18"
+                        },
+                        {
+                            "type": "file",
+                            "url": "https://files.pythonhosted.org/packages/ff/d7/8d757f8bd45be079d76309248845a04f09619a7b17d6dfc8c9ff6433cac2/charset-normalizer-3.1.0.tar.gz",
+                            "sha256": "34e0a2f9c370eb95597aae63bf85eb5e96826d81e3dcf88b8886012906f509b5"
+                        },
+                        {
+                            "type": "file",
+                            "url": "https://files.pythonhosted.org/packages/fc/34/3030de6f1370931b9dbb4dad48f6ab1015ab1d32447850b9fc94e60097be/idna-3.4-py3-none-any.whl",
+                            "sha256": "90b77e79eaa3eba6de819a0c442c0b4ceefc341a7a2ab77d7562bf49f425c5c2"
+                        },
+                        {
+                            "type": "file",
+                            "url": "https://files.pythonhosted.org/packages/d2/f4/274d1dbe96b41cf4e0efb70cbced278ffd61b5c7bb70338b62af94ccb25b/requests-2.28.2-py3-none-any.whl",
+                            "sha256": "64299f4909223da747622c030b781c0d7811e359c37124b4bd368fb8c6518baa"
+                        },
+                        {
+                            "type": "file",
+                            "url": "https://files.pythonhosted.org/packages/7b/f5/890a0baca17a61c1f92f72b81d3c31523c99bec609e60c292ea55b387ae8/urllib3-1.26.15-py2.py3-none-any.whl",
+                            "sha256": "aa751d169e23c7479ce47a0cb0da579e3ede798f994f5816a74e4f4500dcea42"
+                        }
+                    ]
+                },
+                {
+                    "name": "python3-pillow",
+                    "buildsystem": "simple",
+                    "build-commands": [
+                        "pip3 install --verbose --exists-action=i --no-index --find-links=\"file://${PWD}\" --prefix=${FLATPAK_DEST} \"pillow\" --no-build-isolation"
+                    ],
+                    "sources": [
+                        {
+                            "type": "file",
+                            "url": "https://files.pythonhosted.org/packages/00/d5/4903f310765e0ff2b8e91ffe55031ac6af77d982f0156061e20a4d1a8b2d/Pillow-9.5.0.tar.gz",
+                            "sha256": "bf548479d336726d7a0eceb6e767e179fbde37833ae42794602631a070d630f1"
+                        }
+                    ]
+                }
+            ]
+        },
+        {
+            "name" : "blueprint-compiler",
+            "buildsystem" : "meson",
+            "sources" : [
+                {
+                    "type" : "git",
+                    "url" : "https://gitlab.gnome.org/jwestman/blueprint-compiler",
+                    "tag" : "v0.10.0"
+                }
+            ],
+            "cleanup" : [
+                "*"
+            ]
+        },
+        {
+            "name" : "cartridges",
+            "builddir" : true,
+            "buildsystem" : "meson",
+            "run-tests" : true,
+            "config-opts": [
+                "-Dprofile=development"
+            ],
+            "sources" : [
+                {
+                    "type" : "dir",
+                    "path" : ".."
+                }
+            ]
+        }
+    ]
+}

hu.kramo.Cartridges.json

@@ -1,58 +0,0 @@
-{
-    "app-id" : "hu.kramo.Cartridges",
-    "runtime" : "org.gnome.Platform",
-    "runtime-version" : "master",
-    "sdk" : "org.gnome.Sdk",
-    "command" : "cartridges",
-    "finish-args" : [
-        "--share=ipc",
-        "--socket=fallback-x11",
-        "--device=dri",
-        "--socket=wayland",
-        "--talk-name=org.freedesktop.Flatpak",
-        "--talk-name=org.gtk.vfs.*",
-        "--filesystem=xdg-run/gvfsd",
-        "--filesystem=~/.steam/steam/:ro",
-        "--filesystem=xdg-config/heroic/:ro",
-        "--filesystem=xdg-data/bottles/:ro",
-        "--filesystem=~/.var/app/com.valvesoftware.Steam/data/Steam/:ro",
-        "--filesystem=~/.var/app/com.heroicgameslauncher.hgl/config/heroic/:ro",
-        "--filesystem=~/.var/app/com.usebottles.bottles/data/bottles/:ro"
-    ],
-    "cleanup" : [
-        "/include",
-        "/lib/pkgconfig",
-        "/man",
-        "/share/doc",
-        "/share/gtk-doc",
-        "/share/man",
-        "/share/pkgconfig",
-        "*.la",
-        "*.a"
-    ],
-    "modules" : [
-        "python3-modules.json",
-        {
-            "name": "blueprint-compiler",
-            "buildsystem": "meson",
-            "sources": [
-                {
-                "type": "git",
-                "url": "https://gitlab.gnome.org/jwestman/blueprint-compiler",
-                "tag": "v0.6.0"
-                }
-            ]
-        },
-        {
-            "name" : "cartridges",
-            "builddir" : true,
-            "buildsystem" : "meson",
-            "sources" : [
-                {
-                    "type" : "dir",
-                    "path" : "."
-                }
-            ]
-        }
-    ]
-}

meson.build

@@ -1,18 +1,50 @@
 project('cartridges',
-          version: '0.1.3',
+          version: '2.7.3',
     meson_version: '>= 0.59.0',
   default_options: [ 'warning_level=2', 'werror=false', ],
 )
 
 i18n = import('i18n')
 gnome = import('gnome')
+python = import('python')
 
+py_installation = python.find_installation('python3')
+
+python_dir = join_paths(get_option('prefix'), py_installation.get_install_dir())
 pkgdatadir = join_paths(get_option('prefix'), get_option('datadir'), meson.project_name())
+libexecdir = join_paths(get_option('prefix'), get_option('libexecdir'))
+
+profile = get_option('profile')
+if profile == 'development'
+  app_id = 'hu.kramo.Cartridges.Devel'
+  prefix = '/hu/kramo/Cartridges/Devel'
+elif profile ==  'release'
+  app_id = 'hu.kramo.Cartridges'
+  prefix = '/hu/kramo/Cartridges'
+endif
+
+conf = configuration_data()
+conf.set('PYTHON', py_installation.full_path())
+conf.set('PYTHON_VERSION', py_installation.language_version())
+conf.set('APP_ID', app_id)
+conf.set('PREFIX', prefix)
+conf.set('VERSION', meson.project_version())
+conf.set('PROFILE', profile)
+conf.set('TIFF_COMPRESSION', get_option('tiff_compression'))
+conf.set('localedir', join_paths(get_option('prefix'), get_option('localedir')))
+conf.set('pkgdatadir', pkgdatadir)
+conf.set('libexecdir', libexecdir)
 
 subdir('data')
-subdir('src')
+subdir('cartridges')
 subdir('po')
 
+if host_machine.system() == 'windows'
+  subdir('windows')
+else
+  subdir('search-provider')
+endif
+
 gnome.post_install(
      glib_compile_schemas: true,
     gtk_update_icon_cache: true,

meson_options.txt

@@ -0,0 +1,18 @@
+option(
+  'profile',
+  type: 'combo',
+  choices: [
+    'release',
+    'development',
+  ],
+  value: 'release'
+)
+option(
+  'tiff_compression',
+  type: 'combo',
+  choices: [
+    'webp',
+    'jpeg',
+  ],
+  value: 'webp'
+)

po/LINGUAS

@@ -3,3 +3,26 @@ ta
 uk
 nb_NO
 fr
+nl
+it
+ar
+es
+fi
+pt
+ru
+ko
+de
+ro
+pt_BR
+fa
+pl
+sv
+tr
+el
+cs
+zh_Hans
+be
+hr
+ca
+ja
+hi

po/POTFILES

@@ -1,19 +1,33 @@
 data/hu.kramo.Cartridges.desktop.in
-data/hu.kramo.Cartridges.gschema.xml
+data/hu.kramo.Cartridges.gschema.xml.in
 data/hu.kramo.Cartridges.metainfo.xml.in
 
-data/gtk/window.blp
+data/gtk/details-window.blp
 data/gtk/game.blp
 data/gtk/help-overlay.blp
 data/gtk/preferences.blp
+data/gtk/window.blp
 
-src/main.py
+cartridges/main.py
-src/window.py
+cartridges/window.py
-src/game.py
+cartridges/details_window.py
-src/preferences.py
+cartridges/game.py
+cartridges/preferences.py
 
-src/utils/bottles_parser.py
+cartridges/utils/create_dialog.py
-src/utils/create_details_window.py
+
-src/utils/create_dialog.py
+cartridges/importer/importer.py
-src/utils/heroic_parser.py
+cartridges/importer/source.py
-src/utils/steam_parser.py
+cartridges/importer/location.py
+cartridges/importer/location.py
+cartridges/importer/bottles_source.py
+cartridges/importer/desktop_source.py
+cartridges/importer/flatpak_source.py
+cartridges/importer/heroic_source.py
+cartridges/importer/itch_source.py
+cartridges/importer/legendary_source.py
+cartridges/importer/lutris_source.py
+cartridges/importer/retroarch_source.py
+cartridges/importer/steam_source.py
+
+cartridges/store/managers/sgdb_manager.py

po/ar.po

@@ -0,0 +1,836 @@
+# SOME DESCRIPTIVE TITLE.
+# Copyright (C) YEAR THE PACKAGE'S COPYRIGHT HOLDER
+# This file is distributed under the same license as the cartridges package.
+# Ali Aljishi <ahj696@hotmail.com>, 2023.
+# kramo <contact@kramo.hu>, 2023.
+# Ali-98 <ahj696@hotmail.com>, 2023.
+msgid ""
+msgstr ""
+"Project-Id-Version: cartridges\n"
+"Report-Msgid-Bugs-To: \n"
+"POT-Creation-Date: 2023-12-12 10:32+0100\n"
+"PO-Revision-Date: 2023-12-15 13:10+0000\n"
+"Last-Translator: Ali-98 <ahj696@hotmail.com>\n"
+"Language-Team: Arabic <https://hosted.weblate.org/projects/cartridges/"
+"cartridges/ar/>\n"
+"Language: ar\n"
+"MIME-Version: 1.0\n"
+"Content-Type: text/plain; charset=UTF-8\n"
+"Content-Transfer-Encoding: 8bit\n"
+"Plural-Forms: nplurals=6; plural=n==0 ? 0 : n==1 ? 1 : n==2 ? 2 : n%100>=3 "
+"&& n%100<=10 ? 3 : n%100>=11 ? 4 : 5;\n"
+"X-Generator: Weblate 5.3\n"
+
+#: data/hu.kramo.Cartridges.desktop.in:3
+#: data/hu.kramo.Cartridges.metainfo.xml.in:6
+#: data/hu.kramo.Cartridges.metainfo.xml.in:32 data/gtk/window.blp:47
+#: data/gtk/window.blp:80 cartridges/main.py:205
+msgid "Cartridges"
+msgstr "خراطيش"
+
+#: data/hu.kramo.Cartridges.desktop.in:4
+msgid "Game Launcher"
+msgstr "مشغِّل ألعاب"
+
+#: data/hu.kramo.Cartridges.desktop.in:5
+#: data/hu.kramo.Cartridges.metainfo.xml.in:7
+msgid "Launch all your games"
+msgstr "شغِّل كلَّ ألعابك"
+
+#: data/hu.kramo.Cartridges.desktop.in:11
+msgid ""
+"gaming;launcher;steam;lutris;heroic;bottles;itch;flatpak;legendary;retroarch;"
+msgstr ""
+"لعب;مشغل;ستيم;لوترس;هروك;قوارير;إتش;هيرويك;بوتلز;لجندري;فلاتباك;رتروآرتش;"
+
+#: data/hu.kramo.Cartridges.metainfo.xml.in:9
+msgid ""
+"Cartridges is a simple game launcher for all of your games. It has support "
+"for importing games from Steam, Lutris, Heroic and more with no login "
+"necessary. You can sort and hide games or download cover art from "
+"SteamGridDB."
+msgstr ""
+"«خراطيش» هو مشغِّل ألعاب يسير، فيه دعم لاستيراد الألعاب من ستيم،ولوترس، وهِرُوِك، "
+"وبرامج أخرى، وذلك دون تسجيل دخول. ولك ترتيب وإخفاء الألعاب فيه كيفما شئت، "
+"وكذلك تستطيع منه تنزيل غُلُف الألعاب من SteamGridDB."
+
+#: data/hu.kramo.Cartridges.metainfo.xml.in:36 data/gtk/window.blp:290
+#: cartridges/details_window.py:71
+msgid "Game Details"
+msgstr "تفاصيل اللعبة"
+
+#: data/hu.kramo.Cartridges.metainfo.xml.in:40
+msgid "Edit Game Details"
+msgstr "حرِّر تفاصيل اللعبة"
+
+#: data/hu.kramo.Cartridges.metainfo.xml.in:44 data/gtk/help-overlay.blp:19
+#: data/gtk/window.blp:516 cartridges/details_window.py:271
+#: cartridges/importer/importer.py:319 cartridges/importer/importer.py:370
+msgid "Preferences"
+msgstr "التفضيلات"
+
+#: data/gtk/details-window.blp:25
+msgid "Cancel"
+msgstr "ألغِ"
+
+#: data/gtk/details-window.blp:55
+msgid "New Cover"
+msgstr "غلاف جديد"
+
+#: data/gtk/details-window.blp:73
+msgid "Delete Cover"
+msgstr "احذف الغلاف"
+
+#: data/gtk/details-window.blp:100 data/gtk/game.blp:81
+msgid "Title"
+msgstr "العنوان"
+
+#: data/gtk/details-window.blp:103
+msgid "Developer (optional)"
+msgstr "المطوِّر (اختياري)"
+
+#: data/gtk/details-window.blp:108
+msgid "Executable"
+msgstr "ملفُّ التنفيذ"
+
+#: data/gtk/details-window.blp:114
+msgid "Select File"
+msgstr "اختر ملفًّا"
+
+#: data/gtk/details-window.blp:125
+msgid "More Info"
+msgstr "معلومات أكثر"
+
+#: data/gtk/game.blp:102 data/gtk/game.blp:110 data/gtk/window.blp:417
+msgid "Edit"
+msgstr "حرِّر"
+
+#: data/gtk/game.blp:103 cartridges/window.py:350
+msgid "Hide"
+msgstr "أخفِ"
+
+#: data/gtk/game.blp:104 data/gtk/game.blp:112 data/gtk/window.blp:437
+msgid "Remove"
+msgstr "أزل"
+
+#: data/gtk/game.blp:111 cartridges/window.py:352
+msgid "Unhide"
+msgstr "اكشف"
+
+#: data/gtk/help-overlay.blp:11 data/gtk/preferences.blp:8
+msgid "General"
+msgstr "عام"
+
+#: data/gtk/help-overlay.blp:14 data/gtk/window.blp:184 data/gtk/window.blp:200
+#: data/gtk/window.blp:244 data/gtk/window.blp:260 data/gtk/window.blp:448
+msgid "Search"
+msgstr "ابحث"
+
+#: data/gtk/help-overlay.blp:24 data/gtk/window.blp:517
+msgid "Keyboard Shortcuts"
+msgstr "اختصارات لوحة المفاتيح"
+
+#: data/gtk/help-overlay.blp:29 cartridges/game.py:103
+#: cartridges/preferences.py:129 cartridges/importer/importer.py:394
+msgid "Undo"
+msgstr "تراجع"
+
+#: data/gtk/help-overlay.blp:34
+msgid "Quit"
+msgstr "أنهِ"
+
+#: data/gtk/help-overlay.blp:39 data/gtk/window.blp:88 data/gtk/window.blp:164
+msgid "Toggle Sidebar"
+msgstr "أظهر شريط الجانب"
+
+#: data/gtk/help-overlay.blp:44 data/gtk/window.blp:177 data/gtk/window.blp:237
+msgid "Main Menu"
+msgstr "القائمة الرئيسة"
+
+#: data/gtk/help-overlay.blp:50
+msgid "Games"
+msgstr "الألعاب"
+
+#: data/gtk/help-overlay.blp:53 data/gtk/window.blp:170 data/gtk/window.blp:524
+msgid "Add Game"
+msgstr "أضف لعبةً"
+
+#: data/gtk/help-overlay.blp:58 data/gtk/preferences.blp:112
+#: data/gtk/window.blp:27 data/gtk/window.blp:528
+msgid "Import"
+msgstr "استورد"
+
+#: data/gtk/help-overlay.blp:63
+msgid "Show Hidden Games"
+msgstr "أظهر الألعاب المخفية"
+
+#: data/gtk/help-overlay.blp:68
+msgid "Remove Game"
+msgstr "أزل اللعبة"
+
+#: data/gtk/preferences.blp:12 data/gtk/preferences.blp:116
+#: data/gtk/preferences.blp:381
+msgid "Behavior"
+msgstr "السلوك"
+
+#: data/gtk/preferences.blp:15
+msgid "Exit After Launching Games"
+msgstr "اخرج بعد بدء الألعاب"
+
+#: data/gtk/preferences.blp:19
+msgid "Cover Image Launches Game"
+msgstr "تبدأ صورة الغلاف اللعبة"
+
+#: data/gtk/preferences.blp:20
+msgid "Swaps the behavior of the cover image and the play button"
+msgstr "يبدِّل سلوك صورة الغلاف وزرِّ «العب»"
+
+#: data/gtk/preferences.blp:25 cartridges/details_window.py:85
+msgid "Images"
+msgstr "الصور"
+
+#: data/gtk/preferences.blp:28
+msgid "High Quality Images"
+msgstr "صور ذات دقَّة عالية"
+
+#: data/gtk/preferences.blp:29
+msgid "Save game covers losslessly at the cost of storage"
+msgstr "احفظ غُلُف الألعاب دون فقد على حساب مساحة التخزين"
+
+#: data/gtk/preferences.blp:34
+msgid "Danger Zone"
+msgstr "منطقة خطر"
+
+#: data/gtk/preferences.blp:47
+msgid "Remove All Games"
+msgstr "أزل كلَّ الألعاب"
+
+#: data/gtk/preferences.blp:119
+msgid "Remove Uninstalled Games"
+msgstr "أزل الألعاب المحذوفة"
+
+#: data/gtk/preferences.blp:124
+msgid "Sources"
+msgstr "المصادر"
+
+#: data/gtk/preferences.blp:127 cartridges/importer/steam_source.py:114
+msgid "Steam"
+msgstr "ستيم"
+
+#: data/gtk/preferences.blp:136 data/gtk/preferences.blp:158
+#: data/gtk/preferences.blp:200 data/gtk/preferences.blp:238
+#: data/gtk/preferences.blp:260 data/gtk/preferences.blp:282
+#: data/gtk/preferences.blp:304
+msgid "Install Location"
+msgstr "موضع التثبيت"
+
+#: data/gtk/preferences.blp:149 data/gtk/window.blp:539
+#: cartridges/importer/lutris_source.py:92
+msgid "Lutris"
+msgstr "لوترس"
+
+#: data/gtk/preferences.blp:170
+msgid "Cache Location"
+msgstr "موضع الذاكرة المؤقتة"
+
+#: data/gtk/preferences.blp:182
+msgid "Import Steam Games"
+msgstr "استورد ألعابًا من ستيم"
+
+#: data/gtk/preferences.blp:186
+msgid "Import Flatpak Games"
+msgstr "استورد ألعاب فلاتباك"
+
+#: data/gtk/preferences.blp:191 cartridges/importer/heroic_source.py:355
+msgid "Heroic"
+msgstr "هِرُوِك"
+
+#: data/gtk/preferences.blp:212
+msgid "Import Epic Games"
+msgstr "استورد ألعاب أَبِك"
+
+#: data/gtk/preferences.blp:216
+msgid "Import GOG Games"
+msgstr "استورد ألعاب جي‌أو‌جي"
+
+#: data/gtk/preferences.blp:220
+msgid "Import Amazon Games"
+msgstr "استورد ألعابًا من أمازون"
+
+#: data/gtk/preferences.blp:224
+msgid "Import Sideloaded Games"
+msgstr "استورد ألعابًا مثبَّتةً بغير متجر"
+
+#: data/gtk/preferences.blp:229 cartridges/importer/bottles_source.py:86
+msgid "Bottles"
+msgstr "قوارير"
+
+#: data/gtk/preferences.blp:251 cartridges/importer/itch_source.py:81
+msgid "itch"
+msgstr "إتش"
+
+#: data/gtk/preferences.blp:273 cartridges/importer/legendary_source.py:97
+msgid "Legendary"
+msgstr "لجندري"
+
+#: data/gtk/preferences.blp:295 cartridges/importer/retroarch_source.py:142
+msgid "RetroArch"
+msgstr "رتروآرتش"
+
+#: data/gtk/preferences.blp:317 cartridges/importer/flatpak_source.py:124
+msgid "Flatpak"
+msgstr "فلاتباك"
+
+#. The location of the system-wide data directory
+#: data/gtk/preferences.blp:327
+msgid "System Location"
+msgstr "موضع النظام"
+
+#. The location of the user-specific data directory
+#: data/gtk/preferences.blp:340
+msgid "User Location"
+msgstr "موضع المستخدم"
+
+#: data/gtk/preferences.blp:352
+msgid "Import Game Launchers"
+msgstr "استورد مشغِّلات ألعاب"
+
+#: data/gtk/preferences.blp:357 cartridges/importer/desktop_source.py:215
+msgid "Desktop Entries"
+msgstr "مدخلات سطح المكتب"
+
+#: data/gtk/preferences.blp:369 data/gtk/window.blp:537
+msgid "SteamGridDB"
+msgstr "SteamGridDB"
+
+#: data/gtk/preferences.blp:373
+msgid "Authentication"
+msgstr "الاستيثاق"
+
+#: data/gtk/preferences.blp:376
+msgid "API Key"
+msgstr "مفتاح واجهة البرمجة"
+
+#: data/gtk/preferences.blp:384
+msgid "Use SteamGridDB"
+msgstr "استخدم SteamGridDB"
+
+#: data/gtk/preferences.blp:385
+msgid "Download images when adding or importing games"
+msgstr "نزِّل الصور حينما تنزِّل أو تستورد الألعاب"
+
+#: data/gtk/preferences.blp:389
+msgid "Prefer Over Official Images"
+msgstr "فضِّلها على الصور الرسمية"
+
+#: data/gtk/preferences.blp:393
+msgid "Prefer Animated Images"
+msgstr "فضِّل الصور المتحرِّكة"
+
+#: data/gtk/preferences.blp:399
+msgid "Update Covers"
+msgstr "حدِّث الغُلُف"
+
+#: data/gtk/preferences.blp:400
+msgid "Fetch covers for games already in your library"
+msgstr "اجلب غُلُفًا للألعاب التي في المكتبة"
+
+#: data/gtk/preferences.blp:405
+msgid "Update"
+msgstr "حدِّث"
+
+#: data/gtk/window.blp:6 data/gtk/window.blp:14
+msgid "No Games Found"
+msgstr "لم يُعثر على ألعاب"
+
+#: data/gtk/window.blp:7 data/gtk/window.blp:15
+msgid "Try a different search."
+msgstr "جرِّب بحثًا آخر."
+
+#: data/gtk/window.blp:21
+msgid "No Games"
+msgstr "لا توجد ألعاب"
+
+#: data/gtk/window.blp:22
+msgid "Use the + button to add games."
+msgstr "استخدم زرَّ + لتضيف ألعابًا."
+
+#: data/gtk/window.blp:40
+msgid "No Hidden Games"
+msgstr "لا توجد ألعاب مخفية"
+
+#: data/gtk/window.blp:41
+msgid "Games you hide will appear here."
+msgstr "هنا يظهر ما أخفيت من ألعاب."
+
+#: data/gtk/window.blp:75 data/gtk/window.blp:106 cartridges/main.py:226
+msgid "All Games"
+msgstr "كلُّ الألعاب"
+
+#: data/gtk/window.blp:126 cartridges/main.py:228
+msgid "Added"
+msgstr "أُضيفَت"
+
+#: data/gtk/window.blp:141
+msgid "Imported"
+msgstr "اُستوردَت"
+
+#: data/gtk/window.blp:230
+msgid "Hidden Games"
+msgstr "الألعاب المخفية"
+
+#: data/gtk/window.blp:341
+msgid "Game Title"
+msgstr "عنوان اللعبة"
+
+#: data/gtk/window.blp:398
+msgid "Play"
+msgstr "العب"
+
+#: data/gtk/window.blp:475
+msgid "Sort"
+msgstr "رتِّب"
+
+#: data/gtk/window.blp:478
+msgid "A-Z"
+msgstr "أ-ي"
+
+#: data/gtk/window.blp:484
+msgid "Z-A"
+msgstr "ي-أ"
+
+#: data/gtk/window.blp:490
+msgid "Newest"
+msgstr "الأجدد"
+
+#: data/gtk/window.blp:496
+msgid "Oldest"
+msgstr "الأقدم"
+
+#: data/gtk/window.blp:502
+msgid "Last Played"
+msgstr "لُعبت آخر مرَّة"
+
+#: data/gtk/window.blp:509
+msgid "Show Hidden"
+msgstr "أظهر ما أخفي"
+
+#: data/gtk/window.blp:518
+msgid "About Cartridges"
+msgstr "عن «خراطيش»"
+
+#: data/gtk/window.blp:536
+msgid "IGDB"
+msgstr "IGDB"
+
+#: data/gtk/window.blp:538
+msgid "ProtonDB"
+msgstr "ProtonDB"
+
+#: data/gtk/window.blp:540
+msgid "HowLongToBeat"
+msgstr "HowLongToBeat"
+
+#. The variable is the title of the game
+#: cartridges/main.py:206 cartridges/game.py:125
+msgid "{} launched"
+msgstr "بُدئت {}"
+
+#. Translators: Replace this with your name for it to show up in the about window
+#: cartridges/main.py:269
+msgid "translator_credits"
+msgstr "Ali Aljishi <ahj696@hotmail.com>"
+
+#. The variable is the date when the game was added
+#: cartridges/window.py:373
+msgid "Added: {}"
+msgstr "أضيفت في: {}"
+
+#: cartridges/window.py:376
+msgid "Never"
+msgstr "أبدًا"
+
+#. The variable is the date when the game was last played
+#: cartridges/window.py:380
+msgid "Last played: {}"
+msgstr "لُعبت آخر مرَّة في: {}"
+
+#: cartridges/details_window.py:76
+msgid "Apply"
+msgstr "طبِّق"
+
+#: cartridges/details_window.py:82
+msgid "Add New Game"
+msgstr "أضف لعبةً جديدةً"
+
+#: cartridges/details_window.py:83
+msgid "Add"
+msgstr "أضف"
+
+#: cartridges/details_window.py:93
+msgid "Executables"
+msgstr "ملفات التنفيذ"
+
+#. Translate this string as you would translate "file"
+#: cartridges/details_window.py:108
+msgid "file.txt"
+msgstr "ملف.txt"
+
+#. As in software
+#: cartridges/details_window.py:110
+msgid "program"
+msgstr "البرنامج"
+
+#. Translate this string as you would translate "path to {}"
+#: cartridges/details_window.py:115 cartridges/details_window.py:117
+msgid "C:\\path\\to\\{}"
+msgstr "C:\\المسار\\إلى\\{}"
+
+#. Translate this string as you would translate "path to {}"
+#: cartridges/details_window.py:121 cartridges/details_window.py:123
+msgid "/path/to/{}"
+msgstr "/المسار/إلى/{}"
+
+#: cartridges/details_window.py:128
+msgid ""
+"To launch the executable \"{}\", use the command:\n"
+"\n"
+"<tt>\"{}\"</tt>\n"
+"\n"
+"To open the file \"{}\" with the default application, use:\n"
+"\n"
+"<tt>{} \"{}\"</tt>\n"
+"\n"
+"If the path contains spaces, make sure to wrap it in double quotes!"
+msgstr ""
+"إن أردت تشغيل ملفِّ التنفيذ «{}» فعليك استخدام الأمر:\n"
+"\n"
+"<tt>«{}»</tt>\n"
+"\n"
+"إن أردت فتح الملفِّ «{}» باستخدام التطبيق المبدئيِّ فعليك استخدام:\n"
+"\n"
+"<tt>{} «{}»</tt>\n"
+"\n"
+"ولا تنسَ إحاطة المسار بعلامتي تنصيص مزدوجتين حالما تضمَّن مسافات!"
+
+#: cartridges/details_window.py:171 cartridges/details_window.py:177
+msgid "Couldn't Add Game"
+msgstr "تعذَّرت إضافة اللعبة"
+
+#: cartridges/details_window.py:171 cartridges/details_window.py:213
+msgid "Game title cannot be empty."
+msgstr "لا يجوز كون عنوان اللعبة فارغًا."
+
+#: cartridges/details_window.py:177 cartridges/details_window.py:221
+msgid "Executable cannot be empty."
+msgstr "لا يجوز كون ملفِّ التنفيذ فارغًا."
+
+#: cartridges/details_window.py:212 cartridges/details_window.py:220
+msgid "Couldn't Apply Preferences"
+msgstr "تعذَّر تطبيق التفضيلات"
+
+#. The variable is the title of the game
+#: cartridges/game.py:139
+msgid "{} hidden"
+msgstr "أٌخفيت {}"
+
+#: cartridges/game.py:139
+msgid "{} unhidden"
+msgstr "أٌظهرت {}"
+
+#. The variable is the title of the game
+#. The variable is the number of games removed
+#: cartridges/game.py:153 cartridges/importer/importer.py:391
+msgid "{} removed"
+msgstr "أزيلت {}"
+
+#: cartridges/preferences.py:128
+msgid "All games removed"
+msgstr "أُزيلت كلُّ الألعاب"
+
+#: cartridges/preferences.py:176
+msgid ""
+"An API key is required to use SteamGridDB. You can generate one {}here{}."
+msgstr ""
+"تحتاج مفتاح واجهة برمجة حال ما أردت استخدام SteamGridDB، {}هنا تولِّده{}."
+
+#: cartridges/preferences.py:191
+msgid "Downloading covers…"
+msgstr "تُنزَّل الغُلُف…"
+
+#: cartridges/preferences.py:210
+msgid "Covers updated"
+msgstr "حُدِّثت الغُلُف"
+
+#: cartridges/preferences.py:345
+msgid "Installation Not Found"
+msgstr "لم يُعثر على التثبيت"
+
+#: cartridges/preferences.py:346
+msgid "Select a valid directory."
+msgstr "حدِّد مجلَّدًا صالحًا."
+
+#: cartridges/preferences.py:382 cartridges/importer/importer.py:317
+msgid "Warning"
+msgstr "تحذير"
+
+#: cartridges/preferences.py:416
+msgid "Invalid Directory"
+msgstr "مجلَّد غير صالح"
+
+#: cartridges/preferences.py:422
+msgid "Set Location"
+msgstr "عيِّن الموضع"
+
+#: cartridges/utils/create_dialog.py:33 cartridges/importer/importer.py:318
+msgid "Dismiss"
+msgstr "تجاهل"
+
+#: cartridges/importer/importer.py:145
+msgid "Importing Games…"
+msgstr "تُستورد الألعاب…"
+
+#: cartridges/importer/importer.py:338
+msgid "The following errors occured during import:"
+msgstr "طرأ هذا الخطأ أثناء الاستيراد:"
+
+#: cartridges/importer/importer.py:367
+msgid "No new games found"
+msgstr "لم يُعثر على ألعاب جديدة"
+
+#: cartridges/importer/importer.py:379
+msgid "1 game imported"
+msgstr "اُستوردت لعبة واحدة"
+
+#. The variable is the number of games
+#: cartridges/importer/importer.py:383
+msgid "{} games imported"
+msgstr "اُستوردت {} لعبة"
+
+#. A single game removed
+#: cartridges/importer/importer.py:387
+msgid "1 removed"
+msgstr "أزيل ١"
+
+#. The variable is the name of the source
+#: cartridges/importer/location.py:33
+msgid "Select the {} cache directory."
+msgstr "حدِّد مجلَّد ذاكرة {} المؤقتة."
+
+#. The variable is the name of the source
+#: cartridges/importer/location.py:35
+msgid "Select the {} configuration directory."
+msgstr "حدِّد مجلَّد ضبط {}."
+
+#. The variable is the name of the source
+#: cartridges/importer/location.py:37
+msgid "Select the {} data directory."
+msgstr "حدِّد مجلَّد بيانات {}."
+
+#: cartridges/importer/retroarch_source.py:129
+msgid "No RetroArch Core Selected"
+msgstr "لم تختر نواة رتروآرتش"
+
+#. The variable is a newline separated list of playlists
+#: cartridges/importer/retroarch_source.py:131
+msgid "The following playlists have no default core:"
+msgstr "ليس للقوائم التالية نواة مبدئية:"
+
+#: cartridges/importer/retroarch_source.py:133
+msgid "Games with no core selected were not imported"
+msgstr "لم نستورد الألعاب التي لم تختر لها أنويةً"
+
+#: cartridges/store/managers/sgdb_manager.py:46
+msgid "Couldn't Authenticate SteamGridDB"
+msgstr "تعذَّر استيثاق SteamGridDB"
+
+#: cartridges/store/managers/sgdb_manager.py:47
+msgid "Verify your API key in preferences"
+msgstr "أكِّد مفتاح واجهة البرمجة في التفضيلات"
+
+#~ msgid "Library"
+#~ msgstr "المكتبة"
+
+#~ msgid "Show preferences"
+#~ msgstr "أظهر التفضيلات"
+
+#~ msgid "Shortcuts"
+#~ msgstr "الاختصارات"
+
+#~ msgid "Open menu"
+#~ msgstr "افتح القائمة"
+
+#~ msgid "Add new game"
+#~ msgstr "أضف لعبةً جديدةً"
+
+#~ msgid "Import games"
+#~ msgstr "استورد ألعابًا"
+
+#~ msgid "Back"
+#~ msgstr "عد"
+
+#~ msgid "Search games"
+#~ msgstr "ابحث عن ألعاب"
+
+#~ msgid "Search hidden games"
+#~ msgstr "ابحث في الألعاب المخفية"
+
+#~ msgid "The title of the game"
+#~ msgstr "عنوان اللعبة"
+
+#~ msgid "Developer"
+#~ msgstr "المطوِّر"
+
+#~ msgid "File to open or command to run when launching the game"
+#~ msgstr "الملفُّ المفتوح أو الأمر المشغَّل عند بدء اللعبة"
+
+#~ msgid "Confirm"
+#~ msgstr "أكِّد"
+
+#, fuzzy
+#~| msgid "The Steam directory cannot be found."
+#~ msgid "Directory not Valid"
+#~ msgstr "تعذَّر العثور على مجلَّد ستيم."
+
+#, fuzzy
+#~| msgid "Confirm"
+#~ msgid "Configuration"
+#~ msgstr "أكِّد"
+
+#~ msgid "Steam Install Location"
+#~ msgstr "موضع تثبيت ستيم"
+
+#~ msgid "Lutris Install Location"
+#~ msgstr "موضع تثبيت لوترس"
+
+#~ msgid "Heroic Install Location"
+#~ msgstr "موضع تثبيت هِرُوِك"
+
+#~ msgid "Bottles Install Location"
+#~ msgstr "موضع تثبيت قوارير"
+
+#~ msgid "Today"
+#~ msgstr "اليوم"
+
+#~ msgid "Yesterday"
+#~ msgstr "أمس"
+
+#~ msgid "Cache Not Found"
+#~ msgstr "لم يُعثر على الذاكرة المؤقَّتة"
+
+#~ msgid "Select the Lutris cache directory."
+#~ msgstr "حدِّد مجلَّد ذاكرة لوترس المؤقَّتة."
+
+#~ msgid "Directory to use when importing games"
+#~ msgstr "المجلَّد المستخدم عند استيراد الألعاب"
+
+#~ msgid "Extra Steam Libraries"
+#~ msgstr "مكتبات ستيم الإضافية"
+
+#~ msgid "Select other directories where you have Steam games installed"
+#~ msgstr "حدِّد المجلَّدات الأخرى التي ثُبِّتت فيها ألعاب ستيم"
+
+#~ msgid "Clear"
+#~ msgstr "أمحُ"
+
+#~ msgid "Directory to use when importing game covers"
+#~ msgstr "المجلَّد المستخدم عند استيراد غُلُف الألعاب"
+
+#~ msgid "Details"
+#~ msgstr "التفاصيل"
+
+#~ msgid "No new games were found on your system."
+#~ msgstr "لم يُعثر على ألعاب جديدة في نظامك."
+
+#~ msgid "Successfully imported 1 game."
+#~ msgstr "اُستوردت لعبة بنجاح."
+
+#~ msgid "Successfully imported {} games."
+#~ msgstr "اُستوردت {} لعبة بنجاح."
+
+#~ msgid ""
+#~ "Looks like you have multiple Steam libraries. Would you like to add them "
+#~ "in preferences?"
+#~ msgstr "يبدو أن عندك أكثر من مكتبة ستيم. أتريد إضافتهم في التفضيلات؟"
+
+#~ msgid "Launch your games"
+#~ msgstr "شغِّل ألعابك"
+
+#, python-brace-format
+#~ msgid "Last played: {last_played_date}"
+#~ msgstr "لُعبت آخر مرَّة في: {last_played_date}"
+
+#, python-brace-format
+#~ msgid "Successfully imported {games_no} games."
+#~ msgstr "اُستوردت {games_no} لعبة بنجاح."
+
+#, python-brace-format
+#~ msgid "C:\\path\\to\\{file_name}"
+#~ msgstr "C:\\path\\to\\{file_name}"
+
+#, python-brace-format
+#~ msgid "/path/to/{file_name}"
+#~ msgstr "/path/to/{file_name}"
+
+#, fuzzy
+#~ msgctxt "shortcuts window"
+#~ msgid "General"
+#~ msgstr "عام"
+
+#, fuzzy
+#~ msgctxt "shortcuts window"
+#~ msgid "Search"
+#~ msgstr "ابحث"
+
+#, fuzzy
+#~ msgctxt "shortcuts window"
+#~ msgid "Undo"
+#~ msgstr "تراجع"
+
+#~ msgid "First stable release"
+#~ msgstr "أوَّل إصدار مستقرٍّ"
+
+#~ msgctxt "shortcut window"
+#~ msgid "General"
+#~ msgstr "عام"
+
+#~ msgctxt "shortcut window"
+#~ msgid "Search"
+#~ msgstr "ابحث"
+
+#~ msgctxt "shortcut window"
+#~ msgid "Undo"
+#~ msgstr "تراجع"
+
+#~ msgid "Couldn't Import Games"
+#~ msgstr "تعذَّر استيراد الألعاب"
+
+#~ msgid "The Bottles directory cannot be found."
+#~ msgstr "تعذَّر العثور على مجلَّد بوتلز."
+
+#~ msgid "Set Bottles Location"
+#~ msgstr "عيِّن موضع بوتلز"
+
+#~ msgid "No new games were found in the Bottles library."
+#~ msgstr "لم يُعثر على ألعاب جديدة في مكتبة بوتلز."
+
+#~ msgid "Bottles Games Imported"
+#~ msgstr "اُستوردت ألعاب بوتلز"
+
+#~ msgid "The Heroic directory cannot be found."
+#~ msgstr "تعذَّر العثور على مجلَّد هِرُوِك."
+
+#~ msgid "Heroic Games Imported"
+#~ msgstr "اُستوردت ألعاب هِرُوِك"
+
+#~ msgid "No new games were found in the Steam library."
+#~ msgstr "لم يُعثر على ألعاب جديدة في مكتبة ستيم."
+
+#~ msgid "Talking to Steam"
+#~ msgstr "يُتواصل مع ستيم"
+
+#~ msgid "Game Imported"
+#~ msgstr "اُستوردت اللعبة"
+
+#~ msgid "Games Imported"
+#~ msgstr "اُستوردت الألعاب"