/ajour

A World of Warcraft addon manager written in Rust.

Primary LanguageRustMIT LicenseMIT

Ajour

Continuous integration Security audit Discord Server Ajour on Patreon

Table of Contents

Introduction

Ajour is a World of Warcraft addon manager written in Rust with a strong focus on performance and simplicity. The project is completely advertisement free, privacy respecting and open source. Ajour currently supports Windows, macOS and Linux.

Download Button

Screenshots

Ajour with default Dark theme Ajour with Solarized Light theme

Features

  • Addons will be parsed automatically and resolved from multiple repositories:
  • Install new addons from the catalog
  • Support for release channels, so it's possible to select either alpha, beta or stable for each addon
  • View changelogs for each addon
  • Bulk addon update without any limitations
  • Remove addons and their dependencies
  • Ignore addons you don't want to update
  • Supports both Retail, Classic, PTR and Beta versions of World of Warcraft
  • 10+ handcrafted themes to choose between
  • Ability to backup your whole UI, including all settings from WTF
  • Ability to run as a command line application for advanced users

Install

Prebuilt binaries for macOS and Windows can be downloaded from the GitHub releases page.

For everyone else, a detailed instruction can be found here.

Themes

Find instructions for building your own themes here.

Command Line

Ajour accepts arguments and can even run certain operations on the command line without launching the GUI, such as updating all addons. This makes it possible to manage your addon collection through scripts and scheduling.

You can pass --help to see a full list of supported flags, options and commands.

Contribute

PRs Welcome

Ajour wouldn't be here without your help. I welcome contributions of any kind, because together we can make Ajour even better.

FAQ

What features are planned?

We have a roadmap here.

What should I do if some addon isn't showing or updating correctly?

We encourage you to raise an issue and tell us all about it! We want Ajour to support as many addons as possible. This means a lot of edge cases. A list of addons with known issues can be found in the wiki.

macOS won't let me open the app, what should I do?

Instead of double clicking it, right click and choose "Open". That should successfully open Ajour.

What requirements does Ajour have?

Windows: DX12 or Vulkan
Linux: Vulkan
macOS: Metal

If you are having problems with these requirements, then try the OpenGL build.

Where does Ajour store its configuration?

Ajour will generate a folder in the following directory:

macOS / Linux:

  • $HOME/.config/ajour

Windows:

  • %APPDATA%\ajour

Inside this folder Ajour will keep a configuration file for storing different user settings, a log file with events from the last session, a fingerprint file with hashed fingerprints for each addon and a theme folder with custom themes.

Why Rust?

We wanted to create an application which natively compiles to both Windows, Linux and macOS while at the same time is as performant and reliable as possible.

Other addon managers

If Ajour isn't your cup of tea, then Ogri'la has done a great job of cataloguing addon managers.

Acknowledgement

License

Ajour is released under the MIT License.