Version History

This commit is contained in:
Lazorne 2023-11-29 12:50:16 +01:00
parent 1eb2569e78
commit c002cd642a
3 changed files with 28 additions and 29 deletions

View file

@ -1,24 +1,19 @@
# How do I move RetroDECK to a new device?
# How do I move RetroDECK to a new device
### Prerequisites: Before you move
- Make sure you are running the latest version of RetroDECK on the old device and have started it at least once.
- If your device has a battery like a Steam Deck or Laptop, make sure it has enough charge to complete the file transfer. We recommend you are plugged in while doing this to prevent data loss.
**NOTE:**
If you old device is broken but you still have access to the data you can skip this step.
- If your device has a battery like a Steam Deck or Laptop, make sure it has enough charge to complete the file transfer. We recommend you are plugged in while doing this to prevent data loss
- **NOTE:** If you old device is broken but you still have access to the data you can skip this step.
# Quickguides:
## Quickguides
## Ultra Quickguide:
### Ultra Quickguide
1. Just copy the `~/retrodeck` folder to the new device to the location you want it.
2. Install RetroDECK on the new device and point to it the new location of `~/retrodeck` during first setup.
3. Proceed installation as normal.
## Quickguide - Steam Deck:
### Steam Deck
1. Put the Steam Deck into Desktop Mode `Steam button` > `Power` > `Switch to Desktop`.
2. Back up existing the RetroDECK `~/retrodeck` folder .
3. On the new Steam Deck install RetroDECK on your [from the Discover store](#step-2-install-from-discover).
@ -28,7 +23,7 @@ If you old device is broken but you still have access to the data you can skip t
After that you can keep following following the installation guide [[Steam Deck: Installation and updates]] if you are unsure on progress the installation.
## Quickguide - Linux Desktop:
### Linux Desktop
1. Back up existing the RetroDECK `~/retrodeck` folder .
2. On the new PC install RetroDECK from flathub via your application manager.
3. Do not launch RetroDECK on your new device until you have copied over the backed up folders.
@ -37,7 +32,9 @@ After that you can keep following following the installation guide [[Steam Deck:
After that you can keep following following the installation guide [[Linux Desktop: Installation and updates]] if you are unsure on progress the installation.
# Information on moving RetroDECK:
## Indepth Guide
### Information on moving RetroDECK
RetroDECK contains mainly two folders:
@ -49,7 +46,7 @@ The location of the folder is where you have chosen to install it like `/home/re
This is the location of the core flatpak, emulator files and configurations.
## Two ways to move RetroDECK:
## Two ways to move RetroDECK
What follows is a short comparison on the two ways to move RetroDECK.
@ -76,15 +73,15 @@ What follows is a short comparison on the two ways to move RetroDECK.
* All custom emulator settings you have made are moved.
# How to: move from a old Steam Deck to a new Steam Deck?
## How to: move from a old Steam Deck 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.
## Recommended way: Only move `~/retrodeck`
### Recommended way: Only move `~/retrodeck`
### Step 1: Back up your existing files
#### Step 1: Back up your existing files
You will need to backup the the main `~/retrodeck` folder.
- First put the Steam Deck into Desktop Mode `Steam button` > `Power` > `Switch to Desktop`.
@ -94,20 +91,20 @@ You will need to backup the the main `~/retrodeck` folder.
- Copy the whole folder `~/retrodeck` to a device used for transfer such as a thumb drive, microSD Card, NAS, SFTP and get the files to the new Steam Deck. Or use a transfer software like warpinator to send the folder to the new Steam Deck via network.
### Step 2: Install RetroDECK on your new Steam Deck
#### Step 2: Install RetroDECK on your new Steam Deck
- Follow steps 1 and 2 of the installation guide over at: [[Steam Deck: Installation and updates]] but stop after Step 2 and do not open RetroDECK yet!
### Step 3: Restore your backed up files
#### Step 3: Restore your backed up files
- Copy over the `~/retrodeck` to the new device via any of the chosen methods from step 1.
- Launch RetroDECK on the new device and point towards the `~/retrodeck` location during installation. So if you have moved the `~/retrodeck` to the SD card of the new Steam Deck choose the SD card option during initial install, if you have moved it to the internal storage choose that option or third chose the custom option.
- Keep following the [[Steam Deck: Installation and updates]] as normal.
## Other way: Move `.var/ files` and `~/retrodeck`
### Other way: Move `.var/ files` and `~/retrodeck`
This is not recommended, but if you know what you are doing you could try this way.
### Step 1: Back up your existing files
#### Step 1: Back up your existing files
You will need to backup two directories: the main `~/retrodeck` folders and a hidden `~/.var/app/net.retrodeck.retrodeck` folder.
- First put the Steam Deck into Desktop Mode `Steam button` > `Power` > `Switch to Desktop`.
@ -122,7 +119,7 @@ You will need to backup two directories: the main `~/retrodeck` folders and a hi
- 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/` and copy the whole folder it to device used for transfer such as a thumb drive, microSD Card, NAS, SFTP and get the files to the new Steam Deck. Or use a transfer software like warpinator to send the folder to the new Steam Deck via network.
### Step 2: Install RetroDECK on your new Steam Deck
#### Step 2: Install RetroDECK on your new Steam Deck
- Follow steps 1 and 2 of the installation guide over at: [[Steam Deck: Installation and updates]] but stop after Step 2 and do not open RetroDECK yet!
### Step 3: Restore your backed up files

View file

@ -0,0 +1,3 @@
# RetroDECK v0.8.0b - Bonzai Banana
**Release Date: TBA**

View file

@ -1,6 +1,6 @@
site_name: RetroDECK Wiki
nav:
- Home: index.md
- Wiki Home 🏠: index.md
- General Information 📰:
- What is RetroDECK?: wiki_general/what-is-retrodeck.md
- What is included in RetroDECK?: wiki_general/what-is-included.md
@ -8,17 +8,16 @@ nav:
- The RetroDECK Beta: wiki_general/beta-period.md
- Known Issues: wiki_general/known-issues.md
- FAQ and How-to's ❔:
- FAQ - Frequently Asked Questions: wiki_faq_howto/faq.md
- Community 💬:
- Community & Helping ❤️:
- Discord: wiki_community/discord.md
- Lemmy/Reddit: wiki_community/lemmy-reddit.md
- How to Contribute to RetroDECK?: wiki_helping/contibute-rd
- How to help out with testing?: wiki_helping/testing-rd.md
- FAQ and How-to's ❔:
- FAQ - Frequently Asked Questions: wiki_faq_howto/faq.md
- Move RetroDECK to a new device: wiki_faq_howto/howto-move-retrodeck.md
- Development🔎:
- Current Version: wiki_rd_versions/version_0.7b/0.7.4b/
- Version History (Patchnotes): wiki_rd_versions/version-history.md