The Witcher 3 Mod Manager

Mod Manager for The Witcher 3.

Supports the Steam and GOG releases on Windows and the Steam Proton release on Linux.

Description

The Witcher 3 Mod Manager is an application that simplifies installing and managing The Witcher 3 mods, originally developed by stefan3372 and now being continued here.

See the Nexus Mods page for releases, screenshots and more information.

Usage

Release Versions (Windows)

Download and unpack the latest release from Nexus Mods or from the GitHub releases. If you are upgrading from version 0.6 or later, directly overwrite the previous installation. Existing configuration files will be searched in the same directory as the executable first, in Documents\The Witcher 3 Mod Manager second.

On the first run, if no configuration can be found, configuration files will be created under Documents\The Witcher 3 Mod Manager. They can be freely relocated between the two searched locations as preferred.

Python (Windows and Linux)

The project uses PDM for dependency management. Requires Python 3.10 or newer (3.10+), up to Python 3.12.

1. Install PDM with recommended installation method
2. Clone the repository
3. Install dependencies: pdm install --prod
4. Run the application: pdm run start

On Linux:

• Configuration files are created in ~/.config/TheWitcher3ModManager
• wine must be available to run Script Merger
• Consider using pdm run prefix for all commands

Build Release (Windows)

1. Install dependencies with development tools: pdm install
2. Build executable: pdm run build-win
3. Find files in build/exe.[platform identifier].[python version]