Skip to main content

A CLI package manager for mods

Project description

Portmod

pipeline Build status coverage PyPI Code style: black Supported Python versions Chat Checked with mypy Imports: isort pre-commit

A cross-platform cli package manager for mods. Based on Gentoo's Portage package manager.

Currently the only supported game is OpenMW, via the openmw-mods repository.

See the Wiki for details on Installation and Setup.

Features

  • Automatic Downloads (where possible): If direct links are available to mod archive files, portmod will fetch them automatically. As many mods have restrictive licenses and are distributed via sites which do not provide direct links, this is not always possible.
  • Automatic patching: Mods are organized into packages which contain both the base mod and any necessary patches. Patches can be configured (in the package) to only be installed when certain other packages are installed, so that all you need to do when installing packages is choose the ones you want and all necessary patches will be included automatically.
  • Automatic Configuration: Mod packages can declare optional features (called Use Flags), which can either be independently enabled/disabled (local flags), or enabled/disabled along with other packages which share the same feature (global flags).
  • Structure Awareness: Portmod's package files contain information about the directory structure of the archives which explain precisely how the mod should be installed.
  • Automatic sorting: The install order and the load order of plugin and fallback archive files are sorted automatically based on rules defined in the packages. These rules can be customized with user rules.
  • Automatic updates: When mod updates are released and new package files are created in the portmod repository, you can find and update all your installed mods using a single command. Due to portmod requiring more information than upstream sources usually provide, will be a delay after the upstream mod is updated while new package files are created.
  • Dependencies: Portmod will automatically install dependencies for the mods you ask it to install.
  • Mod collections: Portmod supports both metapackages (packages containing lists of other packages which are distributed in the repository), as well as custom package sets (easy to set-up package lists that exist in the user's configuration).
  • Multiple Game Engines: Portmod just defines the package format and installation process, and has a programmable interface to allow custom game-engine-specific configuration. A list of supported Game Engines can be found on the Wiki.

Installation, Setup and Usage

See the Guide on the wiki.

Future Plans

This list is updated infrequently. See the Issues for up-to-date information.

  • Mod packaging and submission: Support for build files being distributed with mods and automatically submitted to a repository using a cli tool.

Communication

Release announcements and other major news will be posted to the announcement mailing list. This list is read-only (see below for the list you can contact).

There are a number of ways to communicate with the developers and with other users:

Packaging status

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Files for portmod, version 2.1.1
Filename, size File type Python version Upload date Hashes
Filename, size portmod-2.1.1.tar.gz (236.0 kB) File type Source Python version None Upload date Hashes View
Filename, size portmod-2.1.1-cp39-cp39-win_amd64.whl (974.2 kB) File type Wheel Python version cp39 Upload date Hashes View
Filename, size portmod-2.1.1-cp39-cp39-manylinux_2_17_x86_64.manylinux2014_x86_64.whl (1.6 MB) File type Wheel Python version cp39 Upload date Hashes View
Filename, size portmod-2.1.1-cp39-cp39-macosx_10_15_x86_64.whl (1.1 MB) File type Wheel Python version cp39 Upload date Hashes View
Filename, size portmod-2.1.1-cp38-cp38-win_amd64.whl (972.6 kB) File type Wheel Python version cp38 Upload date Hashes View
Filename, size portmod-2.1.1-cp38-cp38-manylinux_2_17_x86_64.manylinux2014_x86_64.whl (1.6 MB) File type Wheel Python version cp38 Upload date Hashes View
Filename, size portmod-2.1.1-cp38-cp38-macosx_10_15_x86_64.whl (1.1 MB) File type Wheel Python version cp38 Upload date Hashes View
Filename, size portmod-2.1.1-cp37-cp37m-win_amd64.whl (972.9 kB) File type Wheel Python version cp37 Upload date Hashes View
Filename, size portmod-2.1.1-cp37-cp37m-manylinux_2_17_x86_64.manylinux2014_x86_64.whl (1.6 MB) File type Wheel Python version cp37 Upload date Hashes View
Filename, size portmod-2.1.1-cp37-cp37m-macosx_10_15_x86_64.whl (1.1 MB) File type Wheel Python version cp37 Upload date Hashes View
Filename, size portmod-2.1.1-cp36-cp36m-win_amd64.whl (971.3 kB) File type Wheel Python version cp36 Upload date Hashes View
Filename, size portmod-2.1.1-cp36-cp36m-manylinux_2_17_x86_64.manylinux2014_x86_64.whl (1.6 MB) File type Wheel Python version cp36 Upload date Hashes View
Filename, size portmod-2.1.1-cp36-cp36m-macosx_10_15_x86_64.whl (1.1 MB) File type Wheel Python version cp36 Upload date Hashes View

Supported by

AWS AWS Cloud computing Datadog Datadog Monitoring Facebook / Instagram Facebook / Instagram PSF Sponsor Fastly Fastly CDN Google Google Object Storage and Download Analytics Huawei Huawei PSF Sponsor Microsoft Microsoft PSF Sponsor NVIDIA NVIDIA PSF Sponsor Pingdom Pingdom Monitoring Salesforce Salesforce PSF Sponsor Sentry Sentry Error logging StatusPage StatusPage Status page