From 48ba11ce6d1968bf657dc8d9eaf1c771dd69863e Mon Sep 17 00:00:00 2001 From: Adam Iannazzone <46025473+jiannazzone@users.noreply.github.com> Date: Thu, 16 Nov 2023 21:30:56 -0500 Subject: [PATCH 1/4] Add instructions for moving installation --- .../Steam-Deck-Installation-and-updates.md | 43 ++++++++++++++++++- 1 file changed, 42 insertions(+), 1 deletion(-) diff --git a/wiki-rtd/Steam-Deck-Installation-and-updates.md b/wiki-rtd/Steam-Deck-Installation-and-updates.md index 99d9ed53..72734548 100644 --- a/wiki-rtd/Steam-Deck-Installation-and-updates.md +++ b/wiki-rtd/Steam-Deck-Installation-and-updates.md @@ -66,4 +66,45 @@ This feature can be turned off inside the `RetroDECK Configurator`. - Open the Discover application. - Click on the updates tab. - If there are any updates available it will be shown here. -- Click on the `Update` or `Update all` buttons. \ No newline at end of file +- Click on the `Update` or `Update all` buttons. + + + +# How do I move my installation to a new Steam Deck? + +**Note:** depending on how comfortable you are using the Steam Deck controller to navigate the desktop environment, this may be easier to do with a connected mouse and keyboard. + +The general process is as follows: +1. Put the Steam Deck into Desktop Mode `Steam button` > `Power` > `Switch to Desktop`. +2. Back up existing RetroDECK files. +3. Install RetroDECK on your new Steam Deck [from the Discover store](#step-2-install-from-discover). +4. Before starting RetroDECK, restore files that were backed up in Step 1. +5. Start RetroDECK. + +### Step 1: Back up your existing files +You will need to backup two directories: the main `retrodeck` folders and a hidden `net.retrodeck.retrodeck` folder. + +- First put the Steam Deck into Desktop Mode `Steam button` > `Power` > `Switch to Desktop`. +- Main `retrodeck` folder + - Open the Dolphin File Manager (the folder icon in the taskbar). + - Navigate to `/home/retrodeck/`. This folder should contain sub-folders such as `bios`, `roms`, and `saves`. + - Copy all contents of this directory to a folder on another device, such as a thumb drive, microSD Card, or NAS +- Hidden `net.retrodeck.retrodeck` folder + - Return to `home` + - Find the "hamburger" menu button (three horizontal lines in the top-right). Open the menu and select `Show Hidden Files`. If on a keyboard, you can type `Ctrl+H`. + - Navigate to `home/.var/app/net.retrodeck.retrodeck/`. Again, copy all contents of this directory to a folder another device, such as a thumb drive, microSD Card, or NAS. +- Ensure that you are keeping your backups of these two directories in two separate folders. + +### Step 2: Install RetroDECK on your new Steam Deck +- Follow steps 1 and 2 of the [standard installation guide](#step-2-install-from-discover). +- Stop after Step 2. +- **Do not open RetroDECK yet!** + +### Step 3: Restore your backed up files +- Restore your backed up contents of `retrodeck` to `/home/retrodeck/` on the new device. +- Restore your backed up contents of `net.retrodeck.retrodeck` to `home/.var/app/net.retrodeck.retrodeck/` on the new device. +- In both cases, you can safely overwrite all existing files. + +### Step 4: Return to Game Mode and launch RetroDECK +- Launch RetroDECK from Game Mode and continue with steps 3 and 4 of the [standard installation guide](#step-4-optional-extras). +- Don't forget to install the official controller profile! \ No newline at end of file From 3d1c0cff90db04ec516d0edd6461ec57871172af Mon Sep 17 00:00:00 2001 From: XargonWan Date: Fri, 17 Nov 2023 21:49:10 +0100 Subject: [PATCH 2/4] APPDATA: removed dot from the summary --- net.retrodeck.retrodeck.appdata.xml | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/net.retrodeck.retrodeck.appdata.xml b/net.retrodeck.retrodeck.appdata.xml index 9315bf73..046c58d7 100644 --- a/net.retrodeck.retrodeck.appdata.xml +++ b/net.retrodeck.retrodeck.appdata.xml @@ -4,7 +4,7 @@ net.retrodeck.retrodeck net.retrodeck.retrodeck.desktop RetroDECK - RetroDECK brings an environment to catalog and play your retro games directly on your Steam Deck. + RetroDECK brings an environment to catalog and play your retro games directly on your Steam Deck RetroDECK Team https://retrodeck.net https://github.com/XargonWan/RetroDECK/issues From e04dea7e0c9b7de94b40efb713f3a725bb5164da Mon Sep 17 00:00:00 2001 From: XargonWan Date: Fri, 17 Nov 2023 21:53:12 +0100 Subject: [PATCH 3/4] Fixed es_systems that was preventing the correct generation of the system folders --- es-configs/es_systems.xml | 6 ++++-- 1 file changed, 4 insertions(+), 2 deletions(-) diff --git a/es-configs/es_systems.xml b/es-configs/es_systems.xml index 0909a042..f41ea160 100644 --- a/es-configs/es_systems.xml +++ b/es-configs/es_systems.xml @@ -242,16 +242,18 @@ atarijaguar atarijaguar + - + %STARTDIR%=%EMUDIR% %PRECOMMAND_WINE% %EMULATOR_BIGPEMU-WINDOWS% %ROM% + %STARTDIR%=%EMUDIR% %PRECOMMAND_PROTON% %EMULATOR_BIGPEMU-WINDOWS% %ROM% atarijaguarcd atarijaguarcd +--> atarilynx Atari Lynx From 6e626d63abbb4234eb9992026fb317f6078edf1b Mon Sep 17 00:00:00 2001 From: XargonWan Date: Fri, 17 Nov 2023 21:53:34 +0100 Subject: [PATCH 4/4] Preparing hotfix 0.7.4b [skip ci] --- net.retrodeck.retrodeck.appdata.xml | 13 +++++++++++++ net.retrodeck.retrodeck.yml | 4 ++-- 2 files changed, 15 insertions(+), 2 deletions(-) diff --git a/net.retrodeck.retrodeck.appdata.xml b/net.retrodeck.retrodeck.appdata.xml index 046c58d7..8dc5202a 100644 --- a/net.retrodeck.retrodeck.appdata.xml +++ b/net.retrodeck.retrodeck.appdata.xml @@ -65,6 +65,19 @@ GPL-3.0 CC0-1.0 + + https://github.com/XargonWan/RetroDECK/releases/tag/0.7.4b + +

Hotfix:

+
    +
  • Fixed a bug where the system folders were not correctly generated
    • +
+

Known issues:

+
    +
  • Please check the know issues in the Wiki under General Infomration.
    • +
+ + https://github.com/XargonWan/RetroDECK/releases/tag/0.7.3b diff --git a/net.retrodeck.retrodeck.yml b/net.retrodeck.retrodeck.yml index 4a0c82f7..3b475f7a 100644 --- a/net.retrodeck.retrodeck.yml +++ b/net.retrodeck.retrodeck.yml @@ -86,9 +86,9 @@ modules: build-commands: - | - # on main please update this with the version variable, eg: VERSION='0.7.3b' + # on main please update this with the version variable, eg: VERSION='0.7.4b' # on cooker will be THISBRANCH - VERSION=0.7.3b + VERSION=THISBRANCH git checkout ${GITHUB_REF_NAME}