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.

On the first run, if no configuration can be found, configuration files will be created under AppData\Local\The Witcher 3 Mod Manager. Existing configuration files will be read from the directory of the executable first and in Documents\The Witcher 3 Mod Manager second for compatibility with prior versions. They can be freely relocated between the 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]