World of Warcraft add-on manager
Project description
instawow is an add-on manager for World of Warcraft. It can be used to install, update and remove add-ons from GitHub, CurseForge, WoWInterface and Tukui. Some of the features of instawow are:
Interoperable CLI and GUI
Fuzzy search with download scoring, backed by a catalogue which combines add-ons from WoWInterface, CurseForge, Tukui and GitHub
Support for add-on URLs and instawow-specific URNs
Add-on reconciliation which works with all three major hosts
Rollback – the ability to revert problematic updates
Multiple update channels
Automatic installation of add-on dependencies
Version pinning of CurseForge and GitHub add-ons
Wago integration – a WeakAuras Companion clone which can be managed like any other add-on
|
|
Installation
You can download pre-built binaries of instawow from GitHub:
If you’d prefer to install instawow from source, you are able to choose from:
pipx: pipx install instawow or pipx install instawow[gui] for the GUI
Vanilla pip: python -m pip install -U instawow or python -m pip install -U instawow[gui] for the GUI
CLI operation
tl;dr
Begin by running instawow reconcile to register previously-installed add-ons with instawow (or instawow reconcile --auto to do the same without user input). To install add-ons, you can search for them using the search command:
instawow search molinari
In addition, instawow is able to interpret add-on URLs and instawow-specific URNs of slugs and host IDs. All of the following will install Molinari from CurseForge:
instawow install https://www.curseforge.com/wow/addons/molinari instawow install curse:molinari instawow install curse:20338
You can update add-ons and remove them just as you’d install them. If update is invoked without arguments, it will update all of your installed add-ons. You can list add-ons and view detailed information about them using list --format detailed. For list and similarly non-destructive commands, the source can be omitted and the slug can be abbreviated, e.g. instawow reveal moli will open the Molinari add-on folder in your file manager.
Add-on reconciliation
Add-on reconciliation is not automatic – instawow makes a point of not automatically assuming ownership of your add-ons. However, you can automate reconciliation with reconcile --auto and instawow will prioritise add-ons from CurseForge. Reconciled add-ons are reinstalled because the installed version cannot be extracted reliably.
Add-on search
instawow comes with a rudimentary search command with results ranked based on edit distance and popularity. Search uses a collated add-on catalogue which is updated once daily. You can install multiple add-ons directly from search.
Reverting add-on updates
instawow keeps a log of all versions of an add-on it has previously installed. Add-on updates can be undone using the instawow rollback command. Add-ons which have been rolled back are pinned and will not receive updates. Rollbacks can themselves be undone with instawow rollback --undo, which will install the latest version of the specified add-on using the default strategy.
Profiles
instawow supports multiple game versions through the use of profiles. Assuming your default profile is configured for retail, you can create a pristine profile for classic by running:
instawow -p classic configure
You can create profiles for other versions of the game (e.g. TBC, PTR or beta) in the same way. Prefix -p <profile> to instawow commands to manage each respective profile.
The any_flavour strategy can be used to install add-ons from CurseForge which do not have Classic releases but are known to work just as well:
instawow -p classic install -s any_flavour https://www.curseforge.com/wow/addons/colorpickerplus
WeakAura updater
instawow contains a WeakAura updater modelled after WeakAuras Companion. To use the updater and provided that you have WeakAuras installed:
instawow weakauras-companion build instawow install instawow:weakauras-companion
You will have to rebuild the companion add-on prior to updating to receive aura updates. If you would like to check for updates on every invocation of instawow update, install the instawow:weakauras-companion-autoupdate variant:
instawow install instawow:weakauras-companion-autoupdate instawow update
Plug-ins
instawow can be extended using plug-ins. Plug-ins can be used to add support for arbitrary hosts and add new commands to the CLI. You will find a sample plug-in in tests/plugin.
Metadata sourcing
CurseForge
CurseForge is set to retire its unauthenticated add-on API by the end of Q1 2022. CurseForge will be issuing keys for the new API conditionally and which add-on managers are obligated to conceal. The new API is therefore unworkable for add-on managers except through a proxy service, which the author of this particular add-on manager cannot afford. At the same time, CurseForge will be providing the option for authors to unlist their add-ons from the new API, and downloads intitiated through the new API will not count towards author credits for the ad revenue sharing programme.
GitHub
instawow supports WoW add-ons released on GitHub – that is to say that the repository must have a release (tags won’t work) and the release must have a ZIP file attached to it as an asset. In addition, releases must have a release.json file which maps release archives to game versions. instawow will not install or build add-ons directly from source, or from tarballs or ‘zipballs’, and will not validate the contents of the ZIP file.
Transparency
Web requests initiated by instawow can be identified by its user agent string.
Every 24 hours, on launch, instawow will query PyPI – the canonical Python package index – to check for instawow updates.
Contributing
Bug reports and fixes are welcome. Do open an issue before committing to making any significant changes.
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
File details
Details for the file instawow-1.37.0.tar.gz.
File metadata
- Download URL: instawow-1.37.0.tar.gz
- Upload date:
- Size: 989.7 kB
- Tags: Source
- Uploaded using Trusted Publishing? No
- Uploaded via: twine/3.7.1 importlib_metadata/4.10.0 pkginfo/1.8.2 requests/2.27.1 requests-toolbelt/0.9.1 tqdm/4.62.3 CPython/3.10.0
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 | a10a2736c269e280eb5f1a8bd506b87fb3c72d2707bef967efc9e7caa7497e9b |
|
| MD5 | 279f6c6524ddf3b91e8a04e50b0287bc |
|
| BLAKE2b-256 | 680eeba1cd3bd356e363b53cdf7e2040ad006128c6b852a26bd66c9fd97563f0 |
File details
Details for the file instawow-1.37.0-py3-none-any.whl.
File metadata
- Download URL: instawow-1.37.0-py3-none-any.whl
- Upload date:
- Size: 412.1 kB
- Tags: Python 3
- Uploaded using Trusted Publishing? No
- Uploaded via: twine/3.7.1 importlib_metadata/4.10.0 pkginfo/1.8.2 requests/2.27.1 requests-toolbelt/0.9.1 tqdm/4.62.3 CPython/3.10.0
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 | f88a7cb5b9f93f05edbde9d43aca2994b5715a2a2c457c386a0b65f9fef34d5f |
|
| MD5 | af6d27904712ca583e1390f8bec16dea |
|
| BLAKE2b-256 | 61898ef9a56e00987d15f194f92f872f93288ae8c847f7f60ea965f99141d0d1 |
