retroengine

This commit is contained in:
laz 2025-01-07 19:07:39 +01:00
parent 0050e4c188
commit 00dace7f6f
17 changed files with 77 additions and 42 deletions

View file

Before

Width:  |  Height:  |  Size: 29 KiB

After

Width:  |  Height:  |  Size: 29 KiB

View file

Before

Width:  |  Height:  |  Size: 192 KiB

After

Width:  |  Height:  |  Size: 192 KiB

View file

Before

Width:  |  Height:  |  Size: 70 KiB

After

Width:  |  Height:  |  Size: 70 KiB

View file

Before

Width:  |  Height:  |  Size: 56 KiB

After

Width:  |  Height:  |  Size: 56 KiB

View file

Before

Width:  |  Height:  |  Size: 43 KiB

After

Width:  |  Height:  |  Size: 43 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 189 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 45 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 14 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 34 KiB

View file

Before

Width:  |  Height:  |  Size: 99 KiB

After

Width:  |  Height:  |  Size: 99 KiB

View file

Before

Width:  |  Height:  |  Size: 43 KiB

After

Width:  |  Height:  |  Size: 43 KiB

View file

Before

Width:  |  Height:  |  Size: 22 KiB

After

Width:  |  Height:  |  Size: 22 KiB

View file

@ -53,52 +53,26 @@ In doing so we have:
- Rebuilt the `pre_build_automation` script was reworked with additional features.
- Improved logging.
- Implemented changes for the future Godot version of the Configurator.
- RetroDECK Framework can now pick up logged-in Steam profiles for systems like SRM.
<img src="../scott.jpg" width="500">
---
## Launch with RetroDECK (RetroENGINE)
## RetroENGINE - Run with RetroDECK
RetroDECK can be used as an headless engine to run your games.
On the Linux Desktop (or desktop mode), we added the option to open and run various files directly with RetroDECK.
On the Linux Desktop (or desktop mode) we added the option to associate / run / open various games directly with RetroDECK.
<img src="../owr_appselect.png" width="500">
This also comes with the ability to launch the games via CLI.
This is feature is something that have been requested by the wider development community outside of RetroDECK (and maybe a few Linux Wizard Grognards that only want to use CLI for everything).
**Read more here:**
<img src="../owr_infolder.png" width="300">
### Will RetroENGINE detect what system I want to launch?
If you have the game file inside the corresponding roms/<system> folder RetroDECK will understand what system to launch.
**Example:**
A `.nes` file is inside the `retrodeck/roms/nes` folder.
When you click on it, RetroDECK opens it with the Nintendo Entertainment System emulator, and the game starts.
### What if it is not in the correct folder?
<img src="../owr_nonedir.png" width="500">
When clicked, RetroDECK will prompt a dialog window asking which system the file belongs to and then run it.
---
## Launch with games via CLI
You can also launch games directly via CLI with RetroENGINE.
Example syntax:
`flatpak run net.retrodeck.retrodeck retrodeck/roms/<system>/<gamefile>` (`--help` for more information).
This feature have been requested by other developers in the community (or it could be for those Linux Wizard Grognards that only want to use CLI for everything).
[RetroENGINE - Guide](../../wiki_system_guides/retroengine/retroengine-guide.md)
---
@ -145,7 +119,7 @@ One of the goals of PortMaster is to not install or upgrade any existing OS libr
**Note:**
That not all 800+ ports are available for the X86_64 system, but the list keeps growing all the time.
That not all 800+ ports are available for the `X86_64` system, but the list keeps growing all the time.
**Read more here:**
@ -293,9 +267,9 @@ Added: Experimental N3DS core: Panda3DS.
Added: Experimental Playstation 2 core: LRPS2.
```
### RetroDECK Configurator and Framework
### RetroDECK Configurator
<img src="../../../wiki_images/logos/ppsspp-logo.png" width="100">
<img src="../../../wiki_images/logos/8.png" width="100">
```

View file

@ -39,7 +39,7 @@ There are two main directories:
## How-to launch PortMaster?
<img src="../../../wiki_images/portmaster/pm-mainwindow.png" width="800">
<img src="../../../wiki_images/systems/portmaster/pm-mainwindow.png" width="800">
You go into the PortMaster menu in ES-DE and Open `PortMaster`.
@ -51,7 +51,7 @@ You can also manually update it by going to `Options` -> `Update PortMaster` and
## How-to add games to RetroDECK
<img src="../../../wiki_images/portmaster/pm-banana.png" width="800">
<img src="../../../wiki_images/systems/portmaster/pm-banana.png" width="800">
Open `PortMaster` -> `All Ports` and choose the port you want to install (some ports might require additional files).
@ -61,7 +61,7 @@ After you have downloaded the games you want to play exit PortMaster.
In the ES-DE Frontend go to the Utilities Menu
<img src="../../../wiki_images/portmaster/pm-rescan.png" width="800">
<img src="../../../wiki_images/systems/portmaster/pm-rescan.png" width="800">
<img src="../../../wiki_images/esde/esde-utilities.png" width="800">

View file

@ -0,0 +1,58 @@
# RetroENGINE - Run with RetroDECK
<img src="../../../wiki_images/systems/retroengine/re-appselect.png" width="500">
RetroENGINE is how you can run various game files directly with with RetroDECK from the desktop without starting the application.
It allows association of common system file extensions with RetroDECK.
Another option is to run the games directly RetroENGINE via CLI.
This is something that has been requested by the wider development community outside of RetroDECK.
## Will RetroENGINE detect what system I want to launch?
If you have the game file inside the corresponding `retrodeck/roms/<system>/<gamefile>` RetroDECK will understand what system to launch.
### What if it is not in the correct folder?
When clicked, RetroDECK will prompt a dialog window asking which system the file belongs to and then run it.
## Launch with games via CLI
You can also launch games directly with RetroENGINE via CLI.
**Example syntax:**
`flatpak run net.retrodeck.retrodeck retrodeck/roms/<system>/<gamefile>` (`--help` for more information).
## Examples:
<img src="../../../wiki_images/systems/retroengine/littlemedusa.png" width="300">
In these examples, we will use the [Little Medusa - Demo](https://megacatstudios.com/pages/little-medusa) a `.nes` file called `LittleMedusa_8bitdemo.nes` from Mega Cat Studios.
### Example 1: The Game Inside the Correct Roms Folder
<img src="../../../wiki_images/systems/retroengine/re-infolder.png" width="300">
In this example, the `LittleMedusa_8bitdemo.nes` file is inside the `retrodeck/roms/nes` folder.
When you click on it, RetroDECK opens it with the Nintendo Entertainment System emulator, and the game starts.
RetroDECK knows that because you opened it from the `/roms/nes` folder, the game must correspond to that system.
### Example 2: The Game Outside the Roms Folder
<img src="../../../wiki_images/systems/retroengine/re-nonedir.png" width="500">
In this example, the `LittleMedusa_8bitdemo.nes` file is not inside the `retrodeck/roms/nes` folder but in the `download` folder.
When clicked, RetroDECK will prompt a dialog window asking which system the file belongs to and then run it.
### Example 3: Running via CLI
Example full syntax:
`flatpak run net.retrodeck.retrodeck retrodeck/roms/nes/LittleMedusa_8bitdemo.nes`

View file

@ -22,11 +22,11 @@ We have not added support yet for the Flatpak version of Steam.
## How-to enable Steam Sync?
<img src="../../../wiki_images/srm/sync-config.png" width="800">
<img src="../../../wiki_images/systems/srm/sync-config.png" width="800">
You can enable the Steam Sync feature inside the Configurator.
<img src="../../../wiki_images/srm/sync-prompt.png" width="800">
<img src="../../../wiki_images/systems/srm/sync-prompt.png" width="800">
All the games you have marked as favorites in ES-DE (marked with a ⭐) will be Synced to Steam upon application exist with art.
@ -39,7 +39,7 @@ Depending on your device Steam might need to be restarted before the games show
Yes, you can open the entire SRM interface from the Configurator as all other components and tweak to your hearts content.
<img src="../../../wiki_images/srm/srm-window.png" width="800">
<img src="../../../wiki_images/systems/srm/srm-window.png" width="800">
### Help - I broke everything after my tweaking

View file

@ -224,6 +224,9 @@ nav:
- Steam Rom Manager 🚂:
- SRM - General Guide: wiki_system_guides/srm/srm-guide.md
- RetroENGINE 👨‍🔧:
- RetroENGINE - General Guide: wiki_system_guides/retroengine/retroengine-guide.md
- The Controller Vault 🎮:
- Accessibility ♿: