User Guide - Omni-guides/Jackify GitHub Wiki

Jackify Banner

Wiki | Nexus | Download | Wabbajack Discord | Jackify Issues | Legacy Guides | Ko-fi


Jackify - User Guide

New to Jackify? Read our Introduction to understand what Jackify is and why it exists.

This guide provides step-by-step instructions for using Jackify to install, configure, and manage Wabbajack modlists on Linux and Steam Deck.

IMPORTANT: MOST Modlists are not supported on Linux, so please do not go to the Modlist Author for support, unless they specifically do support running their modlist on Linux.

Installation and First Run

Step 1: Getting Jackify from Nexus Mods

Jackify is primarily distributed through Nexus Mods. Releases on Github are planned in the very near future, but for now the preference is to download Jackify from Nexus Mods.

  1. Visit the Jackify mod page on Nexus Mods - You can download Jackify from NexusMods.
  2. Download the latest version - Click the "Download" button to get the latest Jackify 7z archive. While I'd prefer to just supply the AppImage file itself, Nexus Mods does not support this file type directly, so it has to be zipped up.
Nexus Mods Download Page

Nexus Mods page showing Jackify mod with download button highlighted

Step 2: Extracting and Running Jackify

Once you've downloaded the 7z archive, you'll need to extract the AppImage and make it executable. This is a standard process for AppImage applications on Linux:

# Extract the AppImage from the 7z archive
7z x Jackify.7z

# Make the AppImage executable
chmod +x Jackify.AppImage

# Run Jackify
./Jackify.AppImage

You could chose to create a specific Jackify directory in your home directory, like so:

Terminal Installation Process

Screenshot: Terminal showing the 7z extraction command, chmod command, and successful AppImage execution

If you encounter permission issues or the AppImage fails to run, make sure FUSE is installed on your system. Most modern Linux distributions include FUSE by default, but some minimal installations might require manual installation.

Alternative: GitHub Release

As mentioned, GitHub Release versions will be available soon.

Quick Start

For users who want to get started immediately after installation:

  1. Launch Jackify: ./Jackify.AppImage
  2. Install a Modlist:
    • Click "Modlist Tasks" → "Install a Modlist (Automated)"
    • Select your game (e.g. Skyrim Special Edition)
    • Choose a modlist
    • Set directories and enter Nexus API key
    • Click "Start Installation"
  3. Play: Launch from Steam when installation completes

That's it! Jackify handles everything else automatically.

Understanding the Interface

When you first launch Jackify, you'll see the main menu with two primary options:

Jackify Main Menu

The Jackify main menu presents two options: Modlist Tasks for all functionality, and Coming Soon for future features

  • Modlist Tasks: Access all modlist installation and configuration features
  • Coming Soon...: Shows information about upcoming features (currently displays a dialog explaining that all current functionality is available through Modlist Tasks)
  • Exit Jackify: Quit the application

All current modlist operations are accessed through "Modlist Tasks".

Modlist Tasks Menu

The Modlist Tasks menu provides access to installation and management functions

The Modlist Tasks menu provides three main workflows:

  • Install a Modlist (Automated): Download and install any modlist from scratch with full automation
  • Configure New Modlist (Post-Download): Set up Steam integration for manually installed modlists
  • Configure Existing Modlist (In Steam): Reconfigure existing Steam shortcuts

Installing a New Modlist

Let's start with the most common scenario - installing a modlist from scratch. This workflow demonstrates Jackify's full automation capabilities.

Step 1: Accessing Installation Options

From the Modlist Tasks menu, click the Install a Modlist button.

Step 2: Understanding the Installation Interface

The installation interface contains all the configuration options needed to install and configure a modlist:

Install a Modlist - Initial Screen

The initial installation screen shows all the configuration options you'll need to complete: game selection, modlist choice, directories, API key, and preferences

Step 3: Selecting Your Game

Start by choosing which game you want to install a modlist for.

Game Selection Screen

Game selection showing the full range of supported titles

Fully Supported Games (complete automation including Steam integration):

  • Skyrim Special Edition: Full automation with post-install configuration
  • Fallout 4: Full automation with post-install configuration
  • Fallout New Vegas: Full automation with post-install configuration except for TTW creation.
  • Enderal: Full automation with post-install configuration
  • Oblivion: Full automation with post-install configuration
  • Starfield: Installation works, Steam configuration coming soon

Download & Install Only (automation coming in future updates):

  • Cyberpunk 2077: Basic modlist installation support. Manual configuration needed
  • Baldur's Gate 3: Basic modlist installation support. Manual configuration needed

Step 4: Choosing Your Modlist

Once you've selected your game, you can browse available modlists. This is where Jackify's integration with the Wabbajack ecosystem comes through - it pulls live data about modlist availability, sizes, and status.

Modlist Browser Table

The modlist browser shows comprehensive information including download sizes, install sizes, total space requirements, and current status

The table provides crucial information for planning your installation:

  • Download Size: How much you'll need to download from Nexus
  • Install Size: How much disk space the final installation will use
  • Total Size: Combined space needed during installation (usually download + install)
  • Status: Whether the modlist is currently available and working

Advanced Modlist Features

Jackify provides a modlist search function, as well as NSFW filtering:

Search and Filtering

When you're looking for specific modlists or want to narrow down options, the search function lets you filter by name:

Modlist Search

Search functionality helps you quickly find specific modlists in large catalogs

Content and Status Filtering

Jackify respects user preferences around content and shows clear indicators for modlist status:

NSFW and Status Filters

NSFW filtering and status indicators help you avoid unsuitable or unavailable content

By default, NSFW content is hidden to maintain family-friendly defaults, but you can enable it by checking the box at the bottom of the window. [DOWN] Status indicators clearly show when modlists are temporarily unavailable.

Custom .wabbajack Files

If you already have the .wabbajack file for your desired modlist downloaded, or it's just not available via the Wabbajack Modlist List, you can use your own .wabbajack file using the "Use .wabbajack file" tab at the top:

Custom Wabbajack File Selection

The custom file option supports community modlists, beta versions, or personal modlist projects

This is particularly useful for:

  • Beta versions of modlists not yet in the public catalog
  • Community-created modlists not distributed through Wabbajack's ecosystem
  • Personal modlist projects

Step 5: Configuring Directories

Directory configuration is where you will select where you want the modlist installed, and where you want the mod archives to be downloaded to:

Directory Selection

Directory configuration showing the distinction between installation location (where the modlist lives) and download location (temporary storage for mod files)

Installation Directory: This is where your final modlist will be installed. It contains ModOrganizer, the game files, and all configured mods. This directory should be on fast storage if possible since it's accessed during gameplay.

Download Directory: This is temporary storage for downloaded mod files during installation. These files can be deleted after installation completes if you wish, so this can be on slower/cheaper storage if you have a multi-drive setup.

Tips for Directory Selection:

  • Place installation directories on SSDs for better performance
  • Download directories can be on traditional HDDs to save SSD space
  • Consider creating a dedicated ~/Games or ~/Modlists directory structure
  • Keep the modlist Install and Download directories separate

Jackify has built-in protection to ensure you don't accidentally overwrite the wrong directory if you select one as the install directory by mistake.

Step 6: Nexus Mods API Configuration

This step connects Jackify to your Nexus Mods account for automated downloads. The API key is like a passcode that lets Jackify download mods on your behalf. While there are plans to replace this API Key requirement, this is the only option for now. The UI provides a link to where you will find your Nexus API Key, and has an optional Save function to keep the key stored locally on your system, encrypted.

Nexus API Key Input

The API key input includes helpful instructions and links to generate your key

Getting Your API Key:

  1. Browse to the Nexus Mods API Key page - https://www.nexusmods.com/users/myaccount?tab=api
  2. If prompted, log in with your account
  3. Scroll down to the very bottom to find your Personal API Key
  4. Copy the key and paste it into Jackify
  5. Optionally save your key by checking the box
Nexus API Key Filled

Once entered, the API key is validated and stored securely for future use

Jackify validates your API key and optionally stores it securely for future modlist installations. You won't need to enter it again unless you generate a new key or switch Nexus accounts.

Security Note: Your API key is stored locally and encrypted. Jackify never transmits your key to any servers other than Nexus Mods for legitimate mod downloads.

Step 7: Resolution Setting

The final configuration step involves setting display preferences:

Resolution Configuration

Resolution configuration ensures your modlist is optimized for your display setup

Resolution Settings: Choose the resolution that matches your monitor or your preferred gaming resolution. This can be changed later, but setting it correctly now saves configuration time. Jackify will remember the last resolution you set to make future modlist installs easier.

Step 8: Installation Process

Once all configuration options are set, the actual installation begins. This is where Jackify's automation kicks in.

Installation Progress

The installation progress screen provides real-time feedback on download and installation status

What Happens During Installation:

  1. Modlist File: If needed, the modlist .wabbajack file is downloaded
  2. Download Phase: Mods are downloaded from Nexus Mods using your API key
  3. Extraction: Downloaded archives are extracted and organized
  4. Installation: Files are moved to their final locations, textures are converted, BSAs are built and configured
  5. Steam Integration: Steam shortcuts are created with proper Proton configuration
  6. Final Configuration: Launch options, compatibility tools, and artwork are set up, where possible

Time varies significantly based on your internet connection, disk speed, processing power. The process is designed to be resumable if interrupted - simply reuse the same Install and Download directory paths and the modlist installation will analyse the current status, and pick up where it left off.

Configuring Existing Modlists

Not everyone starts from scratch - you might have modlists from previous installations, or you might want to reconfigure existing Steam shortcuts. Jackify handles these scenarios with dedicated workflows.

Configure a New Modlist: Bringing Manual Installations into Steam

If you have a modlist that was installed with some other method (perhaps following old guides) and want to integrate it properly with Steam, the "Configure New Modlist (Post-Download)" option is what you need.

Configure New Modlist - Initial

The initial configuration screen for existing modlists focuses on locating your installation and setting up Steam integration

This workflow assumes you have a working modlist installation but need Jackify to:

  • Create proper Steam shortcut
  • Configure Proton settings
  • Set up launch options
  • Install any missing compatibility components

Finding Your ModOrganizer Installation

The key step is pointing Jackify to your existing ModOrganizer.exe file. This tells Jackify where your modlist is installed and lets it analyze the configuration:

Configure New Modlist - Browse to MO2

Browse to locate your ModOrganizer.exe file - Jackify will analyze the installation and configure Steam integration automatically

What Jackify Analyses:

  • Game type and version
  • Required compatibility components
  • Steam integration requirements

Completing Configuration

Configure New Modlist - Completed

The completed configuration shows Jackify's analysis of your existing installation and proposed Steam integration settings

With the Name, path and resolution set, click Start Configuration. Jackify will:

  • Create proper Steam shortcut
  • Configure Proton settings
  • Set up launch options
  • Install any missing compatibility components

Once complete, you should be good to click play in steam, and launch the modlist from MO2!

Configure an Existing Modlist: Reconfiguring Steam Shortcuts

Sometimes you may want to reconfigure modlists that are already in Steam, perhaps from a previous install, or if something went wrong during the install process.

Configure Existing Modlist - Interface

The reconfiguration interface lets you update settings while preserving existing Steam integration

Jackify detects existing modlists in your Steam library and presents them for reconfiguration.

Configure Existing Modlist - Selection

Jackify can detect existing modlist shortcuts in Steam and reconfigure them

Common Reconfiguration Scenarios:

  • Moving modlist installations to new locations
  • Fixing corrupted Steam shortcuts

Command Line Interface

While the GUI is designed for ease of use, Jackify also provides a full-featured command line interface.

Launching CLI Mode

Launch Jackify with the --cli flag to access the text-based interface:

./Jackify.AppImage --cli
CLI Main Menu

The CLI main menu provides the same functionality as the GUI but in a text-based interface suitable for remote access or automation

CLI Navigation and Features

The CLI uses a menu-driven approach that mirrors the GUI functionality:

CLI Installation Menu

CLI installation menus provide step-by-step text interfaces with the same configuration options as the GUI

Main Menu Options:

  • Modlist Tasks: Same functionality as GUI version
  • Coming Soon...: For now this only displays a message about future features and returns to main menu
  • Exit Jackify: Quit the application

Navigation:

  • Use the numbered menu options to select an option
  • Press Enter to select items
  • Follow the on-screen prompts
  • All GUI features are available through text menus

Settings Menu (Advanced)

The GUI has a Settings menu that allows you to configure certain aspects of Jackify, such as:

Settings Menu Options:

  • Resource Limits: Similarly to Wabbajack, you can configure the threads available for various actions
  • Enabling Debug Mode: Check this box to enable debug logging, mostly if asked to do so as part of a support issue
  • Set/Clear Nexus API Key: Set or clear the stored API Key
  • Default Directory Paths: Set the default directories that will be shown in the Install a Modlist workflow, this can make it simpler for future modlists if you have a standard directory structure.
GUI Settings Menu

GUI Settings Menu that allows various configuration and default setting

Troubleshooting: When Things Go Wrong

Even with all of Jackify's automation, things can still go wrong. There are just too many distros, system set ups, modlists and potential differences to have tested them all.

Common Issues and Solutions

Details and guidance for common issues and solutions will be entered into the FAQ Wiki Page (coming soon)

Getting Help and Support

When you encounter issues that aren't covered by basic troubleshooting:

Check the Logs: Jackify creates detailed logs in ~/Jackify/logs/. These often contain specific error messages that point to solutions.

Community Support: Join the #unofficial-linux-help channel in the Wabbajack Discord. The Linux modding community is helpful and experienced with troubleshooting.

GitHub Issues: For bugs or feature requests, the GitHub Issues page is the best place to report problems and track fixes.

Wiki Documentation: Check the project wiki for detailed guides, FAQ, and community-contributed solutions.


For more information about Jackify's history, philosophy, and technical details, see the Introduction.

⚠️ **GitHub.com Fallback** ⚠️