Skip to content
Chris edited this page Jul 27, 2026 · 4 revisions

Installing

Theres a few ways to install the mod manager

The easiest way is to run the following command in a terminal/konsole. You can search for konsole in the application menu or right click in the file explorer and press Open terminal here

Then right click > paste the command (Don't ctrl+v it doesn't work)

curl -sSL https://raw.githubusercontent.com/ChrisDKN/Amethyst-Mod-Manager/main/src/appimage/Amethyst-MM-installer.sh | bash

This command just runs the install script found in this repo under src/appimage. It grabs the latest version from releases and sets up a .desktop shortcut

You can find the application in the application menu. From here you can run it or add it to steam if you want to run it in gaming mode for the steam deck

Uninstall

There's currently no uninstall script but Amethyst adds files to the following locations

/home/<user>/.config/AmethystModManager (config files and default staging locations are here)

/home/<user>/applications (The app image is stored here)

/home/<user>/.local/share/applications (the .desktop entry is here)

/home/<user/.local/share/icons/ (The application icon is here)

Updating

For the appimage, Simply press "update via installer" when the prompt appears. It will rerun the install script


For updating the flatpak there is a few options

  • Run the auto updater when the prompt to update appears
  • Download and reinstall the bundle from the release page
  • Updates should also show in the discover store or where ever you normally update flatpak's from. The remote for the flatpak needs to be added to the system. This should be added once you install the flatpak for the first time.
image

Pre-Release versions

Pre release versions may include bug fixes or new features not present in the stable version. To use the latest pre release version go to settings and under general settings enable use pre-release version

image

If the latest pre release is newer than stable, it will prompt to auto install the latest pre release. If no prompt appears it may be that there is no current pre release version, but it will prompt to install it when there is. Disabling this option will prompt to switch back to stable

Clone this wiki locally