From 1eae9c97358dda41b3a22170c1975bd17d256c09 Mon Sep 17 00:00:00 2001 From: Omni-guides <110171124+Omni-guides@users.noreply.github.com> Date: Tue, 10 Sep 2024 09:59:29 +0100 Subject: [PATCH] Updated Wabbajack on Linux via Wine (markdown) --- Wabbajack-on-Linux-via-Wine.md | 80 ++++++++++++++++++++++------------ 1 file changed, 52 insertions(+), 28 deletions(-) diff --git a/Wabbajack-on-Linux-via-Wine.md b/Wabbajack-on-Linux-via-Wine.md index 1b2df9d..cb8ed1b 100644 --- a/Wabbajack-on-Linux-via-Wine.md +++ b/Wabbajack-on-Linux-via-Wine.md @@ -2,34 +2,44 @@ ## Introduction -This is all unofficial, please don't ask for support from Wabbajack Support staff in the way you would if you have an issue running Wabbajack on Windows, instead please seek assistance from the #unofficial-linux-help channel on the Official Wabbajack Discord. There have been many users involved at various stages of getting things this far, and a lot of trial and error and testing has been done before things were repeatable enough to form into a guide and offer it as an option for those running Linux as their primary OS - most recently Sulfur Nitride and blejusca on the Official Wabbajack Discord, but many, many more over the time. Thanks to all involved for getting this far! +This is all unofficial, please don't ask for support from Wabbajack Support staff in the way you would if you have an issue running Wabbajack on Windows, instead please seek assistance from the #unofficial-linux-help channel on the Official Wabbajack Discord. There have been many users involved at various stages of getting things this far, and a lot of trial and error and testing has been done before things were repeatable enough to form into a guide and offer it as an option for those running Linux as their primary OS - most recently Sulfur Nitride, blejusca, Ouroboros and trawzified on the Official Wabbajack Discord, but many, many more over the time. Thanks to all involved for getting this far! + +As with my other guides, they may look longer and more involved than the steps actually are - this is to try and be as clear as possible, step by step. + +Sulur Nitride is also working on a YouTube video to cover the set up, which I will link here as soon as it is ready. ## Wabbajack on Linux, via Wine -Thanks to advancements with Wine, it now appears that running Wabbajack on Linux is a viable option - though please understand that there won't be any guarantee of 100% compatibility. As it stands, it's 'good enough' to be able to install a Wabbajack modlist. Starting with Wine v9.16, it seems that only a few steps are required to successfully run the Wabbajack application, and be able to login to Nexusmods, then download and install a modlist. +Thanks to advancements with Wine, it now appears that running Wabbajack on Linux is a viable option - though please understand that there won't be any guarantee of 100% compatibility. As it stands, it's 'good enough' to be able to install a Wabbajack modlist. Starting with Wine v9.16, it seems that only a few steps are required to successfully run the Wabbajack application, login to Nexusmods via the GUI, then download and install a modlist. -There are many ways to do this, and more experienced users may have their preferred way, but this guide should help those unsure, and at least give some guidance to others. +There are many ways to carry out the steps required, and more experienced users may have their preferred way (for example command line vs gui), but this guide should help those unsure, and at least give some guidance to others. -We have so far confirmed success on the following Linux Distributions - blah blah blah. Ubuntu and derivitives such as Pop_OS, Mint, etc, need some additional steps, outlined below in . +We have so far confirmed success on various distros, such as: -PLEASE NOTE: Use this guide at your own risk. damage to your system caused by following the steps of this guide either correctly or incorrectly are done so with this understanding. You could always carry out the steps in a VM to test for your distro without altering your base system. +**Arch based:** Arch, CachyOS, +**Fedora based:** Fedora, Nobara, Ultramarine, Bazzite +**Others:** OpenSUSE Tumbelweed. + +The same steps will likely work on other distros too! Please let me know if you have success on a distro that isn't listed here, so I can add it to the list. Ubuntu and derivatives such as Pop_OS, Mint, etc, need some additional steps, outlined below in . + +**PLEASE NOTE: Use this guide at your own risk. damage to your system caused by following the steps of this guide either correctly or incorrectly are done so with this understanding. You could always initially carry out the steps in a VM to test for your distro without altering your base system.** --- ### Step 1 - Wine/System Requirements -Wine 9.16 or newer and winetricks, installed via your package manager. See below for Ubuntu-based distros, or if your distro also doesn't have wine 9.16 or above via the standard repos. +Wine 9.16 or newer and winetricks, installed via your package manager. See below for Ubuntu-based distros, or if your distro also doesn't have wine 9.16 or above via the standard repos. -You can check what wine version your system has currerntly by running the following in a terminal: +You can check which wine version your system has currently by running the following in a terminal: ``` wine --version ``` -If the command returns wine-9.16 or above, you should be good to go. If not, check for system updates, or check if you have an alternative version of wine in your package manager - for example wine-staging or wine-development. +If the command returns wine-9.16 or above, you should be good to go. If not, check for system updates, or check if you have an alternative version of wine available via your package manager - for example wine-staging or wine-development. -You will also need to install winetricks from your system package maanger, if it is not already installed. +You will also need to install winetricks from your system package manager, if it is not already installed. --- @@ -37,23 +47,37 @@ You will also need to install winetricks from your system package maanger, if it While not required, I strongly recommend you create a directory to use for Wabbajack, just to keep things in a sensible place and together. You can use a file browser or cli to create this new directory - for this guide I will use /home/omni/Wabbajack. +``` +mkdir /home/omni/Wabbajack +``` + --- ### Step 3 - Download the required installers -There are two applications we need to get things running - Wabbajack itself, and the Edge Webview installer that we will need to manually install in the next steps. While it doesn't need to exist in our new Wabbajac directory, I tend to store the WebView installer there anyway, to keep things contained. +There are two applications we need to get things running - [Wabbajack](https://www.wabbajack.org/) itself, and the [Edge Webview2 Installer (Evergreen Standalone Installer)](https://developer.microsoft.com/en-gb/microsoft-edge/webview2/?form=MA13LH#download) that we will need to manually install into the wine prefix in the next steps. While it doesn't need to exist in our new Wabbajack directory, I tend to store the WebView installer there anyway, to keep things contained and easy to find. -Either download the above two applications via your browser, and copy them into the new /home//Wabbajack directory, or run the following two commands in a terminal: +Either download the above two applications via your browser, and copy them into the new `/home//Wabbajack` directory, or run the following two commands in a terminal. -```command to download files directly to directory``` +Download Wabbajack Application: + +``` +wget -O /home/omni/Wabbajack/Wabbajack.exe https://github.com/wabbajack-tools/wabbajack/releases/latest/download/Wabbajack.exe +``` + +Download Microsoft Edge WebView2 Installer + +``` +wget -O /home/omni/Wabbajack/MicrosoftEdgeWebView2RuntimeInstallerX64.exe https://msedge.sf.dl.delivery.mp.microsoft.com/filestreamingservice/files/6d376ab4-4a07-4679-8918-e0dc3c0735c8/MicrosoftEdgeWebView2RuntimeInstallerX64.exe +``` --- ### Step 4 - A Clean Beginning (Creating a new Wine Prefix) -A new, clean wine >9.16 prefix is highly recommended. If you know what you are doing or have a reason you wish to hold on to your existing default wine prefix, then you will need to know how to handle multiple wine prefixes. For simplicity in this guide, I will just use the default wine prefix, which tends to be /home//.wine +A new, clean, wine >9.16 prefix is highly recommended. If you know what you are doing or have a reason you wish to hold on to your existing default wine prefix, then you will need to know how to handle multiple wine prefixes. For simplicity in this guide, I will just use the default wine prefix, which tends to be `/home//.wine` -The GUI way, start winetricks either from Apps menu: +Start winetricks either from Apps menu: @@ -79,7 +103,7 @@ Click continue, and winetricks will close, deleting the prefix in the background ### Step 5 - Create a new prefix, and change the renderer used -Re-run winetricks, either from the Applicatiosn menu, or terminal, as above. This time it will notify you that the Wine environment in /home//.wine is being updated. This is a good sign, as it means the prefix cleaning succeeded. +Re-run winetricks, either from the Applications menu, or terminal, as above. This time it will notify you that the Wine environment in `/home//.wine` is being updated. This is a good sign, as it means the prefix cleaning succeeded. @@ -103,13 +127,13 @@ This should return you to the previous options menu, don't close winetricks just --- -### Step 6 - Install Edge Webview2 +### Step 6 - Install Edge WebView2 Highlight "Run an arbitrary executable (.exe/.msi/.msu)" and click OK. This should bring up a file browser of your system, and will allow us to locate and run any .exe we want - in this case, the Edge Webview installer that we downloaded in Step 3. -Using the file browser, locate the installer for Webview - this should be in /home//Wabbajack if you are following my steps exactly. Once located, highlight the installer .exe file, and click Open: +Using the file browser, locate the installer for Webview - this should be in `/home//Wabbajack` if you are following my steps exactly. Once located, highlight the installer .exe file, and click Open: @@ -141,7 +165,7 @@ Still on the Applications tab, click the "Add application" button near the botto -This will open up a Windows-style file browser. Navigate to your Wabbajack.exe file, which will be in Z:\home\\Wabbajack\Wabbajack.exe if you have been following these steps exactly. +This will open up a Windows-style file browser. Navigate to your Wabbajack.exe file, which will be in `Z:\home\\Wabbajack\Wabbajack.exe` if you have been following these steps exactly. @@ -155,7 +179,7 @@ You can now close winetricks by clicking the Cancel button a few times. ### Step 9 - Link Steam Library -Lastly, Wabbajack inside the prefix doesn't know where to find your Steam Library when it's running via Wine. The simplest way to workaround that is to create a symlink from your Linux Steam Library, to a location inside the Prefix that Wabbajack will find. For example on my system: +Lastly, Wabbajack inside the prefix doesn't know where to find your Steam Library when it's running via Wine. The simplest way to workaround that is to create a symlink from your Linux Steam Library, to a location inside the Prefix that Wabbajack will find. For example on my system (you will have to alter the command to match the path used by your distro or system Steam Library location): ``` ln -s /home/omni/.local/share/Steam /home/omni/.wine/drive_c/Program\ Files\ \(x86\)/Steam @@ -169,33 +193,33 @@ This Steam Library check is only done when Wabbajack starts, so if you have jump That should be it as far as configuration is concerned. We can now run Wabbajack. You can do this by double-clicking the Wabbajack.exe file in your file browser: - + or by running your equivalent of: ``` -winetricks /home/omni/Wabbajack/Wabbajack.exe +wine /home/omni/Wabbajack/Wabbajack.exe ``` -And all being well, this will start Wabbajack, and it will run through the usual isntall: +And all being well, this will start Wabbajack, and it will run through the usual install: - + -log into Nexus using the GUI options, just like you would on Windows. +Log into Nexus using the GUI options, just like you would on Windows. At this stage, you should be good to just Wabbajack in the normal way. Either install a modlist from file, or browse the gallery to select one. There is currently a bug with some of the images not loading correctly, but that should be fixed in an upcoming update to Wabbajack. -When selecting the modlist Install and Downloads directory, keep in mind that this is from a Windows point of view, and that most likely the Linux Filesystem locations will show up as the Z: drive. I'd recommend creating a location to store the Wabbajack modlist and downloads specifically - For example, I use /home/omni/Games/Skyrim/ as the Install directory, and /home/omni/Games/WabbajackDownloads/Skyrim as the Downloads directory. +When selecting the modlist Install and Downloads directory, keep in mind that this is from a Windows point of view, and that most likely the Linux Filesystem locations will show up as the Z: drive. I'd recommend creating a location to store the Wabbajack modlist and downloads specifically - For example, I use `/home/omni/Games/Skyrim/` as the Install directory, and `/home/omni/Games/WabbajackDownloads/Skyrim` as the Downloads directory. -If you install a list using the C: drive, that will use space inside your wine prefix location (e.g. /home//.wine) and could get messy should you need to redo these steps in future. +If you install a list using the C: drive show in the file browser, the list will be installed inside your wine prefix location (e.g. `/home//.wine`) and could get messy should you need to remove the prefix or redo this guide in future. --- ### Post Wabbajack Steps -The above will get Wabbajack installed and running on your Linux system. It *does not* however, take care of any installation requirements to get the modlist itself running on Linux. You can see my other guides within this github for specific lists, or general steps to take, or you can use my automated installation script to take care of things for you. +The above will get Wabbajack installed and running on your Linux system. It *does not* however, take care of any installation requirements to get the modlist itself running on Linux. You can see my [other guides within this github](https://github.com/Omni-guides/Wabbajack-Modlist-Linux/wiki) for specific lists, or [general steps](https://github.com/Omni-guides/Wabbajack-Modlist-Linux/wiki/General-Linux-Guide-(Anvil)) to take, or you can use my [Automated Installation Script](https://github.com/Omni-guides/Wabbajack-Modlist-Linux/wiki/Using-the-omni%E2%80%90guides.sh-Automation-Script) to take care of things for you. --- @@ -228,7 +252,7 @@ sudo apt update sudo apt install winehq-staging ``` -This should result in a newer version of wine on your ubuntu-based system (and derivitives like Mint, Pop_OS) and allow you to get the above guide running. +This should result in a newer version of wine on your ubuntu-based system (and derivatives like Mint, Pop_OS) and allow you to get the above guide running. ---