noctra/Jackify
1
0
Fork 0
mirror of https://github.com/Omni-guides/Jackify.git synced 2026-01-17 19:47:00 +01:00
Code Issues Packages Projects Releases Wiki Activity

Updated SyncToDeck (markdown)

Omni-guides
2025-01-25 22:17:11 +00:00
parent fbf7715532
commit e638719ed1
1 changed files with 157 additions and 18 deletions
Download Patch File Download Diff File Expand all files Collapse all files

175
SyncToDeck.md

@@ -1,28 +1,20 @@
<img src="https://github.com/Omni-guides/Wabbajack-Modlist-Linux/blob/main/images/WabbajackLinux/WabbajackLinuxBanner.png" width="1000">
# How to transfer files to Steam Deck
# How to transfer files to Steam Deck (New Install & Modlist Update)
There are many (many) ways to copy data to your Steam Deck. From USB drives to graphical tools or command line options, there are many more ways than those I list below. If you have a preferred method that works, by all means stick with that.
### My personal choice - Rsync over SSH using MobaxTerm
My personal choice. While rsync is a command line tool, it is very powerful and I prefer it because it can be used to synchronise two directories so they are identical, including removing files in the destination that are no longer in the source. This is particularly useful when updating a Wabbajack Modlist that you already have on the Steam Deck. Alternative methods like those below dont have a great way of making sure the two directories are identical. They are great for copying data from PC to Deck, sure, but what happens if a mod has been deleted from a modlist in the latest version? Simply copying and pasting the new version of the modlist over the top of the existing old version will get the new changes, but it *won't* remove anything that is no longer present in the new version.
_**PLEASE NOTE:** I cannot be held responsible for anything negative that happens if you use the following method incorrectly for your system or file paths._
For that reason, my preferred method is to use rsync. Windows does not have rsync command line by default, but you can still use this wonderful tool with an additional application on Windows. There are a few Windows apps that will do this for you, my favourite is MobaXTerm, which has a 'free for personal use' version.
_**PLEASE NOTE: I cannot be held responsible for anything negative that happens if you use the following method incorrectly for your system or file paths._
To accomplish the following steps, you will need to have already set a password for the deck user on your Steam Deck. If you haven't already done so, you can follow Valve's guidance:
For all methods described here, you will need to have already set a password for the deck user on your Steam Deck. If you haven't already done so, you can follow Valve's guidance:
<img src="https://github.com/Omni-guides/Wabbajack-Modlist-Linux/blob/main/images/SyncToDeck/SyncToDeck_SteamPasswd.png" width="800">
## Enable SSH on the Steam Deck
### Enable SSH on the Steam Deck
Rsync uses the SSH (remote access) protocol to conenct two systems and transfer the data. By default SSH is not enabled on the Steam deck - if you haven't already done so, by running the following command in a konsole terminal window on your deck, you can enable it forever more:
Rsync uses the SSH (remote access) protocol to connect two systems and transfer the data. By default SSH is not enabled on the Steam deck - if you haven't already done so, by running the following command in a konsole terminal window on your deck, you can enable it forever more:
```
sudo systemctl enable --now sshd
@@ -32,7 +24,152 @@ You will be prompted to enter you 'deck' user password.
<img src="https://github.com/Omni-guides/Wabbajack-Modlist-Linux/blob/main/images/SyncToDeck/SyncToDeck_enableSSH.png" width="800">
## MobaXterm on Windows
## Option 1 (Recommended): WinSCP - a free file manager for Windows supporting FTP, SFTP, S3 and WebDAV.
Download WinSCP from [here](https://winscp.net/eng/download.php) on your Windows system.
Once downloaded, install it, then open WinSCP, you will be presented with a Login Configuration window.
<img src="https://github.com/Omni-guides/Wabbajack-Modlist-Linux/blob/main/images/SyncToDeck/SyncToDeck_WinSCP_LoginConfig.png" width="600">
Keep "SFTP" selected as the File protocol, enter the IP Address of your Steam Deck in the "Host name" text box. Keep the port as 22, and enter "deck" as the User name. You can leave the password box blank for now.
You may wish to Save the connection details for future use, but that is optional.
Once your Login details match the screenshot (your IP Address will be different), click the Login button.
The first connection from WinSCP to you Deck will likely prompt you to accept the host key - simply click the "Accept" button:
<img src="https://github.com/Omni-guides/Wabbajack-Modlist-Linux/blob/main/images/SyncToDeck/SyncToDeck_WinSCP_AcceptKey.png" width="600">
The SFTP connection from your Windows system to your Deck will be initiated, and you will be prompted to enter the password for the "deck" user on your Steam Deck:
<img src="https://github.com/Omni-guides/Wabbajack-Modlist-Linux/blob/main/images/SyncToDeck/SyncToDeck_WinSCP_LoginPassword.png" width="600">
Enter the password and click OK. All being well, you should be presented with a "Dual Browser" window, which displays your Windows filesystem on the left, and your Steam Deck filesystem on the right.
At this point, the steps differ slightly depending on if you are copying Tuxborn to the Deck for the first time, or if you are updating an existing copy of Tuxborn already on the Deck. If you are updating Tuxborn, then follow the steps [here](https://github.com/Omni-guides/Wabbajack-Modlist-Linux/wiki/SyncToDeck/#updating-tuxborn), otherwise, continue with the following.
### New Tuxborn Install
If this is the first time you are transferring Tuxborn from your Windows system to the Deck, you will need to browse to your Tuxborn folder on Windows (left hand side), and browse to the path you want to copy. If needed you can right click on the right hand browser (Deck) and create a new folder.
For example, on my Windows system, I browse to the following:
```
D:\Games\WabbajackGames\Tuxborn
```
And on the Steam Deck side (right hand side), I navigate to:
```
/home/deck/Games/Skyrim/Tuxborn
```
<img src="https://github.com/Omni-guides/Wabbajack-Modlist-Linux/blob/main/images/SyncToDeck/SyncToDeck_WinSCP_NewInstallBrowser.png" width="600">
Once you have the two Tuxborn directories open on Windows and Deck, click the "Synchronize" button in the top right:
<img src="https://github.com/Omni-guides/Wabbajack-Modlist-Linux/blob/main/images/SyncToDeck/SyncToDeck_WinSCP_SyncButton.png" width="600">
Given that the Tuxborn directory on the Deck is empty, you can leave the most of the default settings as they are, just make sure that "Remote" is selected for the "Direction/Target directory":
<img src="https://github.com/Omni-guides/Wabbajack-Modlist-Linux/blob/main/images/SyncToDeck/SyncToDeck_WinSCP_NewInstallSyncSettings.png" width="600">
Once you have these settings in place, click OK to start the comparison phase. You may get a popup regarding opening a separate shell session.
<img src="https://github.com/Omni-guides/Wabbajack-Modlist-Linux/blob/main/images/SyncToDeck/SyncToDeck_WinSCP_SeparateShell.png" width="600">
This is fine to accept, so click OK. WinSCP will begin comparing the source and target directories:
<img src="https://github.com/Omni-guides/Wabbajack-Modlist-Linux/blob/main/images/SyncToDeck/SyncToDeck_WinSCP_SyncComparing.png" width="600">
After a few minutes, a report will be displayed listing the changes that WinSCP will carry out if you proceed:
<img src="https://github.com/Omni-guides/Wabbajack-Modlist-Linux/blob/main/images/SyncToDeck/SyncToDeck_WinSCP_SyncCompareReport.png" width="600">
For a new Tuxborn install, this is going to essentially report that it will be copying everything from the Windows system, to the Deck. Click OK in the top right to accept these actions and start the transfer process:
<img src="https://github.com/Omni-guides/Wabbajack-Modlist-Linux/blob/main/images/SyncToDeck/SyncToDeck_WinSCP_SyncStart.png" width="600">
How long this process takes will depend on how much data needs to be synchronised, and how fast your connection between Windows system and Steam Deck is. Eventually it will finish. Once it has, you will need to return to the main Tuxborn Install guide, for the next steps - rejoin it [here](https://github.com/Omni-guides/Tuxborn/blob/main/TuxbornSteamDeckFullInstall.md#step-3---post-wabbajack-steps) and complete all of the remaining steps. After that, you should be able to start Tuxborn from steam, and get back to playing!
---
---
### Updating Tuxborn
If you already have Tuxborn installed on your Deck and are just updating it, follow these steps.
On each side of the Dual Browsers, navigate to your Tuxborn directory. For example on my Windows system (left hand side) I navigate to:
```
D:\Games\WabbajackGames\Tuxborn
```
And on the Steam Deck side (right hand side), I navigate to:
```
/home/deck/Games/Skyrim/Tuxborn
```
<img src="https://github.com/Omni-guides/Wabbajack-Modlist-Linux/blob/main/images/SyncToDeck/SyncToDeck_WinSCP_DualBrowser.png" width="600">
Once you have the two Tuxborn directories open on Windows and Deck, click the "Synchronize" button in the top right:
<img src="https://github.com/Omni-guides/Wabbajack-Modlist-Linux/blob/main/images/SyncToDeck/SyncToDeck_WinSCP_SyncButton.png" width="600">
A new window will pop up, allowed you to alter the settings for the synchronisation. Set them as follows, while double checking that the "Local directory" and "Remote directory" folder paths at the top are correct:
<img src="https://github.com/Omni-guides/Wabbajack-Modlist-Linux/blob/main/images/SyncToDeck/SyncToDeck_WinSCP_SyncSettings.png" width="600">
The important settings to use here are:
Direction/Target directory: Remote - This sets whether the Remote system (Deck) is the destination for the date, rather than the other way around.
Mode: Mirror files - This setting tells WinSCP to make sure that the target (Deck) directory is **identical** to the source (Windows).
Synchronize options: Delete Files - This allows WinSCP to remove things on the Deck
version of Tuxborn, that are not present on the Windows system.
Preview changes - This feature will display a report of what actions WinSCP will carry out if you proceed. This can be good to just double check you have the right directories selected, and nothing unexpected is about to take place. It will show you which files are being updated, which will be removed, and which are new files that will be transferred.
Comparison criteria: Checksum - While this is a slower method of comparing the Windows Tuxborn and existing Deck Tuxborn directories, it is the best way to ensure that the Deck copy ends up **identical** to the Windows copy.
Once you have these settings in place, click OK to start the comparison phase. You may get a popup regarding opening a separate shell session.
<img src="https://github.com/Omni-guides/Wabbajack-Modlist-Linux/blob/main/images/SyncToDeck/SyncToDeck_WinSCP_SeparateShell.png" width="600">
This is fine to accept, so click OK. WinSCP will begin comparing the source and target directories:
<img src="https://github.com/Omni-guides/Wabbajack-Modlist-Linux/blob/main/images/SyncToDeck/SyncToDeck_WinSCP_SyncComparing.png" width="600">
After a few minutes, a report will be displayed listing the changes that WinSCP will carry out if you proceed:
<img src="https://github.com/Omni-guides/Wabbajack-Modlist-Linux/blob/main/images/SyncToDeck/SyncToDeck_WinSCP_SyncCompareReport.png" width="600">
Have a quick check through the list of actions in the report, and if you are ready to start the sync, click OK in the top right.
WinSCP will now begin synchronizing the data:
<img src="https://github.com/Omni-guides/Wabbajack-Modlist-Linux/blob/main/images/SyncToDeck/SyncToDeck_WinSCP_SyncStart.png" width="600">
How long this process takes will depend on how much data needs to be synchronised, and how fast your connection between Windows system and Steam Deck is. Eventually it will finish. Once it has, you will need to rerun the Automated Install Script from the main Tuxborn Install guide, so rejoin it [here](https://github.com/Omni-guides/Tuxborn/blob/main/TuxbornSteamDeckFullInstall.md#34-automated-install-script) and complete all of step 3. After that, you should be able to start Tuxborn from steam, and get back to playing!
---
## Option 2: Rsync over SSH using MobaxTerm
While rsync is a command line tool, it is very powerful that can be used to synchronise two directories so they are identical, including removing files in the destination that are no longer in the source. This is particularly useful when updating a Wabbajack Modlist that you already have on the Steam Deck.
Windows does not have rsync command line by default, but you can still use this wonderful tool with an additional application on Windows. There are a few Windows apps that will do this for you, my favourite is MobaXTerm, which has a 'free for personal use' version.
### MobaXterm on Windows
You can download the MobaXterm application here: [MobaXTerm](https://mobaxterm.mobatek.net/download-home-edition.html)
@@ -56,11 +193,13 @@ rsync -arvP --delete /drives/c/Wabbajack/Skyrim/Tuxborn/* deck@steamdeck:/home/d
* The important part for *updating a modlist*, is the use of the `--delete` flag. This will *delete anything present in the Destination directory* (i.e. on the Steam Deck), that **isn't** in the Source directory on Windows. That means game saves, Custom character presets, or mods no longer in the modlist will be removed, unrecoverably. But.. this will be far quicker than fully deleting the Modlist and copying it over from scratch.
### Conclusion
---
## Conclusion
As ever, please use the above information at your own risk. If you are unsure, I am usually around in the #unofficial-linux-help channel of the Official Wabbajack Discord, so you may be better to ask for guidance *before* you proceed.
In the future, I will try to make time to include guides for how to use alternative tools such as Warpinator, WinSCP, or any other alternatives that would be useful.
[![ko-fi](https://ko-fi.com/img/githubbutton_sm.svg)](https://ko-fi.com/D1D8H8WBD)