diff --git a/wiki-rtd/docs/wiki_icons/retrodeck/icon-configurator.svg b/wiki-rtd/docs/wiki_icons/retrodeck/icon-configurator.svg index 5df3161..d6f515e 100644 --- a/wiki-rtd/docs/wiki_icons/retrodeck/icon-configurator.svg +++ b/wiki-rtd/docs/wiki_icons/retrodeck/icon-configurator.svg @@ -1,20 +1,18 @@ - - - - - - - - - - - - + + + + + + + + + + - + diff --git a/wiki-rtd/docs/wiki_icons/retrodeck/icon-engine.svg b/wiki-rtd/docs/wiki_icons/retrodeck/icon-engine.svg index 30db9cf..bb77600 100644 --- a/wiki-rtd/docs/wiki_icons/retrodeck/icon-engine.svg +++ b/wiki-rtd/docs/wiki_icons/retrodeck/icon-engine.svg @@ -1,14 +1,18 @@ - - - - - - - + + + + + + + + + + + - + diff --git a/wiki-rtd/docs/wiki_icons/retrodeck/icon-framework.svg b/wiki-rtd/docs/wiki_icons/retrodeck/icon-framework.svg index 95fbb2c..95ced5b 100644 --- a/wiki-rtd/docs/wiki_icons/retrodeck/icon-framework.svg +++ b/wiki-rtd/docs/wiki_icons/retrodeck/icon-framework.svg @@ -1,18 +1,18 @@ - - - - - - - + + + + - - + + + + + - + diff --git a/wiki-rtd/docs/wiki_icons/retrodeck/icon-ponzu.svg b/wiki-rtd/docs/wiki_icons/retrodeck/icon-ponzu.svg new file mode 100644 index 0000000..483a36d --- /dev/null +++ b/wiki-rtd/docs/wiki_icons/retrodeck/icon-ponzu.svg @@ -0,0 +1,18 @@ + + + + + + + + + + + + + + + + + + diff --git a/wiki-rtd/docs/wiki_system_guides/desktop-launch/desktop-launch.md b/wiki-rtd/docs/wiki_system_guides/desktop-launch/desktop-launch.md index 10410fa..eaec71b 100644 --- a/wiki-rtd/docs/wiki_system_guides/desktop-launch/desktop-launch.md +++ b/wiki-rtd/docs/wiki_system_guides/desktop-launch/desktop-launch.md @@ -176,7 +176,7 @@ Change the values of: Type=Application Name=ASTLIBRA Revision Icon=steam_icon_1718570 -Exec=flatpak-spawn --host steam steam://rungameid/1718570 +Exec=flatpak-spawn --host steam -silent steam://rungameid/1718570 Categories=Game ``` @@ -212,28 +212,84 @@ Exec=flatpak-spawn --host flatpak run com.valvesoftware.Steam -silent steam://ru Categories=Game ``` -## How-to: Launch Flatpak Games / Applications +## How-to: Launch Flatpak Games -### Step 1: Create an empty desktop file +You can either copy and edit the desktop files or make your own. + +### Copy and Edit desktop files (Recommended) + +#### Step 1: Find the files + +**Note:** All files here are symlinks, but the export folders contains them all in a conventient way. + +Depending if you how you have installed the application they can either be under: + +- **System Wide:** `/var/lib/flatpak/exports/share/applications/` +- **Local User:** `~/.local/share/flatpak/exports/share/applications/` + +#### Step 2: Show Target + +`Right Click` on the symlinked `.desktop` file in the folder and press `Show Target`. + +This will take you to the real `.desktop` shortcut. + +Example `eu.vcmi.VCMI.desktop`: + +- **System Wide:** `/var/lib/flatpak/app/eu.vcmi.VCMI/current/active/export/share/applications/` +- **Local User:** `~/.local/share/flatpak/app/eu.vcmi.VCMI/current/active/export/share/applications/` + +#### Step 3: Copy the .desktop file + +Copy the `.desktop` file to `retrodeck/roms/windows/` + +#### Step 4: Rename the file + +Rename the file to something more fitting. + +**Examples:** + +`net.openra.OpenRA.desktop` -> `OpenRA.desktop` or `Red Alert.desktop` + +`eu.vcmi.VCMI.desktop` -> `VCMI.desktop` or `Heroes of Might and Magic III.desktop` + +#### Step 5: Edit the file + +Open the `.desktop` file and edit the **Exec=** values so they are changed to `flatpak-spawn --host flatpak run`. + +**Example VCMI.desktop:** + +- **Before:** `Exec=/usr/bin/flatpak run --branch=stable --arch=x86_64 --command=vcmilauncher eu.vcmi.VCMI` +- **After:** `Exec=flatpak-spawn --host flatpak run --branch=stable --arch=x86_64 --command=vcmilauncher eu.vcmi.VCMI` + +### Make your own desktop files + +#### Step 1: Create an empty desktop file First, create the `.desktop` file as mentioned above with the game name and put it in the `retrodeck/roms/windows/` folder. -### Step 2: Go to flathub and get the Run command +#### Step 2: Get the Run Command and Full Flatpak Name. -1. Go to [Flathub](https://flathub.org/). -2. On flathub go to a the application you want to add, press the `Down Arrow` next to `Download Button` to get the `Run command` and `Full Flatpak Name`. +**Find them on Desktop** +Note this was done in KDE + +- `Right Click` in on the Application in the `Application Launcher Menu` and press `Edit Application`. +- `Command-line arguments` should contain the `Full Flatpak Name` and `Run Command`. + +**Find them on Flathub:** + +- Go to [Flathub](https://flathub.org/). +- On flathub go to a the application you want to add, press the `Down Arrow` next to `Download Button` to get the `Run Command` and `Full Flatpak Name`. **Example: OpenRA.desktop** -[OpenRA - Flathub]](https://flathub.org/apps/net.openra.OpenRA) +[OpenRA - Flathub](https://flathub.org/apps/net.openra.OpenRA) - **Run command:** flatpak run net.openra.OpenRA - **Full Flatpak Name:** net.openra.OpenRA - ### Step 3: Populate the .desktop file Open the `.desktop` file and populate it. @@ -266,6 +322,26 @@ Exec=flatpak-spawn --host flatpak run net.openra.OpenRA Categories=Game ``` +## How-to: Launch Native Games + +**W.I.P** + +You can either copy and edit the desktop files or make your own. + +### Copy and Edit desktop files + + +#### Step 1: Find the files + +The desktop files should be located under + +`/usr/share/applications/` + +## How-to: Launch Heroic Games + +**W.I.P** + + ## The Last Step: Launch the Games via RetroDECK & Scrape After the `.desktop` files have been created and everything is working as expected, RetroDECK will recognize the `.desktop` file the next time you start it. The games will appear under the Windows tab in ES-DE. If you have named the games correctly, there is a good chance that the scraper will identify them. diff --git a/wiki-rtd/docs/wiki_system_guides/desktop-launch/openra-app.png b/wiki-rtd/docs/wiki_system_guides/desktop-launch/openra-app.png new file mode 100644 index 0000000..2d437ca Binary files /dev/null and b/wiki-rtd/docs/wiki_system_guides/desktop-launch/openra-app.png differ