v2.7

* Translated using Weblate (Turkish)

Currently translated at 100.0% (136 of 136 strings)

Co-authored-by: Hosted Weblate <hosted@weblate.org>
Co-authored-by: Sabri Ünal <libreajans@gmail.com>
Translate-URL: https://hosted.weblate.org/projects/cartridges/cartridges/tr/
Translation: Cartridges/Cartridges

* Translated using Weblate (Tamil)

Currently translated at 100.0% (136 of 136 strings)

Co-authored-by: K.B.Dharun Krishna <kbdharunkrishna@gmail.com>
Translate-URL: https://hosted.weblate.org/projects/cartridges/cartridges/ta/
Translation: Cartridges/Cartridges

* Translated using Weblate (French)

Currently translated at 100.0% (136 of 136 strings)

Co-authored-by: Hosted Weblate <hosted@weblate.org>
Co-authored-by: John Donne <akheron@zaclys.net>
Translate-URL: https://hosted.weblate.org/projects/cartridges/cartridges/fr/
Translation: Cartridges/Cartridges

* Translated using Weblate (Finnish)

Currently translated at 100.0% (136 of 136 strings)

Translated using Weblate (Finnish)

Currently translated at 100.0% (136 of 136 strings)

Translated using Weblate (Finnish)

Currently translated at 100.0% (136 of 136 strings)

Co-authored-by: Hosted Weblate <hosted@weblate.org>
Co-authored-by: Kimmo Kujansuu <mrkujansuu@gmail.com>
Translate-URL: https://hosted.weblate.org/projects/cartridges/cartridges/fi/
Translation: Cartridges/Cartridges

---------

Co-authored-by: Sabri Ünal <libreajans@gmail.com>
Co-authored-by: K.B.Dharun Krishna <kbdharunkrishna@gmail.com>
Co-authored-by: John Donne <akheron@zaclys.net>
Co-authored-by: Kimmo Kujansuu <mrkujansuu@gmail.com>

.github/FUNDING.yml

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

.github/ISSUE_TEMPLATE/bug_report.md

@@ -23,9 +23,13 @@ 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/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-44
+      options: --privileged
+    steps:
+    - name: Checkout
+      uses: actions/checkout@v3
+
+    - name: Flatpak Builder
+      uses: flatpak/flatpak-github-actions/flatpak-builder@v6.1
+      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@v3
+
+      - 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,19 +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-44
-      options: --privileged
-    steps:
-    - uses: actions/checkout@v3
-    - uses: flatpak/flatpak-github-actions/flatpak-builder@v6
-      with:
-        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@v3
+
+      - name: Download workflow artifact
+        uses: dawidd6/action-download-artifact@v2.27.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,33 +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-python-pip 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: |
-          pip install python-steamgriddb
-          meson setup _build
-          ninja -C _build install
-          pacman --noconfirm -Rs mingw-w64-ucrt-x86_64-python-pip 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: "Inno Setup"
-        run: iscc ".\.windows\Cartridges.iss"
-      - name: "Upload Artifact"
-        uses: actions/upload-artifact@v3
-        with:
-          name: "Installer"
-          path: ".windows/Output/Cartridges Setup.exe"

.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=_

CODE_OF_CONDUCT.md

@@ -1,128 +1,3 @@
-# Contributor Covenant Code of Conduct
+The project follows the [GNOME Code of Conduct](https://wiki.gnome.org/Foundation/CodeOfConduct).
 
-## Our Pledge
+If you believe that someone is violating the Code of Conduct, or have any other concerns, please contact us via [cartridges-community@kramo.hu](mailto:cartridges-community@kramo.hu).
-
-We as members, contributors, and leaders pledge to make participation in our
-community a harassment-free experience for everyone, regardless of age, body
-size, visible or invisible disability, ethnicity, sex characteristics, gender
-identity and expression, level of experience, education, socio-economic status,
-nationality, personal appearance, race, religion, or sexual identity
-and orientation.
-
-We pledge to act and interact in ways that contribute to an open, welcoming,
-diverse, inclusive, and healthy community.
-
-## Our Standards
-
-Examples of behavior that contributes to a positive environment for our
-community include:
-
-* Demonstrating empathy and kindness toward other people
-* Being respectful of differing opinions, viewpoints, and experiences
-* Giving and gracefully accepting constructive feedback
-* Accepting responsibility and apologizing to those affected by our mistakes,
-  and learning from the experience
-* Focusing on what is best not just for us as individuals, but for the
-  overall community
-
-Examples of unacceptable behavior include:
-
-* The use of sexualized language or imagery, and sexual attention or
-  advances of any kind
-* Trolling, insulting or derogatory comments, and personal or political attacks
-* Public or private harassment
-* Publishing others' private information, such as a physical or email
-  address, without their explicit permission
-* Other conduct which could reasonably be considered inappropriate in a
-  professional setting
-
-## Enforcement Responsibilities
-
-Community leaders are responsible for clarifying and enforcing our standards of
-acceptable behavior and will take appropriate and fair corrective action in
-response to any behavior that they deem inappropriate, threatening, offensive,
-or harmful.
-
-Community leaders have the right and responsibility to remove, edit, or reject
-comments, commits, code, wiki edits, issues, and other contributions that are
-not aligned to this Code of Conduct, and will communicate reasons for moderation
-decisions when appropriate.
-
-## Scope
-
-This Code of Conduct applies within all community spaces, and also applies when
-an individual is officially representing the community in public spaces.
-Examples of representing our community include using an official e-mail address,
-posting via an official social media account, or acting as an appointed
-representative at an online or offline event.
-
-## Enforcement
-
-Instances of abusive, harassing, or otherwise unacceptable behavior may be
-reported to the community leaders responsible for enforcement at
-cartridges-community@kramo.hu.
-All complaints will be reviewed and investigated promptly and fairly.
-
-All community leaders are obligated to respect the privacy and security of the
-reporter of any incident.
-
-## Enforcement Guidelines
-
-Community leaders will follow these Community Impact Guidelines in determining
-the consequences for any action they deem in violation of this Code of Conduct:
-
-### 1. Correction
-
-**Community Impact**: Use of inappropriate language or other behavior deemed
-unprofessional or unwelcome in the community.
-
-**Consequence**: A private, written warning from community leaders, providing
-clarity around the nature of the violation and an explanation of why the
-behavior was inappropriate. A public apology may be requested.
-
-### 2. Warning
-
-**Community Impact**: A violation through a single incident or series
-of actions.
-
-**Consequence**: A warning with consequences for continued behavior. No
-interaction with the people involved, including unsolicited interaction with
-those enforcing the Code of Conduct, for a specified period of time. This
-includes avoiding interactions in community spaces as well as external channels
-like social media. Violating these terms may lead to a temporary or
-permanent ban.
-
-### 3. Temporary Ban
-
-**Community Impact**: A serious violation of community standards, including
-sustained inappropriate behavior.
-
-**Consequence**: A temporary ban from any sort of interaction or public
-communication with the community for a specified period of time. No public or
-private interaction with the people involved, including unsolicited interaction
-with those enforcing the Code of Conduct, is allowed during this period.
-Violating these terms may lead to a permanent ban.
-
-### 4. Permanent Ban
-
-**Community Impact**: Demonstrating a pattern of violation of community
-standards, including sustained inappropriate behavior,  harassment of an
-individual, or aggression toward or disparagement of classes of individuals.
-
-**Consequence**: A permanent ban from any sort of public interaction within
-the community.
-
-## Attribution
-
-This Code of Conduct is adapted from the [Contributor Covenant][homepage],
-version 2.0, available at
-https://www.contributor-covenant.org/version/2/0/code_of_conduct.html.
-
-Community Impact Guidelines were inspired by [Mozilla's code of conduct
-enforcement ladder](https://github.com/mozilla/diversity).
-
-[homepage]: https://www.contributor-covenant.org
-
-For answers to common questions about this code of conduct, see the FAQ at
-https://www.contributor-covenant.org/faq. Translations are available at
-https://www.contributor-covenant.org/translations.

CONTRIBUTING.md

@@ -1,7 +1,14 @@
 # Contributing
 
 ## Code
-Fork the repository, make your changes, then create a pull request.
+
+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
@@ -17,14 +24,14 @@ The project can be translated on [Weblate](https://hosted.weblate.org/engage/car
 # Building
 
 ## GNOME Builder
-1. Install [GNOME Builder](https://flathub.org/apps/details/org.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/windows.yml).
+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
+3. Build it via Meson.
 
 ## Meson
 ```bash
@@ -33,3 +40,23 @@ 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 via the command line.

README.md

@@ -1,70 +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
+  # Cartridges
- A GTK4 + Libadwaita game launcher
 
-[![Flathub][flathub-image]][flathub-url]
+  A GTK4 + Libadwaita game launcher
-[![Build status][github-actions-image]][github-actions-url]
+
-[![Translation Status][weblate-image]][weblate-url]
+  [![GNOME Circle][circle-image]][circle-url]
-[![License][license-image]][license-url]
+  [![Translation Status][weblate-image]][weblate-url]
-[![Code style][code-style-image]][code-style-url]
+
-[![Discord Chatroom][discord-image]][discord-url]
+  [![Flathub][flathub-image]][flathub-url]
-  
+  [![Discord][discord-image]][discord-url]
-[github-actions-url]: https://github.com/kra-mo/cartridges
+  [![Matrix][matrix-image]][matrix-url]
-[github-actions-image]: https://github.com/kra-mo/cartridges/actions/workflows/flatpak-builder.yml/badge.svg
+  [![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/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
-[flathub-url]: https://flathub.org/apps/details/hu.kramo.Cartridges
-[flathub-image]: https://img.shields.io/flathub/v/hu.kramo.Cartridges
 
   <img src="data/screenshots/1.png">
 </div>
 
 # The Project
-Cartridges is a simple game launcher written in Python using GTK4 and Libadwaita.
-## Features
-- Manually adding and editing games
-- Importing games from Steam, Lutris Heroic, Bottles and itch
-- Support for multiple Steam install locations
-- Hiding games
-- Searching and sorting by title, date added and last played
-- Automatically downloading cover art from [SteamGridDB](https://www.steamgriddb.com/)
 
-For updates and questions, join our [Discord server][discord-url]!
+Cartridges is an easy-to-use, elegant game launcher written in Python using GTK4 and Libadwaita.
+
+## Features
+
+- Manually adding and editing games
+- Importing games from various sources:
+  - 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
+
+For updates and questions, join our [Discord server][discord-url] (bridged to [Matrix](https://matrix.to/#/#cartridges:matrix.org))!
+
+## Donations
+I accept donations through [GitHub Sponsors](https://github.com/sponsors/kra-mo).
+
+Thank you for your generosity! 💜
 
 # Installation
 
 ## Linux
 
-### Flathub (Recommended)
+### Flathub
 
-<a href=https://flathub.org/apps/details/hu.kramo.Cartridges><img width='240' alt='Download on Flathub' src='https://dl.flathub.org/assets/badges/flathub-badge-en.png'/></a>
+The app is available on Flathub.
 
-### From Releases
+<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>
-1. Download the latest release from [Releases](https://github.com/kra-mo/cartridges/releases).
-2. Install the downloaded file via GNOME Software or `flatpak install hu.kramo.Cartridges.flatpak`.
 
 ## Windows
 
 ### From Releases
+
 1. Download the latest release from [Releases](https://github.com/kra-mo/cartridges/releases).
 2. Run the downloaded installer.
 
 Note: Windows might present you with a warning when trying to install the app. This is expected, just ignore the warning.
 
+### Winget
+
+Install the latest release with the command: `winget install cartridges`. 
+
 ## Building manually
+
 See [Building](https://github.com/kra-mo/cartridges/blob/main/CONTRIBUTING.md#building).
 
 # Contributing
 
-See [CONTRIBUTING](https://github.com/kra-mo/cartridges/blob/main/CONTRIBUTING.md).
+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.hu" />
+      <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

@@ -19,11 +19,11 @@
 #
 # 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@"
 if os.name == "nt":
@@ -32,28 +32,26 @@ if os.name == "nt":
     os.environ["LANGUAGE"] = locale.windows_locale[
         windll.kernel32.GetUserDefaultUILanguage()
     ]
-    pkgdatadir = os.path.join(os.path.dirname(__file__), "..", "share", "cartridges")
+    PKGDATADIR = os.path.join(os.path.dirname(__file__), "..", "share", "cartridges")
-    localedir = os.path.join(os.path.dirname(__file__), "..", "share", "locale")
+    LOCALEDIR = os.path.join(os.path.dirname(__file__), "..", "share", "locale")
 else:
-    pkgdatadir = "@pkgdatadir@"
+    PKGDATADIR = "@pkgdatadir@"
-    localedir = "@localedir@"
+    LOCALEDIR = "@localedir@"
 
-sys.path.insert(1, pkgdatadir)
+sys.path.insert(1, PKGDATADIR)
 signal.signal(signal.SIGINT, signal.SIG_DFL)
 
 if os.name != "nt":
-    locale.bindtextdomain("cartridges", localedir)
+    locale.bindtextdomain("cartridges", LOCALEDIR)
     locale.textdomain("cartridges")
 
-gettext.install("cartridges", localedir)
+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 = Gio.Resource.load(os.path.join(PKGDATADIR, "cartridges.gresource"))
-    resource._register()
+    resource._register()  # pylint: disable=protected-access
 
     from cartridges import main
 

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.GError:
+            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.GError:
+            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.home / ".local" / "share" / "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.home / ".local" / "share",
+            "/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.GError:
+                    continue
+
+                try:
+                    try_exec = "which " + keyfile.get_string("Desktop Entry", "TryExec")
+                    if not self.check_command(try_exec):
+                        continue
+
+                except GLib.GError:
+                    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.GError:
+                    pass
+
+                try:
+                    if keyfile.get_boolean("Desktop Entry", "Hidden"):
+                        continue
+                except GLib.GError:
+                    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.GError:
+                    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.GError:
+                    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,152 @@
+# 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()
+        icon_theme.add_search_path(str(self.source.locations.system_data["icons"]))
+        icon_theme.add_search_path(str(self.source.locations.user_data["icons"]))
+
+        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",
+            }
+        )
+
+        for entry in chain(
+            (self.source.locations.system_data["applications"]).iterdir(),
+            (self.source.locations.user_data["applications"]).iterdir(),
+        ):
+            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.GError:
+                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.GError:
+                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,
+            ),
+            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,
+            ),
+        )

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.home / ".config"
+
+        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.home / ".config" / "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,424 @@
+# 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", self.pipeline_advanced_callback)
+                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.home / ".config" / "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.home / ".config" / "legendary",
+                ),
+                paths={
+                    "installed.json": LocationSubPath("installed.json"),
+                    "metadata": LocationSubPath("metadata", True),
+                },
+                invalid_subtitle=Location.CONFIG_INVALID_SUBTITLE,
+            )
+        )

cartridges/importer/location.py

@@ -0,0 +1,102 @@
+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):
+    pass
+
+
+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,
+    ) -> None:
+        super().__init__()
+        self.schema_key = schema_key
+        self.candidates = candidates
+        self.paths = paths
+        self.invalid_subtitle = invalid_subtitle
+
+    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()
+
+        # 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"""
+        self.resolve()
+        if self.root:
+            return self.root / self.paths[key].segment
+        return None

cartridges/importer/lutris_source.py

@@ -0,0 +1,132 @@
+# 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.config["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.cache["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):
+    config: Location
+    cache: Location
+
+
+class LutrisSource(URLExecutableSource):
+    """Generic Lutris source"""
+
+    source_id = "lutris"
+    name = _("Lutris")
+    iterable_class = LutrisSourceIterable
+    url_format = "lutris:rungameid/{game_id}"
+    available_on = {"linux"}
+
+    # FIXME possible bug: config picks ~/.var... and cache picks ~/.local...
+
+    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.home / ".local" / "share" / "lutris",
+                ),
+                paths={
+                    "pga.db": LocationSubPath("pga.db"),
+                },
+                invalid_subtitle=Location.DATA_INVALID_SUBTITLE,
+            ),
+            Location(
+                schema_key="lutris-cache-location",
+                candidates=(
+                    shared.flatpak_dir / "net.lutris.Lutris" / "cache" / "lutris",
+                    shared.cache_dir / "lutris",
+                    shared.home / ".cache" / "lutris",
+                ),
+                paths={
+                    "coverart": LocationSubPath("coverart", True),
+                },
+                invalid_subtitle=Location.CACHE_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.home / ".config" / "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,126 @@
+# 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
+
+# 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 locations are unresolvable
+        """
+        for location in self.locations:
+            location.resolve()
+        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"), GLib.Variant("s", "a-z")
+        )
+        sort_action.connect("activate", shared.win.on_sort_action)
+        shared.win.add_action(sort_action)
+        shared.win.on_sort_action(
+            sort_action, shared.state_schema.get_value("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.hu",
+                "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.hu",))
+        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,450 @@
+# 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_config_action_row = Gtk.Template.Child()
+    lutris_config_file_chooser_button = Gtk.Template.Child()
+    lutris_cache_action_row = Gtk.Template.Child()
+    lutris_cache_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.GError:
+                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,75 @@
+# 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
+
+import os
+from enum import IntEnum, auto
+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())
+config_dir = Path(GLib.get_user_config_dir())
+cache_dir = Path(GLib.get_user_cache_dir())
+flatpak_dir = home / ".var" / "app"
+
+games_dir = data_dir / "cartridges" / "games"
+covers_dir = data_dir / "cartridges" / "covers"
+
+appdata_dir = Path(os.getenv("appdata") or "C:\\Users\\Default\\AppData\\Roaming")
+local_appdata_dir = Path(
+    os.getenv("csidl_local_appdata") or "C:\\Users\\Default\\AppData\\Local"
+)
+programfiles32_dir = Path(os.getenv("programfiles(x86)") or "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,57 @@
+# 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 (SteamNotAGameError, SteamGameNotFoundError):
+            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

@@ -17,11 +17,19 @@
 #
 # SPDX-License-Identifier: GPL-3.0-or-later
 
-from gi.repository import Adw
+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:

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 @@
-# get_games.py
+# run_executable.py
 #
-# Copyright 2022-2023 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,23 +17,27 @@
 #
 # SPDX-License-Identifier: GPL-3.0-or-later
 
-import json
+import logging
+import os
+import subprocess
+from shlex import quote
+
+from cartridges import shared
 
 
-def get_games(parent_widget, game_ids=None):
+def run_executable(executable) -> None:
-    games_dir = parent_widget.data_dir / "cartridges" / "games"
+    args = (
-    games = {}
+        "flatpak-spawn --host /bin/sh -c " + quote(executable)  # Flatpak
+        if os.getenv("FLATPAK_ID") == shared.APP_ID
+        else executable  # Others
+    )
 
-    if not games_dir.exists():
+    logging.info("Launching `%s`", str(args))
-        return {}
+    # pylint: disable=consider-using-with
-
+    subprocess.Popen(
-    if game_ids:
+        args,
-        game_files = [games_dir / f"{game_id}.json" for game_id in game_ids]
+        cwd=shared.home,
-    else:
+        shell=True,
-        game_files = games_dir.iterdir()
+        start_new_session=True,
-
+        creationflags=subprocess.CREATE_NEW_PROCESS_GROUP if os.name == "nt" else 0,  # type: ignore
-    for game in game_files:
+    )
-        data = json.loads(game.read_text("utf-8"))
-        games[data["game_id"]] = data
-
-    return games

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.GError:
+            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 @@
-# save_game.py
+# sqlite.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
@@ -17,14 +18,20 @@
 #
 # SPDX-License-Identifier: GPL-3.0-or-later
 
-import json
+from glob import escape
+from pathlib import Path
+from shutil import copyfile
+
+from gi.repository import GLib
 
 
-def save_game(parent_widget, game):
+def copy_db(original_path: Path) -> Path:
-    games_dir = parent_widget.data_dir / "cartridges" / "games"
+    """
-
+    Copy a sqlite database to a cache dir and return its new path.
-    games_dir.mkdir(parents=True, exist_ok=True)
+    The caller in in charge of deleting the returned path's parent dir.
-
+    """
-    (games_dir / f'{game["game_id"]}.json').write_text(
+    tmp = Path(GLib.Dir.make_tmp())
-        json.dumps(game, indent=4, sort_keys=True), "utf-8"
+    for file in original_path.parent.glob(f"{escape(original_path.name)}*"):
-    )
+        copy = tmp / file.name
+        copyfile(str(file), str(copy))
+    return tmp / original_path.name

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 = "a-z"
+    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,115 +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;
-    Box {
+    unit: px;
-      orientation: vertical;
+
+    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;
-        Picture cover {
+
-          width-request: 200;
+        accessibility {
-          height-request: 300;
+          labelled-by: title;
-          hexpand: true;
-          vexpand: true;
         }
 
-        styles [
+        Box {
-          "card",
+          orientation: vertical;
-          "flat",
-        ]
-      }
-      Overlay overlay {
-        [overlay]
-        Revealer play_revealer {
-          reveal-child: false;
-          transition-type: crossfade;
-          Box {
-            Button button_play {
-              halign: start;
-              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;
-              hexpand: true;
-              halign: end;
 
-              styles [
+          Overlay {
-                "flat",
+            [overlay]
-              ]
+            Spinner spinner {
+              margin-start: 72;
+              margin-end: 72;
+            }
+
+            Picture cover {
+              width-request: 200;
+              height-request: 300;
+              hexpand: true;
+              vexpand: true;
             }
           }
-        }
+
-        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",
+        ]
       }
     }
   }
-
-  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

@@ -10,23 +10,18 @@ ShortcutsWindow help_overlay {
     ShortcutsGroup {
       title: _("General");
 
-      ShortcutsShortcut {
-        title: _("Quit");
-        action-name: "app.quit";
-      }
-
       ShortcutsShortcut {
         title: _("Search");
         action-name: "win.toggle_search";
       }
 
       ShortcutsShortcut {
-        title: _("Show preferences");
+        title: _("Preferences");
         action-name: "app.preferences";
       }
 
       ShortcutsShortcut {
-        title: _("Shortcuts");
+        title: _("Keyboard Shortcuts");
         action-name: "win.show-help-overlay";
       }
 
@@ -36,7 +31,17 @@ ShortcutsWindow help_overlay {
       }
 
       ShortcutsShortcut {
-        title: _("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";
       }
     }
@@ -45,23 +50,23 @@ ShortcutsWindow help_overlay {
       title: _("Games");
 
       ShortcutsShortcut {
-        title: _("Add new game");
+        title: _("Add Game");
         action-name: "app.add_game";
       }
 
       ShortcutsShortcut {
-        title: _("Import games");
+        title: _("Import");
         action-name: "app.import";
       }
 
       ShortcutsShortcut {
-        title: _("Show hidden games");
+        title: _("Show Hidden Games");
         action-name: "win.show_hidden";
       }
 
       ShortcutsShortcut {
-        title: _("Remove game");
+        title: _("Remove Game");
-        action-name: "app.remove_game_overview";
+        action-name: "app.remove_game_details_view";
       }
     }
   }

data/gtk/preferences.blp

@@ -1,8 +1,7 @@
 using Gtk 4.0;
 using Adw 1;
 
-template PreferencesWindow : Adw.PreferencesWindow {
+template $PreferencesWindow : Adw.PreferencesWindow {
-  default-height: 500;
 
   Adw.PreferencesPage general_page {
     name: "general";
@@ -12,51 +11,98 @@ template PreferencesWindow : Adw.PreferencesWindow {
     Adw.PreferencesGroup behavior_group {
       title: _("Behavior");
 
-      Adw.ActionRow {
+      Adw.SwitchRow exit_after_launch_switch {
         title: _("Exit After Launching Games");
-
-        Switch exit_after_launch_switch {
-          valign: center;
-        }
       }
 
-      Adw.ActionRow {
+      Adw.SwitchRow cover_launches_game_switch {
         title: _("Cover Image Launches Game");
         subtitle: _("Swaps the behavior of the cover image and the play button");
-
-        Switch cover_launches_game_switch {
-          valign: center;
-        }
       }
     }
 
     Adw.PreferencesGroup images_group {
       title: _("Images");
 
-      Adw.ActionRow {
+      Adw.SwitchRow high_quality_images_switch {
         title: _("High Quality Images");
         subtitle: _("Save game covers losslessly at the cost of storage");
-
-        Switch high_quality_images_switch {
-          valign: center;
-        }
       }
     }
 
     Adw.PreferencesGroup danger_zone_group {
       title: _("Danger Zone");
 
-      Adw.ActionRow {
+      ListBox remove_all_games_list_box {
-        title: _("Remove All Games");
+        Adw.PreferencesRow {
+        activatable: true;
+        selectable: false;
 
-        Button remove_all_games_button {
+        Box {
-          label: _("Remove");
+          spacing: 6;
           valign: center;
+          halign: center;
+
+          Label {
+            label: _("Remove All Games");
+            ellipsize: end;
+
+            styles [
+              "heading",
+            ]
+          }
 
           styles [
-            "destructive-action",
+            "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",
+        ]
       }
     }
   }
@@ -66,6 +112,14 @@ template PreferencesWindow : Adw.PreferencesWindow {
     title: _("Import");
     icon-name: "document-save-symbolic";
 
+    Adw.PreferencesGroup import_behavior_group {
+      title: _("Behavior");
+
+      Adw.SwitchRow remove_missing_switch {
+        title: _("Remove Uninstalled Games");
+      }
+    }
+
     Adw.PreferencesGroup sources_group {
       title: _("Sources");
 
@@ -73,37 +127,20 @@ template PreferencesWindow : Adw.PreferencesWindow {
         title: _("Steam");
         show-enable-switch: true;
 
-        Adw.ActionRow {
+        [prefix]
-          title: _("Steam Install Location");
+        Image {
-          subtitle: _("Directory to use when importing games");
+          icon-name: "steam-source-symbolic";
+        }
 
-          Button steam_file_chooser_button {
+        Adw.ActionRow steam_data_action_row {
+          title: _("Install Location");
+
+          Button steam_data_file_chooser_button {
             icon-name: "folder-symbolic";
             valign: center;
-          }
+            styles [
-        }
+              "flat"
-        Adw.ActionRow {
+            ]
-          title: _("Extra Steam Libraries");
-          subtitle: _("Select other directories where you have Steam games installed");
-
-
-          Revealer steam_clear_button_revealer {
-            reveal-child: false;
-            transition-type: slide_left;
-            Button steam_clear_button {
-              label: _("Clear");
-              valign: center;
-              halign: end;
-
-              styles [
-                "destructive-action",
-              ]
-            }
-          }
-
-          Button steam_extra_file_chooser_button {
-            icon-name: "folder-new-symbolic";
-            valign: center;
           }
         }
       }
@@ -112,32 +149,41 @@ template PreferencesWindow : Adw.PreferencesWindow {
         title: _("Lutris");
         show-enable-switch: true;
 
-        Adw.ActionRow {
+        [prefix]
-          title: _("Lutris Install Location");
+        Image {
-          subtitle: _("Directory to use when importing games");
+          icon-name: "lutris-source-symbolic";
+        }
 
-          Button lutris_file_chooser_button {
+        Adw.ActionRow lutris_config_action_row {
+          title: _("Install Location");
+
+          Button lutris_config_file_chooser_button {
             icon-name: "folder-symbolic";
             valign: center;
+            styles [
+              "flat"
+            ]
           }
         }
 
-        Adw.ActionRow {
+        Adw.ActionRow lutris_cache_action_row {
-          title: _("Lutris Cache Location");
+          title: _("Cache Location");
-          subtitle: _("Directory to use when importing game covers");
 
           Button lutris_cache_file_chooser_button {
             icon-name: "folder-symbolic";
             valign: center;
+            styles [
+              "flat"
+            ]
           }
         }
 
-        Adw.ActionRow {
+        Adw.SwitchRow lutris_import_steam_switch {
           title: _("Import Steam Games");
+        }
 
-          Switch lutris_steam_switch {
+        Adw.SwitchRow lutris_import_flatpak_switch {
-            valign: center;
+          title: _("Import Flatpak Games");
-          }
         }
       }
 
@@ -145,38 +191,37 @@ template PreferencesWindow : Adw.PreferencesWindow {
         title: _("Heroic");
         show-enable-switch: true;
 
-        Adw.ActionRow {
+        [prefix]
-          title: _("Heroic Install Location");
+        Image {
-          subtitle: _("Directory to use when importing games");
+          icon-name: "heroic-source-symbolic";
+        }
 
-          Button heroic_file_chooser_button {
+        Adw.ActionRow heroic_config_action_row {
+          title: _("Install Location");
+
+          Button heroic_config_file_chooser_button {
             icon-name: "folder-symbolic";
             valign: center;
+            styles [
+              "flat"
+            ]
           }
         }
 
-        Adw.ActionRow {
+        Adw.SwitchRow heroic_import_epic_switch {
           title: _("Import Epic Games");
-
-          Switch heroic_epic_switch {
-            valign: center;
-          }
         }
 
-        Adw.ActionRow {
+        Adw.SwitchRow heroic_import_gog_switch {
           title: _("Import GOG Games");
-
-          Switch heroic_gog_switch {
-            valign: center;
-          }
         }
 
-        Adw.ActionRow {
+        Adw.SwitchRow heroic_import_amazon_switch  {
-          title: _("Import Sideloaded Games");
+          title: _("Import Amazon Games");
+        }
 
-          Switch heroic_sideloaded_switch {
+        Adw.SwitchRow heroic_import_sideload_switch {
-            valign: center;
+          title: _("Import Sideloaded Games");
-          }
         }
       }
 
@@ -184,13 +229,20 @@ template PreferencesWindow : Adw.PreferencesWindow {
         title: _("Bottles");
         show-enable-switch: true;
 
-        Adw.ActionRow {
+        [prefix]
-          title: _("Bottles Install Location");
+        Image {
-          subtitle: _("Directory to use when importing games");
+          icon-name: "bottles-source-symbolic";
+        }
 
-          Button bottles_file_chooser_button {
+        Adw.ActionRow bottles_data_action_row {
+          title: _("Install Location");
+
+          Button bottles_data_file_chooser_button {
             icon-name: "folder-symbolic";
             valign: center;
+            styles [
+              "flat"
+            ]
           }
         }
       }
@@ -199,16 +251,116 @@ template PreferencesWindow : Adw.PreferencesWindow {
         title: _("itch");
         show-enable-switch: true;
 
-        Adw.ActionRow {
+        [prefix]
-          title: _("itch Install Location");
+        Image {
-          subtitle: _("Directory to use when importing games");
+          icon-name: "itch-source-symbolic";
+        }
 
-          Button itch_file_chooser_button {
+        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";
+        }
+      }
     }
   }
 
@@ -219,7 +371,7 @@ template PreferencesWindow : Adw.PreferencesWindow {
 
     Adw.PreferencesGroup sgdb_key_group {
       title: _("Authentication");
-      
+
       Adw.EntryRow sgdb_key_entry_row {
         title: _("API Key");
       }
@@ -228,19 +380,34 @@ template PreferencesWindow : Adw.PreferencesWindow {
     Adw.PreferencesGroup sgdb_behavior_group {
       title: _("Behavior");
 
-      Adw.ActionRow {
+      Adw.SwitchRow sgdb_switch {
         title: _("Use SteamGridDB");
         subtitle: _("Download images when adding or importing games");
-
-        Switch sgdb_download_switch {
-          valign: center;
-        }
       }
-      Adw.ActionRow {
-        title: _("Prefer Over Official Images");
 
-        Switch sgdb_prefer_switch {
+      Adw.SwitchRow sgdb_prefer_switch {
-          valign: center;
+        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 hidden_notice_no_results {
+  icon-name: "system-search-symbolic";
+  title: _("No Games Found");
+  description: _("Try a different search.");
+  vexpand: true;
+  valign: center;
+}
+
 Adw.StatusPage notice_empty {
-  icon-name: "applications-games-symbolic";
   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,300 +43,428 @@ Adw.StatusPage hidden_notice_empty {
   valign: center;
 }
 
-template CartridgesWindow : Adw.ApplicationWindow {
+template $CartridgesWindow : Adw.ApplicationWindow {
   title: _("Cartridges");
+  width-request: 281;
+  height-request: 100;
+
+  Adw.Breakpoint {
+    condition ("max-width: 564px")
+    setters {
+      overlay_split_view.collapsed: true;
+      details_view_box.orientation: vertical;
+      details_view_box.margin-top: 12;
+      details_view_box.margin-start: 12;
+      details_view_box.margin-end: 12;
+      details_view_details_box.margin-start: 0;
+      details_view_details_box.margin-end: 0;
+      details_view_title.margin-top: 30;
+      details_view_title.halign: center;
+      details_view_developer.halign: center;
+      details_view_date_box.halign: center;
+      details_view_toolbar.halign: center;
+      details_view_toolbar.orientation: vertical;
+      details_view_play_button.halign: center;
+      details_view_toolbar_buttons.margin-start: 0;
+    }
+  }
 
   Adw.ToastOverlay toast_overlay {
-    Stack stack {
+    Adw.NavigationView navigation_view {
-      visible-child: library_view;
+        Adw.NavigationPage library_page {
-      transition-type: over_left;
+          title: _("All Games");
 
-      Overlay overview {
+          Adw.OverlaySplitView overlay_split_view {
-        [overlay]
+            [sidebar]
-        Box overview_box {
+            Adw.NavigationPage {
-          orientation: vertical;
+              title: _("Cartridges");
-
+              Adw.ToolbarView {
-          Adw.HeaderBar {
+                [top]
-            [start]
+                Adw.HeaderBar {
-            Button back_button {
+                  [start]
-              tooltip-text: _("Back");
+                  Button {
-              action-name: "win.go_back";
+                    icon-name: "sidebar-show-symbolic";
-              icon-name: "go-previous-symbolic";
+                    action-name: "win.show_sidebar";
-            }
+                    tooltip-text: _("Toggle Sidebar");
-
-            [title]
-            Adw.WindowTitle overview_header_bar_title {
-              title: _("Game Details");
-            }
-
-            styles [
-              "flat",
-            ]
-          }
-
-          Adw.Bin {
-            hexpand: true;
-            vexpand: true;
-
-            Box {
-              halign: center;
-              valign: center;
-              margin-start: 24;
-              margin-end: 24;
-              margin-top: 24;
-              margin-bottom: 24;
-
-              Adw.Clamp {
-                maximum-size: 200;
-                Overlay {
-                  [overlay]
-                  Spinner overview_spinner {
-                    margin-start: 72;
-                    margin-end: 72;
                   }
+                }
 
-                  Picture overview_cover {
+                ScrolledWindow {
-                    halign: end;
+                  ListBox sidebar {
-                    valign: start;
+                    Box all_games_row_box {
-                    width-request: 200;
+                      margin-top: 12;
-                    height-request: 300;
+                      margin-bottom: 12;
+                      margin-start: 6;
+                      margin-end: 6;
+                      spacing: 12;
 
-                    styles [
+                      Image {
-                      "card",
+                        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"]
                   }
                 }
               }
+            }
 
-              Box {
+            Adw.ToolbarView library_view {
-                orientation: vertical;
-                margin-start: 48;
-                vexpand: true;
-                valign: center;
 
-                Label overview_title {
+              [top]
-                  label: _("Game Title");
+              Adw.HeaderBar header_bar {
-                  hexpand: true;
-                  halign: start;
-                  wrap: true;
-                  wrap-mode: word_char;
-                  natural-wrap-mode: word;
 
-                  styles [
+                [start]
-                    "title-1",
+                Revealer {
-                  ]
+                  transition-type: slide_right;
-                }
+                  reveal-child: bind overlay_split_view.show-sidebar inverted;
-
+                  Button show_sidebar_button {
-                Label overview_developer {
+                    icon-name: "sidebar-show-symbolic";
-                  margin-top: 3;
+                    action-name: "win.show_sidebar";
-                  hexpand: true;
+                    tooltip-text: _("Toggle Sidebar");
-                  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;
-                  wrap: true;
-                  wrap-mode: word_char;
-                  natural-wrap-mode: word;
-
-                  styles [
-                    "dim-label",
-                  ]
-                }
-                Box {
-                  hexpand: true;
-                  vexpand: true;
-                  valign: center;
-
-                  Button overview_launch {
-                    action-name: "app.launch_game";
-                    label: _("Play");
-                    halign: start;
-                    margin-top: 24;
-
-                    styles [
-                      "suggested-action",
-                      "pill",
-                    ]
                   }
+                }
 
-                  MenuButton overview_menu_button {
+                [start]
-                    icon-name: "view-more-symbolic";
+                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;
-                    vexpand: true;
+                  }
-                    halign: start;
+                }
-                    valign: center;
+              }
-                    margin-top: 24;
-                    margin-start: 6;
 
-                    styles [
+              Overlay library_overlay {
-                      "circular",
+                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;
                   }
                 }
               }
             }
           }
         }
+      }
+    }
+  }
 
-        styles [
+Adw.NavigationPage hidden_library_page {
-          "background",
+  title: _("Hidden Games");
-        ]
 
-        Picture overview_blurred_cover {
+  Adw.ToolbarView hidden_library_view {
-          opacity: 0.2;
+    [top]
-          can-shrink: true;
+    Adw.HeaderBar hidden_header_bar {
-          keep-aspect-ratio: false;
+      [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;
-          vexpand: true;
         }
       }
+    }
 
-      Box library_view {
+    Overlay hidden_library_overlay {
-        orientation: vertical;
+      ScrolledWindow hidden_scrolledwindow {
-
+        FlowBox hidden_library {
-        Adw.HeaderBar header_bar {
+          homogeneous: true;
-          [start]
+          halign: center;
-          MenuButton {
+          valign: start;
-            tooltip-text: _("Add Game");
+          column-spacing: 12;
-            icon-name: "list-add-symbolic";
+          row-spacing: 12;
-            menu-model: add_games;
+          margin-top: 15;
-          }
+          margin-bottom: 15;
-
+          margin-start: 15;
-          [end]
+          margin-end: 15;
-          MenuButton primary_menu_button {
+          selection-mode: none;
-            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";
-          }
         }
+      }
+    }
+
+    styles [
+      "background",
+    ]
+  }
+}
+
+Adw.NavigationPage details_page {
+  title: _("Game Details");
+
+  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;
+          margin-end: 24;
+          margin-top: 24;
+          margin-bottom: 24;
 
-        SearchBar search_bar {
           Adw.Clamp {
-            maximum-size: 500;
+            maximum-size: 200;
-            tightening-threshold: 500;
 
-            SearchEntry search_entry {
+            Overlay {
-              hexpand: true;
+              [overlay]
+              Spinner details_view_spinner {
+                margin-start: 72;
+                margin-end: 72;
+              }
+
+              Picture details_view_cover {
+                halign: end;
+                valign: start;
+                width-request: 200;
+                height-request: 300;
+
+                styles [
+                  "card",
+                ]
+              }
             }
           }
-        }
 
-        Adw.Bin library_bin {
+          Box details_view_details_box {
-          ScrolledWindow scrolledwindow {
+            orientation: vertical;
-            hexpand: true;
+            margin-start: 48;
             vexpand: true;
+            valign: center;
 
-            FlowBox library {
+            Label details_view_title {
-              homogeneous: true;
+              label: _("Game Title");
-              halign: center;
+              hexpand: true;
-              valign: start;
+              halign: start;
-              column-spacing: 12;
+              max-width-chars: 24;
-              row-spacing: 12;
+              wrap: true;
-              margin-top: 16;
+              wrap-mode: word_char;
-              margin-bottom: 16;
+              natural-wrap-mode: word;
-              margin-start: 16;
+
-              margin-end: 16;
+              styles [
-              selection-mode: none;
+                "title-1",
+              ]
+            }
+
+            Label details_view_developer {
+              margin-top: 6;
+              hexpand: true;
+              halign: start;
+              max-width-chars: 36;
+              wrap: true;
+              wrap-mode: word_char;
+              natural-wrap-mode: word;
+
+              styles [
+                "heading",
+              ]
+            }
+
+            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 details_view_play_button {
+                name: "details_view_play_button";
+                action-name: "app.launch_game";
+                label: _("Play");
+                halign: start;
+                margin-top: 24;
+
+                styles [
+                  "opaque",
+                  "pill",
+                ]
+              }
+
+              Box details_view_toolbar_buttons {
+                halign: start;
+                valign: center;
+                margin-top: 24;
+                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 [
+                  "toolbar",
+                ]
+              }
             }
           }
         }
       }
+    }
 
-      Box hidden_library_view {
+    Picture details_view_blurred_cover {
-        orientation: vertical;
+      keep-aspect-ratio: false;
-
-        Adw.HeaderBar hidden_header_bar {
-          [start]
-          Button hidden_back_button {
-            tooltip-text: _("Back");
-            action-name: "win.go_back";
-            icon-name: "go-previous-symbolic";
-          }
-
-          [title]
-          Adw.WindowTitle {
-            title: _("Hidden Games");
-          }
-
-          [end]
-          MenuButton {
-            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";
-          }
-        }
-
-        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",
-        ]
-      }
     }
   }
 }
@@ -367,34 +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 {
-    item {
+    item (_("Import"), "app.import")
-      label: _("Import");
+  }
-      action: "app.import";
+}
-    }
+
+menu search {
+  section {
+    label: "Search on…";
+
+    item (_("IGDB"), "app.igdb_search")
+    item (_("SteamGridDB"), "app.sgdb_search")
+    item (_("ProtonDB"), "app.protondb_search")
+    item (_("Lutris"), "app.lutris_search")
+    item (_("HowLongToBeat"), "app.hltb_search")
   }
 }

data/hu.kramo.Cartridges.desktop.in

@@ -3,8 +3,9 @@ Name=Cartridges
 GenericName=Game Launcher
 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,95 +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="cover-launches-game" type="b">
-      <default>false</default>
-    </key>
-    <key name="high-quality-images" type="b">
-      <default>false</default>
-    </key>
-    <key name="steam" type="b">
-      <default>true</default>
-    </key>
-    <key name="steam-location" type="s">
-      <default>"~/.steam/"</default>
-    </key>
-    <key name="steam-extra-dirs" type="as">
-      <default>[]</default>
-    </key>
-    <key name="steam-extra-dirs-hint" type="b">
-      <default>true</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="heroic" type="b">
-      <default>true</default>
-    </key>
-    <key name="heroic-location" type="s">
-      <default>"~/.var/app/com.heroicgameslauncher.hgl/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-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="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>
-	</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>"a-z"</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,6 +1,6 @@
 <?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>
@@ -15,19 +15,29 @@
   <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 translatable="no">kramo</developer_name>
-  <launchable type="desktop-id">hu.kramo.Cartridges.desktop</launchable>
+  <project_group>GNOME</project_group>
+  <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>Library</caption>
+      <caption>Cartridges</caption>
     </screenshot>
     <screenshot>
       <image>https://raw.githubusercontent.com/kra-mo/cartridges/main/data/screenshots/2.png</image>
-      <caption>Edit Game Details</caption>
+      <caption>Game Details</caption>
     </screenshot>
     <screenshot>
       <image>https://raw.githubusercontent.com/kra-mo/cartridges/main/data/screenshots/3.png</image>
-      <caption>Game Details</caption>
+      <caption>Edit Game Details</caption>
     </screenshot>
     <screenshot>
       <image>https://raw.githubusercontent.com/kra-mo/cartridges/main/data/screenshots/4.png</image>
@@ -36,6 +46,103 @@
   </screenshots>
   <content_rating type="oars-1.1" />
   <releases>
+    <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>

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: 'hu.kramo.Cartridges.desktop.in',
+        input: configure_file(
-       output: 'hu.kramo.Cartridges.desktop',
+          input: 'hu.kramo.Cartridges.desktop.in',
+          output: app_id + '.desktop.in',
+          configuration: conf
+        ),
+       output: app_id + '.desktop',
          type: 'desktop',
        po_dir: '../po',
       install: true,
@@ -32,19 +41,28 @@ if desktop_utils.found()
 endif
 
 appstream_file = i18n.merge_file(
-        input: 'hu.kramo.Cartridges.metainfo.xml.in',
+        input: configure_file(
-       output: 'hu.kramo.Cartridges.metainfo.xml',
+          input: 'hu.kramo.Cartridges.metainfo.xml.in',
+          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', appstream_file])
 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,137 @@
+{
+    "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",
+            "config-opts": [
+                "-Dprofile=development"
+            ],
+            "sources" : [
+                {
+                    "type" : "dir",
+                    "path" : ".."
+                }
+            ]
+        }
+    ]
+}

hu.kramo.Cartridges.json

@@ -1,117 +0,0 @@
-{
-    "id" : "hu.kramo.Cartridges",
-    "runtime" : "org.gnome.Platform",
-    "runtime-version" : "44",
-    "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=~/.steam/steam/:ro",
-        "--filesystem=xdg-data/lutris/:ro",
-        "--filesystem=xdg-cache/lutris/:ro",
-        "--filesystem=xdg-config/heroic/:ro",
-        "--filesystem=xdg-data/bottles/:ro",
-        "--filesystem=xdg-config/itch/:ro",
-        "--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.usebottles.bottles/data/bottles/:ro",
-        "--filesystem=~/.var/app/io.itch.itch/config/itch/:ro"
-    ],
-    "cleanup" : [
-        "/include",
-        "/lib/pkgconfig",
-        "/man",
-        "/share/doc",
-        "/share/gtk-doc",
-        "/share/man",
-        "/share/pkgconfig",
-        "*.la",
-        "*.a"
-    ],
-    "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-python-steamgriddb",
-            "buildsystem": "simple",
-            "build-commands": [
-                "pip3 install --verbose --exists-action=i --no-index --find-links=\"file://${PWD}\" --prefix=${FLATPAK_DEST} \"python-steamgriddb\" --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/d6/90/a84d927799ca177d4f7a111f99fee0a3f19da63e42c3b325c9c1bfe3bba0/python-steamgriddb-1.0.5.tar.gz",
-                    "sha256": "036db7bb09865da73b40b68cf04fb9675cd18b4908275092d91f37bf16245069"
-                },
-                {
-                    "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" : "blueprint-compiler",
-            "buildsystem" : "meson",
-            "sources" : [
-                {
-                    "type" : "git",
-                    "url" : "https://gitlab.gnome.org/jwestman/blueprint-compiler",
-                    "tag" : "v0.6.0"
-                }
-            ],
-            "cleanup" : [
-                "*"
-            ]
-        },
-        {
-            "name" : "cartridges",
-            "builddir" : true,
-            "buildsystem" : "meson",
-            "sources" : [
-                {
-                    "type" : "dir",
-                    "path" : "."
-                }
-            ]
-        }
-    ]
-}

meson.build

@@ -1,18 +1,50 @@
 project('cartridges',
-          version: '1.3',
+          version: '2.7',
     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

@@ -13,3 +13,13 @@ ru
 ko
 de
 ro
+pt_BR
+fa
+pl
+sv
+tr
+el
+cs
+zh_Hans
+be
+hr

po/POTFILES

@@ -1,20 +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/importer.py
+cartridges/utils/create_dialog.py
-src/utils/bottles_parser.py
+
-src/utils/create_details_window.py
+cartridges/importer/importer.py
-src/utils/create_dialog.py
+cartridges/importer/source.py
-src/utils/heroic_parser.py
+cartridges/importer/location.py
-src/utils/steam_parser.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/be.po

@@ -0,0 +1,642 @@
+# SOME DESCRIPTIVE TITLE.
+# Copyright (C) YEAR kramo
+# This file is distributed under the same license as the Cartridges package.
+# Yahor <k1llo2810@gmail.com>, 2023.
+# Yahor <g_egor98@tut.by>, 2023.
+# Yahor <k1llo2810@protonmail.com>, 2023.
+msgid ""
+msgstr ""
+"Project-Id-Version: Cartridges\n"
+"Report-Msgid-Bugs-To: \n"
+"POT-Creation-Date: 2023-11-17 17:08+0100\n"
+"PO-Revision-Date: 2023-11-18 20:09+0000\n"
+"Last-Translator: Yahor <k1llo2810@protonmail.com>\n"
+"Language-Team: Belarusian <https://hosted.weblate.org/projects/cartridges/"
+"cartridges/be/>\n"
+"Language: be\n"
+"MIME-Version: 1.0\n"
+"Content-Type: text/plain; charset=UTF-8\n"
+"Content-Transfer-Encoding: 8bit\n"
+"Plural-Forms: nplurals=3; plural=n%10==1 && n%100!=11 ? 0 : n%10>=2 && "
+"n%10<=4 && (n%100<10 || n%100>=20) ? 1 : 2;\n"
+"X-Generator: Weblate 5.2\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 ""
+"гульні;праграма запуску;steam;lutris;heroic;bottles;itch;flatpak;legendary;"
+"retroarch;"
+
+#: 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 ""
+"Картрыджы - гэта простая праграма для запуску ўсіх вашых гульняў. Яна "
+"падтрымлівае імпарт гульняў з Steam, Lutris, Heroic і іншых без неабходнасці "
+"ўваходу ў сістэму. Вы можаце сартаваць і хаваць гульні або спампоўваць "
+"вокладку з 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:127 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:367
+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 "Steam"
+
+#: 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 data/gtk/preferences.blp:326
+msgid "Install Location"
+msgstr "Месца ўсталёўкі"
+
+#: data/gtk/preferences.blp:149 data/gtk/window.blp:539
+#: cartridges/importer/lutris_source.py:92
+msgid "Lutris"
+msgstr "Lutris"
+
+#: data/gtk/preferences.blp:170
+msgid "Cache Location"
+msgstr "Размяшчэнне кэша"
+
+#: data/gtk/preferences.blp:182
+msgid "Import Steam Games"
+msgstr "Імпарт гульняў Steam"
+
+#: data/gtk/preferences.blp:186
+msgid "Import Flatpak Games"
+msgstr "Імпарт гульняў Flatpak"
+
+#: data/gtk/preferences.blp:191 cartridges/importer/heroic_source.py:355
+msgid "Heroic"
+msgstr "Heroic"
+
+#: data/gtk/preferences.blp:212
+msgid "Import Epic Games"
+msgstr "Імпарт Epic Games"
+
+#: data/gtk/preferences.blp:216
+msgid "Import GOG Games"
+msgstr "Імпарт гульняў GOG"
+
+#: data/gtk/preferences.blp:220
+msgid "Import Amazon Games"
+msgstr "Імпарт гульняў Amazon"
+
+#: data/gtk/preferences.blp:224
+msgid "Import Sideloaded Games"
+msgstr "Імпарт іншых гульняў"
+
+#: data/gtk/preferences.blp:229 cartridges/importer/bottles_source.py:86
+msgid "Bottles"
+msgstr "Bottles"
+
+#: data/gtk/preferences.blp:251 cartridges/importer/itch_source.py:81
+msgid "itch"
+msgstr "itch"
+
+#: data/gtk/preferences.blp:273 cartridges/importer/legendary_source.py:97
+msgid "Legendary"
+msgstr "Legendary"
+
+#: data/gtk/preferences.blp:295 cartridges/importer/retroarch_source.py:142
+msgid "RetroArch"
+msgstr "RetroArch"
+
+#: data/gtk/preferences.blp:317 cartridges/importer/flatpak_source.py:118
+msgid "Flatpak"
+msgstr "Flatpak"
+
+#: data/gtk/preferences.blp:338
+msgid "Import Game Launchers"
+msgstr "Імпарт сродкаў запуску гульняў"
+
+#: data/gtk/preferences.blp:343 cartridges/importer/desktop_source.py:215
+msgid "Desktop Entries"
+msgstr "Запісы працоўнага стала"
+
+#: data/gtk/preferences.blp:355 data/gtk/window.blp:537
+msgid "SteamGridDB"
+msgstr "SteamGridDB"
+
+#: data/gtk/preferences.blp:359
+msgid "Authentication"
+msgstr "Аўтэнтыфікацыя"
+
+#: data/gtk/preferences.blp:362
+msgid "API Key"
+msgstr "Ключ API"
+
+#: data/gtk/preferences.blp:370
+msgid "Use SteamGridDB"
+msgstr "Выкарыстоўвайць SteamGridDB"
+
+#: data/gtk/preferences.blp:371
+msgid "Download images when adding or importing games"
+msgstr "Спампоўка відарысаў пры даданні ці імпарце гульняў"
+
+#: data/gtk/preferences.blp:375
+msgid "Prefer Over Official Images"
+msgstr "Аддавайце перавагу афіцыйным відарысам"
+
+#: data/gtk/preferences.blp:379
+msgid "Prefer Animated Images"
+msgstr "Аддавайце перавагу аніміраваным відарысам"
+
+#: data/gtk/preferences.blp:385
+msgid "Update Covers"
+msgstr "Абнавіць вокладкі"
+
+#: data/gtk/preferences.blp:386
+msgid "Fetch covers for games already in your library"
+msgstr "Атрымаць вокладкі для гульняў, якія ўжо ёсць у вашай бібліятэцы"
+
+#: data/gtk/preferences.blp:391
+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 "Yahor Haurylenka https://github.com/k1llo"
+
+#. 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 "file.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:126
+msgid "All games removed"
+msgstr "Усе гульні выдалены"
+
+#: cartridges/preferences.py:174
+msgid ""
+"An API key is required to use SteamGridDB. You can generate one {}here{}."
+msgstr ""
+"Для выкарыстання SteamGridDB патрабуецца ключ API. Вы можаце стварыць яго {}"
+"тут{}."
+
+#: cartridges/preferences.py:189
+msgid "Downloading covers…"
+msgstr "Спампоўка вокладак…"
+
+#: cartridges/preferences.py:208
+msgid "Covers updated"
+msgstr "Вокладкі абноўлены"
+
+#: cartridges/preferences.py:343
+msgid "Installation Not Found"
+msgstr "Усталяванне не знойдзена"
+
+#: cartridges/preferences.py:344
+msgid "Select a valid directory."
+msgstr "Выберыце сапраўдны каталог."
+
+#: cartridges/preferences.py:380 cartridges/importer/importer.py:317
+msgid "Warning"
+msgstr "Увага"
+
+#: cartridges/preferences.py:414
+msgid "Invalid Directory"
+msgstr "Няправільны каталог"
+
+#: cartridges/preferences.py:420
+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 "Імпартавана 1 гульня"
+
+#. 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 "1 выдалена"
+
+#. 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 "Ядро RetroArch не выбрана"
+
+#. 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 "Праверце свой ключ API ў наладах"

po/cartridges.pot

@@ -8,7 +8,7 @@ msgid ""
 msgstr ""
 "Project-Id-Version: Cartridges\n"
 "Report-Msgid-Bugs-To: \n"
-"POT-Creation-Date: 2023-04-05 11:11+0200\n"
+"POT-Creation-Date: 2023-12-12 10:32+0100\n"
 "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n"
 "Last-Translator: FULL NAME <EMAIL@ADDRESS>\n"
 "Language-Team: LANGUAGE <LL@li.org>\n"
@@ -18,8 +18,9 @@ msgstr ""
 "Content-Transfer-Encoding: 8bit\n"
 
 #: data/hu.kramo.Cartridges.desktop.in:3
-#: data/hu.kramo.Cartridges.metainfo.xml.in:6 data/gtk/window.blp:29
+#: data/hu.kramo.Cartridges.metainfo.xml.in:6
-#: src/main.py:113
+#: 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 ""
 
@@ -32,6 +33,11 @@ msgstr ""
 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 "
@@ -40,499 +46,444 @@ msgid ""
 "SteamGridDB."
 msgstr ""
 
-#: data/hu.kramo.Cartridges.metainfo.xml.in:22
+#: data/hu.kramo.Cartridges.metainfo.xml.in:36 data/gtk/window.blp:290
-msgid "Library"
+#: cartridges/details_window.py:71
-msgstr ""
-
-#: data/hu.kramo.Cartridges.metainfo.xml.in:26
-#: src/utils/create_details_window.py:85
-msgid "Edit Game Details"
-msgstr ""
-
-#: data/hu.kramo.Cartridges.metainfo.xml.in:30 data/gtk/window.blp:51
 msgid "Game Details"
 msgstr ""
 
-#: data/hu.kramo.Cartridges.metainfo.xml.in:34 data/gtk/window.blp:371
+#: data/hu.kramo.Cartridges.metainfo.xml.in:40
-#: src/utils/importer.py:94 src/utils/importer.py:123 src/utils/importer.py:148
+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/window.blp:6 src/utils/importer.py:91
+#: data/gtk/details-window.blp:25
-msgid "No Games Found"
+msgid "Cancel"
 msgstr ""
 
-#: data/gtk/window.blp:7
+#: data/gtk/details-window.blp:55
-msgid "Try a different search."
+msgid "New Cover"
 msgstr ""
 
-#: data/gtk/window.blp:14
+#: data/gtk/details-window.blp:73
-msgid "No Games"
+msgid "Delete Cover"
 msgstr ""
 
-#: data/gtk/window.blp:15
+#: data/gtk/details-window.blp:100 data/gtk/game.blp:81
-msgid "Use the + button to add games."
-msgstr ""
-
-#: data/gtk/window.blp:22
-msgid "No Hidden Games"
-msgstr ""
-
-#: data/gtk/window.blp:23
-msgid "Games you hide will appear here."
-msgstr ""
-
-#: data/gtk/window.blp:44 data/gtk/window.blp:262
-msgid "Back"
-msgstr ""
-
-#: data/gtk/window.blp:100
-msgid "Game Title"
-msgstr ""
-
-#: data/gtk/window.blp:156 src/game.py:168
-msgid "Play"
-msgstr ""
-
-#: data/gtk/window.blp:204 data/gtk/window.blp:390
-msgid "Add Game"
-msgstr ""
-
-#: data/gtk/window.blp:211 data/gtk/window.blp:274
-msgid "Main Menu"
-msgstr ""
-
-#: data/gtk/window.blp:218 data/gtk/window.blp:281 data/gtk/help-overlay.blp:19
-msgid "Search"
-msgstr ""
-
-#: data/gtk/window.blp:269
-msgid "Hidden Games"
-msgstr ""
-
-#: data/gtk/window.blp:329
-msgid "Sort"
-msgstr ""
-
-#: data/gtk/window.blp:332
-msgid "A-Z"
-msgstr ""
-
-#: data/gtk/window.blp:338
-msgid "Z-A"
-msgstr ""
-
-#: data/gtk/window.blp:344
-msgid "Newest"
-msgstr ""
-
-#: data/gtk/window.blp:350
-msgid "Oldest"
-msgstr ""
-
-#: data/gtk/window.blp:356
-msgid "Last Played"
-msgstr ""
-
-#: data/gtk/window.blp:363
-msgid "Show Hidden"
-msgstr ""
-
-#: data/gtk/window.blp:376
-msgid "Keyboard Shortcuts"
-msgstr ""
-
-#: data/gtk/window.blp:381
-msgid "About Cartridges"
-msgstr ""
-
-#: data/gtk/window.blp:396 data/gtk/preferences.blp:66
-msgid "Import"
-msgstr ""
-
-#: data/gtk/game.blp:60 src/utils/create_details_window.py:127
 msgid "Title"
 msgstr ""
 
-#: data/gtk/game.blp:82 data/gtk/game.blp:101
+#: 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:87
+#: data/gtk/game.blp:103 cartridges/window.py:350
 msgid "Hide"
 msgstr ""
 
-#: data/gtk/game.blp:92 data/gtk/game.blp:111 data/gtk/preferences.blp:53
+#: data/gtk/game.blp:104 data/gtk/game.blp:112 data/gtk/window.blp:437
 msgid "Remove"
 msgstr ""
 
-#: data/gtk/game.blp:106
+#: data/gtk/game.blp:111 cartridges/window.py:352
 msgid "Unhide"
 msgstr ""
 
-#: data/gtk/help-overlay.blp:11 data/gtk/preferences.blp:9
+#: data/gtk/help-overlay.blp:11 data/gtk/preferences.blp:8
 msgid "General"
 msgstr ""
 
-#: data/gtk/help-overlay.blp:14
+#: data/gtk/help-overlay.blp:14 data/gtk/window.blp:184 data/gtk/window.blp:200
-msgid "Quit"
+#: 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/help-overlay.blp:24 data/gtk/window.blp:517
-msgid "Show preferences"
+msgid "Keyboard Shortcuts"
 msgstr ""
 
-#: data/gtk/help-overlay.blp:29
+#: data/gtk/help-overlay.blp:29 cartridges/game.py:103
-msgid "Shortcuts"
+#: cartridges/preferences.py:129 cartridges/importer/importer.py:394
-msgstr ""
-
-#: data/gtk/help-overlay.blp:34 src/main.py:178 src/main.py:234
-#: src/preferences.py:131
 msgid "Undo"
 msgstr ""
 
-#: data/gtk/help-overlay.blp:39
+#: data/gtk/help-overlay.blp:34
-msgid "Open menu"
+msgid "Quit"
 msgstr ""
 
-#: data/gtk/help-overlay.blp:45
+#: 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:48
+#: data/gtk/help-overlay.blp:53 data/gtk/window.blp:170 data/gtk/window.blp:524
-msgid "Add new game"
+msgid "Add Game"
 msgstr ""
 
-#: data/gtk/help-overlay.blp:53
+#: data/gtk/help-overlay.blp:58 data/gtk/preferences.blp:112
-msgid "Import games"
+#: data/gtk/window.blp:27 data/gtk/window.blp:528
-msgstr ""
+msgid "Import"
-
-#: data/gtk/help-overlay.blp:58
-msgid "Show hidden games"
 msgstr ""
 
 #: data/gtk/help-overlay.blp:63
-msgid "Remove game"
+msgid "Show Hidden Games"
 msgstr ""
 
-#: data/gtk/preferences.blp:13 data/gtk/preferences.blp:229
+#: 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:16
+#: data/gtk/preferences.blp:15
 msgid "Exit After Launching Games"
 msgstr ""
 
-#: data/gtk/preferences.blp:24
+#: data/gtk/preferences.blp:19
 msgid "Cover Image Launches Game"
 msgstr ""
 
-#: data/gtk/preferences.blp:25
+#: data/gtk/preferences.blp:20
 msgid "Swaps the behavior of the cover image and the play button"
 msgstr ""
 
-#: data/gtk/preferences.blp:34 src/utils/create_details_window.py:99
+#: data/gtk/preferences.blp:25 cartridges/details_window.py:85
 msgid "Images"
 msgstr ""
 
-#: data/gtk/preferences.blp:37
+#: data/gtk/preferences.blp:28
 msgid "High Quality Images"
 msgstr ""
 
-#: data/gtk/preferences.blp:38
+#: data/gtk/preferences.blp:29
 msgid "Save game covers losslessly at the cost of storage"
 msgstr ""
 
-#: data/gtk/preferences.blp:47
+#: data/gtk/preferences.blp:34
 msgid "Danger Zone"
 msgstr ""
 
-#: data/gtk/preferences.blp:50
+#: data/gtk/preferences.blp:47
 msgid "Remove All Games"
 msgstr ""
 
-#: data/gtk/preferences.blp:70
+#: data/gtk/preferences.blp:119
+msgid "Remove Uninstalled Games"
+msgstr ""
+
+#: data/gtk/preferences.blp:124
 msgid "Sources"
 msgstr ""
 
-#: data/gtk/preferences.blp:73
+#: data/gtk/preferences.blp:127 cartridges/importer/steam_source.py:114
 msgid "Steam"
 msgstr ""
 
-#: data/gtk/preferences.blp:77
+#: data/gtk/preferences.blp:136 data/gtk/preferences.blp:158
-msgid "Steam Install Location"
+#: 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:78 data/gtk/preferences.blp:117
+#: data/gtk/preferences.blp:149 data/gtk/window.blp:539
-#: data/gtk/preferences.blp:150 data/gtk/preferences.blp:189
+#: cartridges/importer/lutris_source.py:92
-#: data/gtk/preferences.blp:204
-msgid "Directory to use when importing games"
-msgstr ""
-
-#: data/gtk/preferences.blp:86 src/utils/importer.py:143
-msgid "Extra Steam Libraries"
-msgstr ""
-
-#: data/gtk/preferences.blp:87
-msgid "Select other directories where you have Steam games installed"
-msgstr ""
-
-#: data/gtk/preferences.blp:94
-msgid "Clear"
-msgstr ""
-
-#: data/gtk/preferences.blp:112
 msgid "Lutris"
 msgstr ""
 
-#: data/gtk/preferences.blp:116
+#: data/gtk/preferences.blp:170
-msgid "Lutris Install Location"
+msgid "Cache Location"
 msgstr ""
 
-#: data/gtk/preferences.blp:126
+#: data/gtk/preferences.blp:182
-msgid "Lutris Cache Location"
-msgstr ""
-
-#: data/gtk/preferences.blp:127
-msgid "Directory to use when importing game covers"
-msgstr ""
-
-#: data/gtk/preferences.blp:136
 msgid "Import Steam Games"
 msgstr ""
 
-#: data/gtk/preferences.blp:145
+#: 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:149
+#: data/gtk/preferences.blp:212
-msgid "Heroic Install Location"
-msgstr ""
-
-#: data/gtk/preferences.blp:159
 msgid "Import Epic Games"
 msgstr ""
 
-#: data/gtk/preferences.blp:167
+#: data/gtk/preferences.blp:216
 msgid "Import GOG Games"
 msgstr ""
 
-#: data/gtk/preferences.blp:175
+#: data/gtk/preferences.blp:220
-msgid "Import Sideloaded Games"
+msgid "Import Amazon Games"
-msgstr ""
-
-#: data/gtk/preferences.blp:184
-msgid "Bottles"
-msgstr ""
-
-#: data/gtk/preferences.blp:188
-msgid "Bottles Install Location"
-msgstr ""
-
-#: data/gtk/preferences.blp:199
-msgid "itch"
-msgstr ""
-
-#: data/gtk/preferences.blp:203
-msgid "itch Install Location"
-msgstr ""
-
-#: data/gtk/preferences.blp:217
-msgid "SteamGridDB"
-msgstr ""
-
-#: data/gtk/preferences.blp:221
-msgid "Authentication"
 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 ""
+
+#: data/gtk/preferences.blp:373
+msgid "Authentication"
+msgstr ""
+
+#: data/gtk/preferences.blp:376
 msgid "API Key"
 msgstr ""
 
-#: data/gtk/preferences.blp:232
+#: data/gtk/preferences.blp:384
 msgid "Use SteamGridDB"
 msgstr ""
 
-#: data/gtk/preferences.blp:233
+#: data/gtk/preferences.blp:385
 msgid "Download images when adding or importing games"
 msgstr ""
 
-#: data/gtk/preferences.blp:240
+#: data/gtk/preferences.blp:389
 msgid "Prefer Over Official Images"
 msgstr ""
 
-#. Translators: Replace this with your name for it to show up in the about window
+#: data/gtk/preferences.blp:393
-#: src/main.py:129
+msgid "Prefer Animated Images"
-msgid "translator_credits"
+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 ""
+
+#: data/gtk/window.blp:538
+msgid "ProtonDB"
+msgstr ""
+
+#: data/gtk/window.blp:540
+msgid "HowLongToBeat"
 msgstr ""
 
 #. The variable is the title of the game
-#: src/main.py:156
+#: cartridges/main.py:206 cartridges/game.py:125
 msgid "{} launched"
 msgstr ""
 
-#. The variable is the title of the game
+#. Translators: Replace this with your name for it to show up in the about window
-#: src/main.py:174
+#: cartridges/main.py:269
-msgid "{} hidden"
+msgid "translator_credits"
-msgstr ""
-
-#. The variable is the title of the game
-#: src/main.py:177
-msgid "{} unhidden"
-msgstr ""
-
-#. The variable is the title of the game
-#: src/main.py:233
-msgid "{} removed"
-msgstr ""
-
-#: src/window.py:241
-msgid "Today"
-msgstr ""
-
-#: src/window.py:243
-msgid "Yesterday"
 msgstr ""
 
 #. The variable is the date when the game was added
-#: src/window.py:281
+#: cartridges/window.py:373
 msgid "Added: {}"
 msgstr ""
 
-#: src/window.py:286
+#: cartridges/window.py:376
 msgid "Never"
 msgstr ""
 
 #. The variable is the date when the game was last played
-#: src/window.py:290
+#: cartridges/window.py:380
 msgid "Last played: {}"
 msgstr ""
 
-#: src/game.py:166
+#: cartridges/details_window.py:76
-msgid "Details"
-msgstr ""
-
-#: src/preferences.py:53
-msgid "Installation Not Found"
-msgstr ""
-
-#. The variable is the name of the game launcher
-#: src/preferences.py:55
-msgid "Select the {} configuration directory."
-msgstr ""
-
-#. The variable is the name of the game launcher
-#: src/preferences.py:58
-msgid "Select the {} data directory."
-msgstr ""
-
-#: src/preferences.py:60 src/preferences.py:238
-msgid "Set Location"
-msgstr ""
-
-#: src/preferences.py:130
-msgid "All games removed"
-msgstr ""
-
-#: src/preferences.py:235
-msgid "Cache Not Found"
-msgstr ""
-
-#: src/preferences.py:236
-msgid "Select the Lutris cache directory."
-msgstr ""
-
-#: src/preferences.py:335
-msgid ""
-"An API key is required to use SteamGridDB. You can generate one {}here{}."
-msgstr ""
-
-#: src/utils/importer.py:42
-msgid "Importing Games…"
-msgstr ""
-
-#: src/utils/importer.py:77
-msgid "Importing Covers…"
-msgstr ""
-
-#: src/utils/importer.py:92
-msgid "No new games were found on your system."
-msgstr ""
-
-#: src/utils/importer.py:100
-msgid "Game Imported"
-msgstr ""
-
-#: src/utils/importer.py:101
-msgid "Successfully imported 1 game."
-msgstr ""
-
-#: src/utils/importer.py:107
-msgid "Games Imported"
-msgstr ""
-
-#. The variable is the number of games
-#: src/utils/importer.py:109
-msgid "Successfully imported {} games."
-msgstr ""
-
-#: src/utils/importer.py:120
-msgid "Couldn't Connect to SteamGridDB"
-msgstr ""
-
-#: src/utils/importer.py:145
-msgid ""
-"Looks like you have multiple Steam libraries. Would you like to add them in "
-"preferences?"
-msgstr ""
-
-#: src/utils/create_details_window.py:78
-msgid "Add New Game"
-msgstr ""
-
-#: src/utils/create_details_window.py:83
-msgid "Confirm"
-msgstr ""
-
-#: src/utils/create_details_window.py:94
 msgid "Apply"
 msgstr ""
 
-#: src/utils/create_details_window.py:128
+#: cartridges/details_window.py:82
-msgid "The title of the game"
+msgid "Add New Game"
 msgstr ""
 
-#: src/utils/create_details_window.py:133
+#: cartridges/details_window.py:83
-msgid "Developer"
+msgid "Add"
 msgstr ""
 
-#: src/utils/create_details_window.py:134
+#: cartridges/details_window.py:93
-msgid "The developer or publisher (optional)"
+msgid "Executables"
 msgstr ""
 
 #. Translate this string as you would translate "file"
-#: src/utils/create_details_window.py:145
+#: cartridges/details_window.py:108
 msgid "file.txt"
 msgstr ""
 
 #. As in software
-#: src/utils/create_details_window.py:147
+#: cartridges/details_window.py:110
 msgid "program"
 msgstr ""
 
 #. Translate this string as you would translate "path to {}"
-#: src/utils/create_details_window.py:152
+#: cartridges/details_window.py:115 cartridges/details_window.py:117
-#: src/utils/create_details_window.py:154
 msgid "C:\\path\\to\\{}"
 msgstr ""
 
 #. Translate this string as you would translate "path to {}"
-#: src/utils/create_details_window.py:158
+#: cartridges/details_window.py:121 cartridges/details_window.py:123
-#: src/utils/create_details_window.py:160
 msgid "/path/to/{}"
 msgstr ""
 
-#: src/utils/create_details_window.py:164
+#: cartridges/details_window.py:128
 msgid ""
 "To launch the executable \"{}\", use the command:\n"
 "\n"
@@ -545,40 +496,136 @@ msgid ""
 "If the path contains spaces, make sure to wrap it in double quotes!"
 msgstr ""
 
-#: src/utils/create_details_window.py:187
+#: cartridges/details_window.py:171 cartridges/details_window.py:177
-msgid "Executable"
-msgstr ""
-
-#: src/utils/create_details_window.py:188
-msgid "File to open or command to run when launching the game"
-msgstr ""
-
-#: src/utils/create_details_window.py:200
-msgid "Cancel"
-msgstr ""
-
-#: src/utils/create_details_window.py:252
-#: src/utils/create_details_window.py:262
-#: src/utils/create_details_window.py:268
 msgid "Couldn't Add Game"
 msgstr ""
 
-#: src/utils/create_details_window.py:254
+#: cartridges/details_window.py:171 cartridges/details_window.py:213
-#: src/utils/create_details_window.py:292
-#: src/utils/create_details_window.py:300
-msgid "Couldn't Apply Preferences"
-msgstr ""
-
-#: src/utils/create_details_window.py:262
-#: src/utils/create_details_window.py:293
 msgid "Game title cannot be empty."
 msgstr ""
 
-#: src/utils/create_details_window.py:268
+#: cartridges/details_window.py:177 cartridges/details_window.py:221
-#: src/utils/create_details_window.py:301
 msgid "Executable cannot be empty."
 msgstr ""
 
-#: src/utils/create_dialog.py:25
+#: 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 ""
+
+#: 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 ""
+
+#: cartridges/store/managers/sgdb_manager.py:47
+msgid "Verify your API key in preferences"
+msgstr ""

po/cs.po

@@ -0,0 +1,682 @@
+# SOME DESCRIPTIVE TITLE.
+# Copyright (C) YEAR kramo
+# This file is distributed under the same license as the Cartridges package.
+# foo expert <deferred_water346@simplelogin.com>, 2023.
+msgid ""
+msgstr ""
+"Project-Id-Version: Cartridges\n"
+"Report-Msgid-Bugs-To: \n"
+"POT-Creation-Date: 2023-11-17 17:08+0100\n"
+"PO-Revision-Date: 2023-09-24 16:04+0000\n"
+"Last-Translator: foo expert <deferred_water346@simplelogin.com>\n"
+"Language-Team: Czech <https://hosted.weblate.org/projects/cartridges/"
+"cartridges/cs/>\n"
+"Language: cs\n"
+"MIME-Version: 1.0\n"
+"Content-Type: text/plain; charset=UTF-8\n"
+"Content-Transfer-Encoding: 8bit\n"
+"Plural-Forms: nplurals=3; plural=(n==1) ? 0 : (n>=2 && n<=4) ? 1 : 2;\n"
+"X-Generator: Weblate 5.1-dev\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 "Kazety"
+
+#: data/hu.kramo.Cartridges.desktop.in:4
+msgid "Game Launcher"
+msgstr "Spouštěč her"
+
+#: data/hu.kramo.Cartridges.desktop.in:5
+#: data/hu.kramo.Cartridges.metainfo.xml.in:7
+msgid "Launch all your games"
+msgstr "Spusťte všechny vaše hry"
+
+#: data/hu.kramo.Cartridges.desktop.in:11
+msgid ""
+"gaming;launcher;steam;lutris;heroic;bottles;itch;flatpak;legendary;retroarch;"
+msgstr ""
+"hraní;spouštěč;steam;lutris;heroic;láhve;itch;flatpak;legendary;retroarch;"
+
+#: 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 ""
+"Kazety jsou jednoduchý spouštěč pro všechny vaše hry. Podporuje importovaní "
+"her ze služeb Steam, Lutris, Heroic a dalších bez nutnosti přihlášení. Hry "
+"můžete třídit a skrývat nebo stahovat obálky ze služby SteamGridDB."
+
+#: data/hu.kramo.Cartridges.metainfo.xml.in:36 data/gtk/window.blp:290
+#: cartridges/details_window.py:71
+msgid "Game Details"
+msgstr "Podrobnosti o hře"
+
+#: data/hu.kramo.Cartridges.metainfo.xml.in:40
+msgid "Edit Game Details"
+msgstr "Upravit podrobnosti o hře"
+
+#: 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 "Předvolby"
+
+#: data/gtk/details-window.blp:25
+msgid "Cancel"
+msgstr "Zrušit"
+
+#: data/gtk/details-window.blp:55
+msgid "New Cover"
+msgstr "Nový obal"
+
+#: data/gtk/details-window.blp:73
+msgid "Delete Cover"
+msgstr "Odstranit obal"
+
+#: data/gtk/details-window.blp:100 data/gtk/game.blp:81
+msgid "Title"
+msgstr "Název"
+
+#: data/gtk/details-window.blp:103
+msgid "Developer (optional)"
+msgstr "Vývojář (nepovinné)"
+
+#: data/gtk/details-window.blp:108
+msgid "Executable"
+msgstr "Spustitelný soubor"
+
+#: data/gtk/details-window.blp:114
+msgid "Select File"
+msgstr "Vybrat soubor"
+
+#: data/gtk/details-window.blp:125
+msgid "More Info"
+msgstr "Více informací"
+
+#: data/gtk/game.blp:102 data/gtk/game.blp:110 data/gtk/window.blp:417
+msgid "Edit"
+msgstr "Upravit"
+
+#: data/gtk/game.blp:103 cartridges/window.py:350
+msgid "Hide"
+msgstr "Skrýt"
+
+#: data/gtk/game.blp:104 data/gtk/game.blp:112 data/gtk/window.blp:437
+msgid "Remove"
+msgstr "Odstranit"
+
+#: data/gtk/game.blp:111 cartridges/window.py:352
+msgid "Unhide"
+msgstr "Odkrýt"
+
+#: data/gtk/help-overlay.blp:11 data/gtk/preferences.blp:8
+msgid "General"
+msgstr "Obecné"
+
+#: 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 "Vyhledávání"
+
+#: data/gtk/help-overlay.blp:24 data/gtk/window.blp:517
+msgid "Keyboard Shortcuts"
+msgstr "Klávesové zkratky"
+
+#: data/gtk/help-overlay.blp:29 cartridges/game.py:103
+#: cartridges/preferences.py:127 cartridges/importer/importer.py:394
+msgid "Undo"
+msgstr "Zpět"
+
+#: data/gtk/help-overlay.blp:34
+msgid "Quit"
+msgstr "Ukončit"
+
+#: data/gtk/help-overlay.blp:39 data/gtk/window.blp:88 data/gtk/window.blp:164
+msgid "Toggle Sidebar"
+msgstr "Přepnout postranní panel"
+
+#: data/gtk/help-overlay.blp:44 data/gtk/window.blp:177 data/gtk/window.blp:237
+msgid "Main Menu"
+msgstr "Hlavní nabídka"
+
+#: data/gtk/help-overlay.blp:50
+msgid "Games"
+msgstr "Hry"
+
+#: data/gtk/help-overlay.blp:53 data/gtk/window.blp:170 data/gtk/window.blp:524
+msgid "Add Game"
+msgstr "Přidat hru"
+
+#: data/gtk/help-overlay.blp:58 data/gtk/preferences.blp:112
+#: data/gtk/window.blp:27 data/gtk/window.blp:528
+msgid "Import"
+msgstr "Import"
+
+#: data/gtk/help-overlay.blp:63
+msgid "Show Hidden Games"
+msgstr "Zobrazit skryté hry"
+
+#: data/gtk/help-overlay.blp:68
+msgid "Remove Game"
+msgstr "Odstranit hru"
+
+#: data/gtk/preferences.blp:12 data/gtk/preferences.blp:116
+#: data/gtk/preferences.blp:367
+msgid "Behavior"
+msgstr "Chování"
+
+#: data/gtk/preferences.blp:15
+msgid "Exit After Launching Games"
+msgstr "Ukončit po spuštění her"
+
+#: data/gtk/preferences.blp:19
+msgid "Cover Image Launches Game"
+msgstr "Obrázek na obálce spouští hru"
+
+#: data/gtk/preferences.blp:20
+msgid "Swaps the behavior of the cover image and the play button"
+msgstr "Vymění chování obrázku na obálce a tlačítka pro přehrávání"
+
+#: data/gtk/preferences.blp:25 cartridges/details_window.py:85
+msgid "Images"
+msgstr "Obrázky"
+
+#: data/gtk/preferences.blp:28
+msgid "High Quality Images"
+msgstr "Vysoce kvalitní obrázky"
+
+#: data/gtk/preferences.blp:29
+msgid "Save game covers losslessly at the cost of storage"
+msgstr "Ukládat obaly her bezztrátově na úkor většího místa na disku"
+
+#: data/gtk/preferences.blp:34
+msgid "Danger Zone"
+msgstr "Nebezpečná zóna"
+
+#: data/gtk/preferences.blp:47
+msgid "Remove All Games"
+msgstr "Odstranit všechny hry"
+
+#: data/gtk/preferences.blp:119
+msgid "Remove Uninstalled Games"
+msgstr "Odstranit odinstalované hry"
+
+#: data/gtk/preferences.blp:124
+msgid "Sources"
+msgstr "Zdroje"
+
+#: data/gtk/preferences.blp:127 cartridges/importer/steam_source.py:114
+msgid "Steam"
+msgstr "Steam"
+
+#: 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 data/gtk/preferences.blp:326
+msgid "Install Location"
+msgstr "Umístění instalace"
+
+#: data/gtk/preferences.blp:149 data/gtk/window.blp:539
+#: cartridges/importer/lutris_source.py:92
+msgid "Lutris"
+msgstr "Lutris"
+
+#: data/gtk/preferences.blp:170
+msgid "Cache Location"
+msgstr "Umístění dočasných souborů"
+
+#: data/gtk/preferences.blp:182
+msgid "Import Steam Games"
+msgstr "Importovat Steam hry"
+
+#: data/gtk/preferences.blp:186
+msgid "Import Flatpak Games"
+msgstr "Importovat Flatpak hry"
+
+#: data/gtk/preferences.blp:191 cartridges/importer/heroic_source.py:355
+msgid "Heroic"
+msgstr "Heroic"
+
+#: data/gtk/preferences.blp:212
+msgid "Import Epic Games"
+msgstr "Importovat Epic Games hry"
+
+#: data/gtk/preferences.blp:216
+msgid "Import GOG Games"
+msgstr "Importovat GOG hry"
+
+#: data/gtk/preferences.blp:220
+msgid "Import Amazon Games"
+msgstr "Importovat Amazon hry"
+
+#: data/gtk/preferences.blp:224
+msgid "Import Sideloaded Games"
+msgstr "Importovat ručně načtené hry"
+
+#: data/gtk/preferences.blp:229 cartridges/importer/bottles_source.py:86
+msgid "Bottles"
+msgstr "Láhve"
+
+#: data/gtk/preferences.blp:251 cartridges/importer/itch_source.py:81
+msgid "itch"
+msgstr "itch"
+
+#: data/gtk/preferences.blp:273 cartridges/importer/legendary_source.py:97
+msgid "Legendary"
+msgstr "Legendary"
+
+#: data/gtk/preferences.blp:295 cartridges/importer/retroarch_source.py:142
+msgid "RetroArch"
+msgstr "RetroArch"
+
+#: data/gtk/preferences.blp:317 cartridges/importer/flatpak_source.py:118
+msgid "Flatpak"
+msgstr "Flatpak"
+
+#: data/gtk/preferences.blp:338
+msgid "Import Game Launchers"
+msgstr "Importovat spouštěče her"
+
+#: data/gtk/preferences.blp:343 cartridges/importer/desktop_source.py:215
+msgid "Desktop Entries"
+msgstr "Položky na ploše"
+
+#: data/gtk/preferences.blp:355 data/gtk/window.blp:537
+msgid "SteamGridDB"
+msgstr "SteamGridDB"
+
+#: data/gtk/preferences.blp:359
+msgid "Authentication"
+msgstr "Ověření"
+
+#: data/gtk/preferences.blp:362
+msgid "API Key"
+msgstr "Klíč API"
+
+#: data/gtk/preferences.blp:370
+msgid "Use SteamGridDB"
+msgstr "Používat SteamGridDB"
+
+#: data/gtk/preferences.blp:371
+msgid "Download images when adding or importing games"
+msgstr "Stahovat obrázky při přidávání nebo importování her"
+
+#: data/gtk/preferences.blp:375
+msgid "Prefer Over Official Images"
+msgstr "Upřednostnit před oficiálními obrázky"
+
+#: data/gtk/preferences.blp:379
+msgid "Prefer Animated Images"
+msgstr "Upřednostnit animované obrázky"
+
+#: data/gtk/preferences.blp:385
+#, fuzzy
+#| msgid "Delete Cover"
+msgid "Update Covers"
+msgstr "Odstranit obal"
+
+#: data/gtk/preferences.blp:386
+msgid "Fetch covers for games already in your library"
+msgstr ""
+
+#: data/gtk/preferences.blp:391
+msgid "Update"
+msgstr ""
+
+#: data/gtk/window.blp:6 data/gtk/window.blp:14
+msgid "No Games Found"
+msgstr "Nebyly nalezeny žádné hry"
+
+#: data/gtk/window.blp:7 data/gtk/window.blp:15
+msgid "Try a different search."
+msgstr "Zkuste hledat něco jiného."
+
+#: data/gtk/window.blp:21
+msgid "No Games"
+msgstr "Žádné hry"
+
+#: data/gtk/window.blp:22
+msgid "Use the + button to add games."
+msgstr "Tlačítkem + můžete přidávat hry."
+
+#: data/gtk/window.blp:40
+msgid "No Hidden Games"
+msgstr "Žádné skryté hry"
+
+#: data/gtk/window.blp:41
+msgid "Games you hide will appear here."
+msgstr "Hry, které skryjete, se zobrazí zde."
+
+#: data/gtk/window.blp:75 data/gtk/window.blp:106 cartridges/main.py:226
+msgid "All Games"
+msgstr "Všechny hry"
+
+#: data/gtk/window.blp:126 cartridges/main.py:228
+msgid "Added"
+msgstr "Přidané"
+
+#: data/gtk/window.blp:141
+msgid "Imported"
+msgstr "Importované"
+
+#: data/gtk/window.blp:230
+msgid "Hidden Games"
+msgstr "Skryté hry"
+
+#: data/gtk/window.blp:341
+msgid "Game Title"
+msgstr "Název hry"
+
+#: data/gtk/window.blp:398
+msgid "Play"
+msgstr "Hrát"
+
+#: data/gtk/window.blp:475
+msgid "Sort"
+msgstr "Třídit"
+
+#: data/gtk/window.blp:478
+msgid "A-Z"
+msgstr "A-Ž"
+
+#: data/gtk/window.blp:484
+msgid "Z-A"
+msgstr "Ž-A"
+
+#: data/gtk/window.blp:490
+msgid "Newest"
+msgstr "Nejnovější"
+
+#: data/gtk/window.blp:496
+msgid "Oldest"
+msgstr "Nejstarší"
+
+#: data/gtk/window.blp:502
+msgid "Last Played"
+msgstr "Naposledy hráno"
+
+#: data/gtk/window.blp:509
+msgid "Show Hidden"
+msgstr "Zobrazit Skryté"
+
+#: data/gtk/window.blp:518
+msgid "About Cartridges"
+msgstr "O Kazetách"
+
+#: data/gtk/window.blp:536
+msgid "IGDB"
+msgstr ""
+
+#: data/gtk/window.blp:538
+msgid "ProtonDB"
+msgstr ""
+
+#: data/gtk/window.blp:540
+msgid "HowLongToBeat"
+msgstr ""
+
+#. The variable is the title of the game
+#: cartridges/main.py:206 cartridges/game.py:125
+msgid "{} launched"
+msgstr "{} spuštěno"
+
+#. Translators: Replace this with your name for it to show up in the about window
+#: cartridges/main.py:269
+msgid "translator_credits"
+msgstr "ooo.i.love.foo"
+
+#. The variable is the date when the game was added
+#: cartridges/window.py:373
+msgid "Added: {}"
+msgstr "Přidáno: {}"
+
+#: cartridges/window.py:376
+msgid "Never"
+msgstr "Nikdy"
+
+#. The variable is the date when the game was last played
+#: cartridges/window.py:380
+msgid "Last played: {}"
+msgstr "Naposledy hráno: {}"
+
+#: cartridges/details_window.py:76
+msgid "Apply"
+msgstr "Použít"
+
+#: cartridges/details_window.py:82
+msgid "Add New Game"
+msgstr "Přidat novou hru"
+
+#: cartridges/details_window.py:83
+msgid "Add"
+msgstr "Přidat"
+
+#: cartridges/details_window.py:93
+msgid "Executables"
+msgstr "Spustitelné soubory"
+
+#. Translate this string as you would translate "file"
+#: cartridges/details_window.py:108
+msgid "file.txt"
+msgstr "soubor.txt"
+
+#. As in software
+#: cartridges/details_window.py:110
+msgid "program"
+msgstr "program"
+
+#. 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:\\cesta\\k\\{}"
+
+#. Translate this string as you would translate "path to {}"
+#: cartridges/details_window.py:121 cartridges/details_window.py:123
+msgid "/path/to/{}"
+msgstr "/cesta/k/{}"
+
+#: 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 ""
+"Chcete-li spustit spustitelný soubor \"{}\", použijte příkaz:\n"
+"\n"
+"<tt>\"{}\"</tt>\n"
+"\n"
+"Chcete-li otevřít soubor \"{}\" pomocí výchozí aplikace, použijte příkaz:\n"
+"\n"
+"<tt>{} \"{}\"</tt>\n"
+"\n"
+"Pokud cesta obsahuje mezery, nezapomeňte ji zabalit do dvojitých uvozovek!"
+
+#: cartridges/details_window.py:171 cartridges/details_window.py:177
+msgid "Couldn't Add Game"
+msgstr "Nelze přidat hru"
+
+#: cartridges/details_window.py:171 cartridges/details_window.py:213
+msgid "Game title cannot be empty."
+msgstr "Název hry nemůže být prázdný."
+
+#: cartridges/details_window.py:177 cartridges/details_window.py:221
+msgid "Executable cannot be empty."
+msgstr "Spustitelný soubor nemůže být prázdný."
+
+#: cartridges/details_window.py:212 cartridges/details_window.py:220
+msgid "Couldn't Apply Preferences"
+msgstr "Nelze použít předvolby"
+
+#. The variable is the title of the game
+#: cartridges/game.py:139
+msgid "{} hidden"
+msgstr "{} skryto"
+
+#: cartridges/game.py:139
+msgid "{} unhidden"
+msgstr "{} odkryto"
+
+#. 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 "{} odstraněno"
+
+#: cartridges/preferences.py:126
+msgid "All games removed"
+msgstr "Všechny hry odstraněny"
+
+#: cartridges/preferences.py:174
+msgid ""
+"An API key is required to use SteamGridDB. You can generate one {}here{}."
+msgstr ""
+"K používání služby SteamGridDB je vyžadován klíč API. Můžete si ho "
+"vygenerovat {}zde{}."
+
+#: cartridges/preferences.py:189
+msgid "Downloading covers…"
+msgstr ""
+
+#: cartridges/preferences.py:208
+msgid "Covers updated"
+msgstr ""
+
+#: cartridges/preferences.py:343
+msgid "Installation Not Found"
+msgstr "Instalace nebyla nalezena"
+
+#: cartridges/preferences.py:344
+msgid "Select a valid directory."
+msgstr "Vyberte platný adresář."
+
+#: cartridges/preferences.py:380 cartridges/importer/importer.py:317
+msgid "Warning"
+msgstr "Pozor"
+
+#: cartridges/preferences.py:414
+msgid "Invalid Directory"
+msgstr "Neplatný adresář"
+
+#: cartridges/preferences.py:420
+msgid "Set Location"
+msgstr "Nastavit umístění"
+
+#: cartridges/utils/create_dialog.py:33 cartridges/importer/importer.py:318
+msgid "Dismiss"
+msgstr "Zahodit"
+
+#: cartridges/importer/importer.py:145
+msgid "Importing Games…"
+msgstr "Přidávání her…"
+
+#: cartridges/importer/importer.py:338
+msgid "The following errors occured during import:"
+msgstr "Tyto chyby se vyskytly při importu:"
+
+#: cartridges/importer/importer.py:367
+msgid "No new games found"
+msgstr "Nebyly nalezeny žádné nové hry"
+
+#: cartridges/importer/importer.py:379
+msgid "1 game imported"
+msgstr "Přidána 1 hra"
+
+#. The variable is the number of games
+#: cartridges/importer/importer.py:383
+msgid "{} games imported"
+msgstr "Přidány {} hry"
+
+#. A single game removed
+#: cartridges/importer/importer.py:387
+msgid "1 removed"
+msgstr "1 odstraněna"
+
+#. The variable is the name of the source
+#: cartridges/importer/location.py:33
+msgid "Select the {} cache directory."
+msgstr "Vyberte adresář {} mezipaměti."
+
+#. The variable is the name of the source
+#: cartridges/importer/location.py:35
+msgid "Select the {} configuration directory."
+msgstr "Vyberte konfigurační adresář {}."
+
+#. The variable is the name of the source
+#: cartridges/importer/location.py:37
+msgid "Select the {} data directory."
+msgstr "Vyberte datový adresář {}."
+
+#: cartridges/importer/retroarch_source.py:129
+msgid "No RetroArch Core Selected"
+msgstr "Žádné RetroArch jádro nevybráno"
+
+#. The variable is a newline separated list of playlists
+#: cartridges/importer/retroarch_source.py:131
+msgid "The following playlists have no default core:"
+msgstr "Tyto seznamy her nemají výchozí jádra:"
+
+#: cartridges/importer/retroarch_source.py:133
+msgid "Games with no core selected were not imported"
+msgstr "Hry bez vybraného jádra nebyly přidány"
+
+#: cartridges/store/managers/sgdb_manager.py:46
+msgid "Couldn't Authenticate SteamGridDB"
+msgstr "Nelze ověřit SteamGridDB"
+
+#: cartridges/store/managers/sgdb_manager.py:47
+msgid "Verify your API key in preferences"
+msgstr "Ověřte váš klíč API v předvolbách"
+
+#~ msgid "Library"
+#~ msgstr "Knihovna"
+
+#~ msgid "Show preferences"
+#~ msgstr "Zobrazit předvolby"
+
+#~ msgid "Shortcuts"
+#~ msgstr "Zkratky"
+
+#~ msgid "Open menu"
+#~ msgstr "Otevřít nabídku"
+
+#~ msgid "Add new game"
+#~ msgstr "Přidat novou hru"
+
+#~ msgid "Import games"
+#~ msgstr "Importovat hry"
+
+#~ msgid "Back"
+#~ msgstr "Zpět"
+
+#, fuzzy
+#~| msgid "Search"
+#~ msgid "Search games"
+#~ msgstr "Vyhledávání"
+
+#, fuzzy
+#~| msgid "Show hidden games"
+#~ msgid "Search hidden games"
+#~ msgstr "Zobrazit skryté hry"
+
+#~ msgid "The title of the game"
+#~ msgstr "Název hry"
+
+#~ msgid "Developer"
+#~ msgstr "Vývojář"
+
+#~ msgid "File to open or command to run when launching the game"
+#~ msgstr "Soubor nebo příkaz pro spuštění hry"
+
+#~ msgid "Confirm"
+#~ msgstr "Potvrdit"

po/el.po

@@ -0,0 +1,715 @@
+# SOME DESCRIPTIVE TITLE.
+# Copyright (C) YEAR kramo
+# This file is distributed under the same license as the Cartridges package.
+# yiannis ioannides <sub@wai.ai>, 2023.
+msgid ""
+msgstr ""
+"Project-Id-Version: Cartridges\n"
+"Report-Msgid-Bugs-To: \n"
+"POT-Creation-Date: 2023-11-17 17:08+0100\n"
+"PO-Revision-Date: 2023-10-08 16:00+0000\n"
+"Last-Translator: yiannis ioannides <sub@wai.ai>\n"
+"Language-Team: Greek <https://hosted.weblate.org/projects/cartridges/"
+"cartridges/el/>\n"
+"Language: el\n"
+"MIME-Version: 1.0\n"
+"Content-Type: text/plain; charset=UTF-8\n"
+"Content-Transfer-Encoding: 8bit\n"
+"Plural-Forms: nplurals=2; plural=n != 1;\n"
+"X-Generator: Weblate 5.1-dev\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 ""
+"gaming;εκκινητής;steam;lutris;heroic;bottles;itch;flatpak;legendary;"
+"retroarch;"
+
+#: 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 ""
+"Οι Κασέτες είναι ένας απλός εκκινητής παιχνιδιών για όλα σας τα παιχνίδια. "
+"Υποστηρίζει την εισαγωγή παιχνιδιών από το Steam, Heroic και άλλες "
+"πλατφόρμες χωρίς σύνδεση να είναι απαραίτητη. Μπορείτε να ταξινομήσετε και "
+"να κρύψετε τα παιχνίδια σας, καθώς και να κατεβάσετε τα εξώφυλλα τους από το "
+"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:127 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:367
+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 "Steam"
+
+#: 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 data/gtk/preferences.blp:326
+msgid "Install Location"
+msgstr "Τοποθεσία εγκατάστασης"
+
+#: data/gtk/preferences.blp:149 data/gtk/window.blp:539
+#: cartridges/importer/lutris_source.py:92
+msgid "Lutris"
+msgstr "Lutris"
+
+#: data/gtk/preferences.blp:170
+msgid "Cache Location"
+msgstr "Τοποθεσία cache"
+
+#: data/gtk/preferences.blp:182
+msgid "Import Steam Games"
+msgstr "Εισαγωγή παιχνιδιών Steam"
+
+#: data/gtk/preferences.blp:186
+msgid "Import Flatpak Games"
+msgstr "Εισαγωγή παιχνιδιών Flatpak"
+
+#: data/gtk/preferences.blp:191 cartridges/importer/heroic_source.py:355
+msgid "Heroic"
+msgstr "Heroic"
+
+#: data/gtk/preferences.blp:212
+msgid "Import Epic Games"
+msgstr "Εισαγωγή παιχνιδιών Epic"
+
+#: data/gtk/preferences.blp:216
+msgid "Import GOG Games"
+msgstr "Εισαγωγή παιχνιδιών GOG"
+
+#: data/gtk/preferences.blp:220
+msgid "Import Amazon Games"
+msgstr "Εισαγωγή παιχνιδιών Amazon"
+
+#: data/gtk/preferences.blp:224
+msgid "Import Sideloaded Games"
+msgstr "Εισαγωγή παιχνιδιών μέσω sideloading"
+
+#: data/gtk/preferences.blp:229 cartridges/importer/bottles_source.py:86
+msgid "Bottles"
+msgstr "Bottles"
+
+#: data/gtk/preferences.blp:251 cartridges/importer/itch_source.py:81
+msgid "itch"
+msgstr "itch"
+
+#: data/gtk/preferences.blp:273 cartridges/importer/legendary_source.py:97
+msgid "Legendary"
+msgstr "Legendary"
+
+#: data/gtk/preferences.blp:295 cartridges/importer/retroarch_source.py:142
+msgid "RetroArch"
+msgstr "RetroArch"
+
+#: data/gtk/preferences.blp:317 cartridges/importer/flatpak_source.py:118
+msgid "Flatpak"
+msgstr "Flatpak"
+
+#: data/gtk/preferences.blp:338
+msgid "Import Game Launchers"
+msgstr "Εισαγωγή εκκινητών παιχνιδιών"
+
+#: data/gtk/preferences.blp:343 cartridges/importer/desktop_source.py:215
+msgid "Desktop Entries"
+msgstr "Εισαγωγές desktop"
+
+#: data/gtk/preferences.blp:355 data/gtk/window.blp:537
+msgid "SteamGridDB"
+msgstr "SteamGridDB"
+
+#: data/gtk/preferences.blp:359
+msgid "Authentication"
+msgstr "Επιβεβαίωση"
+
+#: data/gtk/preferences.blp:362
+msgid "API Key"
+msgstr "Κλειδί API"
+
+#: data/gtk/preferences.blp:370
+msgid "Use SteamGridDB"
+msgstr "Χρήση SteamGridDB"
+
+#: data/gtk/preferences.blp:371
+msgid "Download images when adding or importing games"
+msgstr "Λήψη εικόνων κατά τη διάρκεια πρόσθεσης ή εισαγωγής παιχνιδιών"
+
+#: data/gtk/preferences.blp:375
+msgid "Prefer Over Official Images"
+msgstr "Προτίμηση Επίσημων Εικόνων"
+
+#: data/gtk/preferences.blp:379
+msgid "Prefer Animated Images"
+msgstr "Προτίμηση Κινούμενων Εικόνων"
+
+#: data/gtk/preferences.blp:385
+msgid "Update Covers"
+msgstr "Ανανέωση εξώφυλλου"
+
+#: data/gtk/preferences.blp:386
+msgid "Fetch covers for games already in your library"
+msgstr "Ανάκτηση εξώφυλλων για τα προϋπάρχων παιχνίδια στη βιβλιοθήκη σας"
+
+#: data/gtk/preferences.blp:391
+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 ""
+
+#: data/gtk/window.blp:538
+msgid "ProtonDB"
+msgstr ""
+
+#: data/gtk/window.blp:540
+msgid "HowLongToBeat"
+msgstr ""
+
+#. 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 "Yiannis Ioannides"
+
+#. 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:126
+msgid "All games removed"
+msgstr "Όλα τα παιχνίδια αφαιρέθηκαν"
+
+#: cartridges/preferences.py:174
+msgid ""
+"An API key is required to use SteamGridDB. You can generate one {}here{}."
+msgstr ""
+"Για τη χρήση του SteamGridDB απαιτείται ένα κλειδί API. Μπορείτε να "
+"δημιουργήσετε ένα {}εδώ{}."
+
+#: cartridges/preferences.py:189
+msgid "Downloading covers…"
+msgstr "Λήψη εξώφυλλων…"
+
+#: cartridges/preferences.py:208
+msgid "Covers updated"
+msgstr "Τα εξώφυλλα ανανεώθηκαν"
+
+#: cartridges/preferences.py:343
+msgid "Installation Not Found"
+msgstr "Η εγκατάσταση δεν βρέθηκε"
+
+#: cartridges/preferences.py:344
+msgid "Select a valid directory."
+msgstr "Επιλέξτε έναν έγκυρο προορισμό."
+
+#: cartridges/preferences.py:380 cartridges/importer/importer.py:317
+msgid "Warning"
+msgstr "Προσοχή"
+
+#: cartridges/preferences.py:414
+msgid "Invalid Directory"
+msgstr "Μη έγκυρος προορισμός"
+
+#: cartridges/preferences.py:420
+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 "1 παιχνίδι εισήχθη"
+
+#. 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 "1 αφαιρέθηκε"
+
+#. The variable is the name of the source
+#: cartridges/importer/location.py:33
+msgid "Select the {} cache directory."
+msgstr "Επιλέξτε τον προορισμό cache του {}."
+
+#. 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 "Δεν υπάρχει επιλεγμένος πυρήνας RetroArch"
+
+#. 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 "Επιβεβαιώστε το κλειδί API σας στις ρυθμίσεις"
+
+#~ 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 "Cache Not Found"
+#~ msgid "Directory not Valid"
+#~ msgstr "Τα cache δεν βρέθηκαν"
+
+#, fuzzy
+#~| msgid "Confirm"
+#~ msgid "Configuration"
+#~ msgstr "Επιβεβαίωση"
+
+#~ msgid "Steam Install Location"
+#~ msgstr "Τοποθεσία Εγκατάστασης Steam"
+
+#~ msgid "Lutris Install Location"
+#~ msgstr "Τοποθεσία Εγκατάστασης Lutris"
+
+#~ msgid "Heroic Install Location"
+#~ msgstr "Τοποθεσία Εγκατάστασης Heroic"
+
+#~ msgid "Bottles Install Location"
+#~ msgstr "Τοποθεσία Εγκατάστασης Bottles"
+
+#~ msgid "Today"
+#~ msgstr "Σήμερα"
+
+#~ msgid "Yesterday"
+#~ msgstr "Χθες"
+
+#~ msgid "Select the Lutris cache directory."
+#~ msgstr "Επιλέξτε τη τοποθεσία cache του Lutris."