Table of Contents

• Introduction
• Screenshots
• Features
• Install
• Themes
• Keybindings
• Command Line
• Contribute
• FAQ
• Acknowledgement

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.

Screenshots

Features

• Addons will be parsed automatically and resolved from multiple repositories:
  • Tukui
  • CurseForge
  • WoWInterface
  • Hub
• Install new addons from the catalog or directly from a GitHub/GitLab URL
• 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 Era, Classic Tbc, Ptr and Beta versions of World of Warcraft
• 10+ handcrafted themes to choose between
  • Ability to add your own custom themes
• Ability to backup your whole UI, including all settings from WTF
• Ability to run as a command line application for advanced users
• WeakAuras and Plater import strings from Wago.io will automatically be parsed
• Localized in multiple languages

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

Use the theme builder (source) website to quickly generate custom themes. Once you are done press copy and paste the value into Import Theme inside Settings in Ajour.

Custom themes will be saved in this location:

macOS / Linux:

• $HOME/.config/ajour/themes

Windows:

• %APPDATA%\ajour\themes

Keybindings

Command Line

Find instructions for using the command line interface here

Contribute

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

• Let me know if you are missing a vital feature.
• I love pull requests and bug reports.
• Don't hesitate to tell me my Rust programming is bad but please tell me why.
• Help translating Ajour on POEditor.
• Join our Discord server and say hey.

FAQ

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.

Acknowledgement

• Rasmus Nielsen for the Ajour icon.
• Rune Seir for the Ajour banner.

License

Ajour is released under the GPL-3.0 License.