https://github.com/chrisdkn/amethyst-mod-manager
A Linux native mod manager for a variety of games
https://github.com/chrisdkn/amethyst-mod-manager
linux linuxgaming modding modding-games modmanager steam-os steamdeck
Last synced: 2 days ago
JSON representation
A Linux native mod manager for a variety of games
- Host: GitHub
- URL: https://github.com/chrisdkn/amethyst-mod-manager
- Owner: ChrisDKN
- License: gpl-3.0
- Created: 2026-02-21T16:46:39.000Z (3 months ago)
- Default Branch: main
- Last Pushed: 2026-04-26T02:08:55.000Z (about 1 month ago)
- Last Synced: 2026-04-26T04:02:34.451Z (about 1 month ago)
- Topics: linux, linuxgaming, modding, modding-games, modmanager, steam-os, steamdeck
- Language: Python
- Homepage:
- Size: 285 MB
- Stars: 150
- Watchers: 4
- Forks: 6
- Open Issues: 3
-
Metadata Files:
- Readme: README.md
- Changelog: Changelog.txt
- License: LICENSE
Awesome Lists containing this project
README
Amethyst Mod Manager
A mod manager for Linux.
Nexus |
Wiki |
Ko-Fi
## Key Features
- **Mod Organiser like interface** - Designed to look and behave like Mod Organiser
- **Collections** - Install Nexus Mods collections straight into the manager
- **Linux Native** — Designed for Linux, Includes tools for setting up modded games using proton
- **Multi-game support** — Support for some of the most popular games on Nexus
- **FOMOD support** — Full Fomod support with last selections saved.
- **LOOT support** — Loot is built in nativley for games that support it, Included userlist editing
- **Nexus API Support** — Includes features using nexus api to quickly update and install mods
- **Root Folder builder** — Includes the option to deploy files staight to the games root folder, Keeping it clean
- **Save runtime generated files** - Files generated by mods such as configs or shaders are moved back to the managers staging directory so settings are not lost
## Install
**The Application may ask to set a password, This is for the OS keyring to store your nexus API key as we do not store it in a plain text file. Set the password to anything you want**
### Appimage
Run the following command in a terminal. It will appear in your applications menu under Games and Utilities.
```bash
curl -sSL https://raw.githubusercontent.com/ChrisDKN/Amethyst-Mod-Manager/main/src/appimage/Amethyst-MM-installer.sh | bash
```
### Flatpak
Download the .flatpak from [releases](https://github.com/ChrisDKN/Amethyst-Mod-Manager/releases) and install with your package manager (I use warehouse). Currently does not include an auto update feature.
### AUR
## Games Supported
GameNotes
GameNotes
SkyrimNormal, SE and VRNo Mans Sky
Fallout 3Normal and GotyResident Evil2, 3, 4, 7, Village, Requiem
Fallout 4Normal and VRThe Sims 4
Fallout New VegasTCG Card Shop Simulator
EnderalNormal and SESupermarket Simulator
StarfieldValheim
OblivionLethal Company
Oblivion RemasteredMount & Blade II: Bannerlord
MorrowindNormal and OpenMWSlay The Spire 2
Baldur's Gate 3Blade & Sorcery
Witcher 3Rimworld
Cyberpunk 2077Green Hell
MewgenicsSchedule 1
Stardew ValleyReady Or Not
Kingdom Come Deliverance1 and 2Monster Hunter World
Hogwarts LegacyMonster Hunter Rise
Marvel RivalsMonster Hunter Wilds
Expedition 33Stalker 2
SubnauticaPalworld
Subnautica Below ZeroMy Summer Car
Red Dead Redemption 2Planet Zoo
Subnautica 2Stellar Blade
Spyro Reignited TrilogyPayday 2
Kingdom Hearts 3
- Amethyst has the ability to define custom games and is not limited to this list. The games in the Custom Handlers folder were made using this feature. See the Wiki for the guide
## Supporting Applications
Amethyst supports many supporting applications used to mod games. Place the applications in the games applications folder (**In the staging folder**) and they will be auto detected. The arguments/config used to run them will be auto-generated to make setup easier.
**As of update 1.1.7 you can now run most of these tools from the wizard menu, the dependancies will auto install. The only manual step is downloading the application itself, everything else is automated**
| Status | Application | Notes |
|--------|-------------|-------|
| Working | **Pandora Behaviour Engine** | `--tesv:` and `--output:` args applied at runtime|
| Working | **SSEEdit** | `-d` and `-o` args applied at runtime|
| Working | **pgpatcher** | Requires `d3dcompiler_47` and `.net8 desktop runtime` installed to the game prefix via Protontricks. Config auto generated to include Data directory and output folder |
| Working | **DynDOLOD** | `-d` and `-o` args applied at runtime|
| Working | **TexGen** | `-d` and `-o` args applied at runtime|
| Working | **xLodGen** | `-d` and `-o` args. Game argument appended at runtime |
| Working | **Bethini Pie** | Just works |
| Experimental | **Vramr** | Experimental python wrapper See wiki for instructions|
| Experimental | **Bendr** | Experimental python wrapper See wiki for instructions|
| Experimental | **ParallaxR** | Experimental python wrapper See wiki for instructions|
| Working | **Wrye Bash** | `-o` Auto generated for selected game at runtime |
| Working | **Synthesis** | Use via wizard to setup the prefix |
| Working | **Bodyslide and Outfits Studio** | Add as a mod > Deploy > refresh the exe list > Run the exe and it should work |
| Working | **Witcher 3 Script merger** | Game path added to config automatically |
| Working | **Witcher 3 Script merger Fresh and Automated Edition** | Game path added to config automatically. Requires .net 8 Runtime installed into the prefix |
| Maybe | **Npc plugin chooser** | Game paths are applied to config at runtime, Can't seem to generate npc portraits and has some problems under proton |
The other xedit applications for the other games also work as well as the quickautoclean applications.
## Wiki
See the wiki page for a detailed guide on how to the use the mod manager and its functions
## Supporting the project
Your feedback is enough and is greatly appreciated as this benefits everyone but if you'd like donate you can on Ko-fi
