/CurseBreaker

TUI/CLI addon updater for World of Warcraft.

Primary LanguagePythonGNU General Public License v3.0GPL-3.0

CurseBreaker

TUI/CLI addon updater for World of Warcraft.

Screenshot

DOWNLOAD

The latest release can be found here.
Please be aware that Linux (.gz) and macOS (.zip) versions are not thoroughly tested.
Windows 10+, Ubuntu 20.04+, Debian 11+ and macOS 11+ are supported.

USAGE

Place CurseBreaker binary inside the directory containing Wow.exe, WowClassic.exe or World of Warcraft.app.
Read the instructions on the top of the screen.

Already installed addons will not be recognized by CurseBreaker and they need to be reinstalled.
This process can be partially automated by using the import command.

Retail, WotLK Classic and Classic clients are supported. The client version is detected automatically.
By default CurseBreaker will create backups of the entire WTF directory.

TIPS & TRICKS

  • TUI will look a lot better if the application is started by something else than the default Windows command prompt. Windows Terminal is recommended.
  • Many of the fields are links if used terminal emulator supports them.
  • On Windows command uri_integration can be used to enable integration with the Wago Addons and Wago page.
  • Most of the commands support the space-separated list of addons.
  • install command have an optional -i flag that can be used to disable the client version check.
  • Environment variable CURSEBREAKER_PATH can be used to set the custom location of WoW client.
  • The application can be run in non-interactive mode by providing commands directly as a parameter.
  • When the application is started with a headless parameter entire addon and Wago upgrade process plus WTF backup should be executed in the background. Log file CurseBreaker.html will be created in the same directory as the application.

SUPPORTED URL

  • Wago Addons: https://addons.wago.io/addons/[addon_name], wa:[addon_name]
  • WoWInterface: https://www.wowinterface.com/downloads/[addon_name], wowi:[addon_id]
  • Tukui: ElvUI, Tukui
  • GitHub: Development versions of multiple addons. Slugs are suffixed with :Dev.
  • GitHub Releases: https://github.com/[username]/[repository_name], gh:[username]/[repository_name]
  • Wago: CurseBreaker can update auras and Plater profiles/scripts like WeakAuras Companion.

WAGO ADDONS SUPPORT

To use Wago Addons as addon source user needs to provide a personal API key. It is a paid feature.
The key can be obtained here and needs to be added to the application configuration by using set wago_addons_api command.

WEAKAURAS SUPPORT

CurseBreaker by default will try to update all detected WeakAuras and Plater profiles/scripts. Process work the same as WeakAuras Companion.
All updates will still need to be applied in-game in the WeakAuras/Plater option menu.
Command toggle wago can be used to set a single author name that will be ignored during the update.
Additionally Wago API key can be set with set wa_api command so non-public entries will also be upgradeable.

GITHUB SUPPORT

When GitHub is frequently used as a source for addons there is the possibility of reaching a query limit.
If that occurs user must get a personal access token. And then add it to the application configuration by using set gh_api command.

KNOWN ISSUES

  • Using WoWInterface projects that provide multiple addon releases (example) will always install a retail version of the addon. It can't be fixed as WoWInterface API doesn't support this type of project.
  • Some WoWInterface addon categories (e.g. Compilations, Optional) are not handled by their API. Addons in these categories can't be installed.
  • WoWInterface projects that need to install files outside the Interface\AddOns directory are not supported.

COPYRIGHT

CurseBreaker is a free software/open source, and is distributed under the GNU General Public License v3.

Icon made by Nikita Golubev is licensed by CC 3.0 BY.