Wiki/wiki-rtd/docs/wiki_experiments/steam-lutris-launch/steam-lutris-launch.md

# Launching Lutris & Steam Games from RetroDECK

This is a experiment made by the user **Muraki**

## Prerequisites

**Information:**

Information: This experiment requires the `flatpak-spawn` permission, which breaks the sandbox environment that RetroDECK operates in. Therefore, we do not recommend attempting this unless you are confident in your understanding of the process and its implications.

### Flatpak Spawn Permission

You can enable it by running this command in the terminal.

```
flatpak override --user --talk-name=org.freedesktop.Flatpak net.retrodeck.retrodeck
```

## Folder structure

| Type    | Folder                 |          Comment     | 
|  :---:  | :---:                  |             :---:     |
| Windows Roms Folder | `retrodeck/roms/windows/`   |  |



## How-to Make .desktop files

Make an empty file with the `<gamename>.desktop`.

**Example:** `UltimaI.desktop` and put it into the `retrodeck/roms/windows/` folder.

## How-to: Launch Lutris Games

### 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: Get Identifier and Internal ID

1. Open Lutris.
2. In Lutris, `Right Click` the game -> `Configure` and make a note of your `Internal ID` under `Identifier`.
3. Make a note of the `Identifier` as well.


**Example:** Ultima I

<img src="../lutris.png" width="800">

**Internal ID:** 2

**Identifier:** ultima-i

### Step 3: Populate the .desktop file

Open the Desktop file and copy this entry.

```
[Desktop Entry]
Type=Application
Name=NAMEHERE
Icon=lutris_IDENTIFIERHERE
Exec=env LUTRIS_SKIP_INIT=1 flatpak-spawn --host lutris lutris:rungameid/INTERNALIDHERE
Categories=Game
```

Change the values to the `Game Name`, `Internal ID`, `Identifier`

Name= NAMEHERE
Icon= lutris_IDENTIFIERHERE
Exec= rungameid/INTERNALIDHERE

**Example: Ultima 1**

```
[Desktop Entry]
Type=Application
Name=Ultima I
Icon=lutris_ultima-i
Exec=env LUTRIS_SKIP_INIT=1 flatpak-spawn --host lutris lutris:rungameid/2
Categories=Game
```

### Step 4: Start RetroDECK

If all is working as excepted RetroDECK will now pickup the .desktop file next time you start.


## How-to: Launch Steam Games 

### 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: Get the Steam AppID

1. Open Steam.
2. In Steam, go to `Library` -> `Right Click` the game -> `Properties` -> `Updates`.
3. Make a note of the `AppID`.


**Example:** ASTLIBRA Revision

<img src="../steam.png" width="800">

**App ID:** 1718570


### Step 3: Populate the .desktop file

Open the Desktop file and copy this entry.

```
[Desktop Entry]
Type=Application
Name=G NAMEHERE
Icon=steam_APPIDHERE
Exec=flatpak-spawn --host steam steam://rungameid/APPIDHERE
Categories=Game
```

Change the values to the `Game Name`, `Internal ID`, `Identifier`

Name= NAMEHERE
Icon= steam_APPIDHERE
Exec= rungameid/APPIDHERE

**Example: Ultima 1**

```
[Desktop Entry]
Type=Application
Name=ASTLIBRA Revision
Icon=steam_1718570
Exec=flatpak-spawn --host steam steam://rungameid/1718570
Categories=Game
```

### Step 4: Start RetroDECK

If all is working as excepted RetroDECK will now pickup the .desktop file next time you start.