mirror of
https://github.com/Omni-guides/Jackify.git
synced 2026-01-17 11:37:01 +01:00
Initial Draft
Omni-guides
234
Wabbajack-on-Linux-via-Wine.md
Normal file
234
Wabbajack-on-Linux-via-Wine.md
Normal file
@@ -0,0 +1,234 @@
|
||||
|
||||
|
||||
## 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!
|
||||
|
||||
## 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.
|
||||
|
||||
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.
|
||||
|
||||
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 <additional notes>.
|
||||
|
||||
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.
|
||||
|
||||
---
|
||||
|
||||
### 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.
|
||||
|
||||
You can check what wine version your system has currerntly 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.
|
||||
|
||||
You will also need to install winetricks from your system package maanger, if it is not already installed.
|
||||
|
||||
---
|
||||
|
||||
### Step 2 - Create a Wabbajack Directory
|
||||
|
||||
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.
|
||||
|
||||
---
|
||||
|
||||
### 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.
|
||||
|
||||
Either download the above two applications via your browser, and copy them into the new /home/<user>/Wabbajack directory, or run the following two commands in a terminal:
|
||||
|
||||
```command to download files directly to directory```
|
||||
|
||||
---
|
||||
|
||||
### 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/<user>/.wine
|
||||
|
||||
The GUI way, start winetricks either from Apps menu:
|
||||
|
||||
<img src="https://github.com/Omni-guides/Wabbajack-Modlist-Linux/blob/main/images/WabbajackLinux/WabbajackLinux_RunWinetricksGUI.png" width="600">
|
||||
|
||||
or by running `winetricks` in a terminal:
|
||||
|
||||
<img src="https://github.com/Omni-guides/Wabbajack-Modlist-Linux/blob/main/images/WabbajackLinux/WabbajackLinux_RunWinetricksCLI.png" width="600">
|
||||
|
||||
Once winetricks has opened, ensure "Select the default wineprefix" is selected, or select it, and then click OK.
|
||||
|
||||
<img src="https://github.com/Omni-guides/Wabbajack-Modlist-Linux/blob/main/images/WabbajackLinux/WabbajackLinux_WinetricksDefaultPrefix.png" width="600">
|
||||
|
||||
On the next window, highlight "Delete ALL DATA AND APPLICATIONS INSIDE THIS WINEPREFIX" - you may have to scroll the window down a little:
|
||||
|
||||
<img src="https://github.com/Omni-guides/Wabbajack-Modlist-Linux/blob/main/images/WabbajackLinux/WabbajackLinux_WinetricksDeletePrefix.png" width="600">
|
||||
|
||||
A warning will pop up needing you to confirm the deletion of the prefix and contents:
|
||||
|
||||
<img src="https://github.com/Omni-guides/Wabbajack-Modlist-Linux/blob/main/images/WabbajackLinux/WabbajackLinux_WinetricksConfirmDelete.png" width="600">
|
||||
|
||||
Click continue, and winetricks will close, deleting the prefix in the background. The prefix has now been removed.
|
||||
|
||||
---
|
||||
|
||||
### 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/<user>/.wine is being updated. This is a good sign, as it means the prefix cleaning succeeded.
|
||||
|
||||
<img src="https://github.com/Omni-guides/Wabbajack-Modlist-Linux/blob/main/images/WabbajackLinux/WabbajackLinux_WinetricksNewEnv.png" width="600">
|
||||
|
||||
It will also likely prompt you to install Wine-Mono, which you can confirm.
|
||||
|
||||
<img src="https://github.com/Omni-guides/Wabbajack-Modlist-Linux/blob/main/images/WabbajackLinux/WabbajackLinux_WinetricksNewEnvMono.png" width="600">
|
||||
|
||||
Again, with "Select the default wineprefix" highlighted, click OK.
|
||||
|
||||
<img src="https://github.com/Omni-guides/Wabbajack-Modlist-Linux/blob/main/images/WabbajackLinux/WabbajackLinux_WinetricksDefaultPrefix.png" width="600">
|
||||
|
||||
This time, however, highlight "Change settings" and click OK
|
||||
|
||||
<img src="https://github.com/Omni-guides/Wabbajack-Modlist-Linux/blob/main/images/WabbajackLinux/WabbajackLinux_WinetricksChangesettings.png" width="600">
|
||||
|
||||
Scroll down the list of settings shown, until you see "renderer=vulkan", highlight it, and click OK.
|
||||
|
||||
<img src="https://github.com/Omni-guides/Wabbajack-Modlist-Linux/blob/main/images/WabbajackLinux/WabbajackLinux_WinetricksChangeRenderer.png" width="600">
|
||||
|
||||
This should return you to the previous options menu, don't close winetricks just yet.
|
||||
|
||||
---
|
||||
|
||||
### 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.
|
||||
|
||||
<img src="https://github.com/Omni-guides/Wabbajack-Modlist-Linux/blob/main/images/WabbajackLinux/WabbajackLinux_WinetricksRunArbitrary.png" width="600">
|
||||
|
||||
Using the file browser, locate the installer for Webview - this should be in /home/<user>/Wabbajack if you are following my steps exactly. Once located, highlight the installer .exe file, and click Open:
|
||||
|
||||
<img src="https://github.com/Omni-guides/Wabbajack-Modlist-Linux/blob/main/images/WabbajackLinux/WabbajackLinux_WinetricksBrowseToWebviewInstaller.png" width="600">
|
||||
|
||||
After a few second, the WebView2 installer window will appear, and run through the install process, and then it will close without any message. Keep winetricks open for the next step.
|
||||
|
||||
<img src="https://github.com/Omni-guides/Wabbajack-Modlist-Linux/blob/main/images/WabbajackLinux/WabbajackLinux_WinetricksWebViewInstalling.png" width="600">
|
||||
|
||||
---
|
||||
|
||||
### Step 7 - Change Windows version for the prefix
|
||||
|
||||
While it would be great to just set wine to mimic windows 10 or 11 and be done with it, leaving things like that will cause various issues with the Wabbajack interface, including the inability to complete the Nexus login step via the GUI. To avoid this, we need to set the overall Wine environment to be win7, yet keep the Wabbajack.exe application as win10.
|
||||
|
||||
Still within winetricks, highlight "Run winecfg" and click OK. This will open up a new small window labelled "Wine configuration".
|
||||
|
||||
<img src="https://github.com/Omni-guides/Wabbajack-Modlist-Linux/blob/main/images/WabbajackLinux/WabbajackLinux_WinetricksWineConfiguration.png" width="600">
|
||||
|
||||
Staying on the Applications tab which should be selected by default, change the "Windows Version" at the bottom to be "Windows 7" instead of the default of Windows 10 or 11.
|
||||
|
||||
<img src="https://github.com/Omni-guides/Wabbajack-Modlist-Linux/blob/main/images/WabbajackLinux/WabbajackLinux_WinetricksSetWin7.png" width="600">
|
||||
|
||||
Do not close this window yet.
|
||||
|
||||
---
|
||||
|
||||
### Step 8 - Add Wabbajack as an application
|
||||
|
||||
Still on the Applications tab, click the "Add application" button near the bottom
|
||||
|
||||
<img src="https://github.com/Omni-guides/Wabbajack-Modlist-Linux/blob/main/images/WabbajackLinux/WabbajackLinux_WinetricksAddApplication.png" width="600">
|
||||
|
||||
This will open up a Windows-style file browser. Navigate to your Wabbajack.exe file, which will be in Z:\home\<user>\Wabbajack\Wabbajack.exe if you have been following these steps exactly.
|
||||
|
||||
<img src="https://github.com/Omni-guides/Wabbajack-Modlist-Linux/blob/main/images/WabbajackLinux/WabbajackLinux_WinetricksBrowseToWabbajackExe.png" width="600">
|
||||
|
||||
Highlight Wabbajack.exe, and click Open, and you should now see Wabbajack.exe listed in the list of applications. Select Wabbajack.exe in the list, and change the "Windows Version" from "Use global settings" to "Windows 10", and then click apply:
|
||||
|
||||
<img src="https://github.com/Omni-guides/Wabbajack-Modlist-Linux/blob/main/images/WabbajackLinux/WabbajackLinux_WinetricksWabbajackSetWin10.png" width="600">
|
||||
|
||||
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:
|
||||
|
||||
```
|
||||
ln -s /home/omni/.local/share/Steam /home/omni/.wine/drive_c/Program\ Files\ \(x86\)/Steam
|
||||
```
|
||||
|
||||
This Steam Library check is only done when Wabbajack starts, so if you have jumped ahead and launched Wabbajack, you'll have to close it an open it again.
|
||||
|
||||
---
|
||||
|
||||
### Step 10 - Run Wabbajack, Nexus Login
|
||||
|
||||
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:
|
||||
|
||||
<img src="https://github.com/Omni-guides/Wabbajack-Modlist-Linux/blob/main/images/WabbajackLinux_WinetricksRunWabbajack.png" width="600">
|
||||
|
||||
or by running your equivalent of:
|
||||
|
||||
```
|
||||
winetricks /home/omni/Wabbajack/Wabbajack.exe
|
||||
```
|
||||
|
||||
And all being well, this will start Wabbajack, and it will run through the usual isntall:
|
||||
|
||||
<img src="https://github.com/Omni-guides/Wabbajack-Modlist-Linux/blob/main/images/WabbajackLinux_WinetricksRunWabbajackInstall.png" width="600">
|
||||
|
||||
log into Nexus using the GUI options, just like you would on Windows.
|
||||
|
||||
<img src="https://github.com/Omni-guides/Wabbajack-Modlist-Linux/blob/main/images/WabbajackLinux/WabbajackLinux_WabbajackNexusLogin.png" width="600">
|
||||
|
||||
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/<ModListName> 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/<user>/.wine) and could get messy should you need to redo these steps 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.
|
||||
|
||||
---
|
||||
|
||||
### Additional Notes
|
||||
|
||||
As mentioned above, functionality for Wabbajack via wine only really became reliable with the newer versions of Wine 9. There may be some success with versions earlier than Wine 9.16, but I'd still suggest using the newest that your distribution gives you easy access to.
|
||||
|
||||
For some though, the distro they are using only really has an old version of Wine available from the default repos. For example, Ubuntu-based distros that are using 22.04 as a base can only supply Wine 6 from the standard repos. You may have to check or research how to add newer versions of wine to your distro, but something like the following was used on Mint, as an example.
|
||||
|
||||
1. Install the key and gpg needed for the winehq ubuntu repository:
|
||||
```
|
||||
curl -s https://dl.winehq.org/wine-builds/winehq.key | sudo gpg --dearmor | sudo tee /usr/share/keyrings/winehq.gpg > /dev/null
|
||||
```
|
||||
|
||||
2. Add the winehq Ubuntu repository to your system:
|
||||
|
||||
```
|
||||
echo deb [signed-by=/usr/share/keyrings/winehq.gpg] http://dl.winehq.org/wine-builds/ubuntu/ noble main | sudo tee /etc/apt/sources.list.d/winehq.list
|
||||
```
|
||||
|
||||
3. Update apt to read and include the new repository:
|
||||
|
||||
```
|
||||
sudo apt update
|
||||
```
|
||||
|
||||
4. Finally, install a newer version of wine from the new repository:
|
||||
|
||||
```
|
||||
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.
|
||||
|
||||
---
|
||||
|
||||
Reference in New Issue
Block a user