wowaddon

README

wowaddon

Manager for World of Warcraft addons

Features

• Install addons from Curse and TukUI
• Uninstall addons
• Update addons
• Search for new addons
• List installed addons, showing which are "out of date"
• Show addon metadata
• Show which directories are used by which addons
• No complex setup, it discovers your current set of addons

Installation

Download the file from the github release page, unzip it and put it somewhere on your path.

Run wowaddon environment. If it can't find your World of Warcraft installation in the normal places you can set the environment variable WOWDIR to override it.

Usage

To install Fishing Buddy run wowaddon install fishingbuddy. The name needed is the one used for the addon at the source you're fetching the addon from or returned by wowaddon search. For addons installed from Curse, it's the name you see in the URL of the page, such as deadly-boss-mods or weakauras-2.

To list the installed addons run wowaddon list.

To update everything that needs to be updated run wowaddon update.

To sync with new addons if they've been installed manually, or to create your first configuration file run wowaddon bootstrap.

To search for new addons for your druid to install run wowaddon search druid.

NAME:
   wowaddon - Install WoW addons

USAGE:
   wowaddon [global options] command [command options] [arguments...]

VERSION:
   0.2.0

AUTHOR(S):
   Steve Atkins <steve@blighty.com>

COMMANDS:
     install, i         Install addon `NAME`
     update, u          Update all addons
     search, s          Search for new addons
     uninstall          Uninstall addon `NAME`
     reinstall          Reinstall all addons
     checkupdate        List addons that can be updated
     folders, list, ls  List addons and their folders
     blame              Show which addon created a folder
     environment, env   Show environment
     info               Show information about installed addons
     fullinfo           Show toc metadata about installed addons
     bootstrap          Create a configuration file from existing addons
     dlurl              Find a download URL
     help, h            Shows a list of commands or help for one command

GLOBAL OPTIONS:
   --wowdir value, --dir value, -d value  WoW base directory [$WOWDIR]
   --config value, -c value               Use an alternate configuration file [$WOW_ADDON_CONFIG]
   --cache value                          Use an alternate cache directory [$WOW_ADDON_CACHE]
   --help, -h                             show help
   --version, -v                          print the version

Compilation

Install pre-requisites and build

go get -u .
go build

This will create a single binary, wowaddon or wowaddon.exe that can be copied to any machine and run with no other prerequisites.

Inspiration

This tool was inspired by wow-cli, a similar tool written in Javascript/node.

The user interface is very similar, and the configuration file is nearly identical - if you're using wow-cli you can copy your .addons.json to addons.json, remove any addons sourced from anywhere other than Curse and it should work with wowaddon.

Issues

Coloured text works on Windows 10, OS X and (probably) Linux. It doesn't work in a vanilla Windows 7 command prompt. It's still perfectly usable, but not as pretty.

License

Two-clause BSD