Almost Manual Mod Organizer

Ammo is a CLI mod manager for Linux.

Under the hood, Ammo works by installing symlinks in your game directory which point at your mod files. This is highly compatible and has zero runtime overhead.

Supported Games

• Enderal
• Enderal Special Edition
• Fallout 4
• Fallout New Vegas
• Oblivion
• Oblivion Remastered
• Sims 4
• Skyrim
• Skyrim Special Edition
• Skyrim VR
• Starfield

Features

• install mods from ~/Downloads
• activate/deactivate mods/plugins
• reorder mods/plugins
• rename mods/downloads
• delete mods/plugins/downloads
• autosort plugins by mod order
• supports FOMOD configuration
• file conflict detection

Dependencies

• Python 3.12 or later
• Steam from Flatpak or official repos.
• p7z from official repos.
• pipx from official repos.

Install / Update

pipx install git+https://github.com/cyberrumor/ammo --force

Usage

usage: ammo [-h] [--downloads PATH] [--conf PATH] [--mods PATH] [--tools PATH] [--title TITLE]

Almost Manual Mod Organizer

options:
  -h, --help        show this help message and exit
  --downloads PATH  directory containing installable archives
  --conf PATH       directory containing configs for managed games
  --mods PATH       directory containing mods for this session
  --tools PATH      directory containing tools for this session
  --title TITLE     manage a detected game with TITLE (skip game selection menu)

Help

............................................................................................
activate   : (mod|plugin) <index>             : Enabled components will be loaded by the
           :                                  : game.
           :                                  : - `activate mod 1`
           :                                  : - `activate mod all`
           :                                  : - `activate plugin 1`
           :                                  : - `activate plugin all`
............................................................................................
collisions : <index>                          : Show file conflicts for a mod. Mods prefixed
           :                                  : with asterisks have file conflicts. Mods
           :                                  : prefixed with x install no files.
           :                                  : - `collisions 0`
............................................................................................
commit     :                                  : Apply pending changes.
............................................................................................
configure  : <index>                          : Configure a fomod.
           :                                  : - `configure 0`
............................................................................................
deactivate : (mod|plugin) <index>             : Disabled components will not be loaded by
           :                                  : the game.
           :                                  : - `deactivate mod 1`
           :                                  : - `deactivate mod all`
           :                                  : - `deactivate plugin 1`
           :                                  : - `deactivate plugin all`
............................................................................................
delete     : (mod|plugin|download) <index>    : Removes the specified file from the
           :                                  : filesystem.
           :                                  : - `delete download 1`
           :                                  : - `delete download all`
           :                                  : - `delete mod 1`
           :                                  : - `delete mod all`
           :                                  : - `delete plugin 1`
           :                                  : - `delete plugin all`
............................................................................................
display    : (list|tags)                      : Change UI mode.
           :                                  : - `display list`
           :                                  : - `display tags`
............................................................................................
exit       :                                  : Quit.
............................................................................................
find       : [<keyword> ... ]                 : Show only components with any keyword.
           :                                  : Execute without args to show all.
           :                                  : - `find`
           :                                  : - `find keyword1`
           :                                  : - `find keyword1 keyword2`
............................................................................................
help       :                                  : Show this menu.
............................................................................................
install    : <index>                          : Extract and manage an archive from
           :                                  : ~/Downloads.
           :                                  : - `install 0`
           :                                  : - `install all`
............................................................................................
log        :                                  : Show debug log history.
............................................................................................
move       : (mod|plugin) <index> <new_index> : Larger numbers win conflicts.
           :                                  : - `move mod 1 2`
           :                                  : - `move plugin 1 2`
............................................................................................
refresh    :                                  : Abandon pending changes.
............................................................................................
rename     : (mod|download) <index> <name>    : Names may contain alphanumerics, periods,
           :                                  : and underscores.
           :                                  : - `rename download 1 some_text`
           :                                  : - `rename mod 1 some_text`
............................................................................................
sort       :                                  : Arrange plugins by mod-order.
............................................................................................
tag        : (add|remove) <index> <tag_name>  : Add or remove tags from mods.
           :                                  : - `tag add 1 some_text`
           :                                  : - `tag add all some_text`
           :                                  : - `tag remove 1 some_text`
           :                                  : - `tag remove all some_text`
............................................................................................
tools      :                                  : Manage tools.
............................................................................................
view_files : <index>                          : Show mod files relative to the game
           :                                  : directory.
           :                                  : - `view_files 0`
............................................................................................

Documentation

• <a href=https://github.com/cyberrumor/ammo/wiki>GitHub Wiki</a>
• <a href=https://deepwiki.com/cyberrumor/ammo/1-overview>DeepWiki</a>

Support

<a href="https://discord.gg/V6qa82Spxw"> <img src="discord_banner.gif" alt="The Discord" /> </a>

License

GNU General Public License v2, with the exception of some of the mock mods used for testing, which are subject to their packaged license (if it exists), which also contains credits.