WeakAuras Companion - NoM0Re/WeakAuras-WotLK GitHub Wiki

WeakAuras Companion is an application that adds the missing link between Wago.io and the World of Warcraft addon, enabling you to update your auras conveniently.

Summary

  • WeakAuras Companion requires the folder World of Warcraft/Data/ with at least one file (e.g., file.txt).
  • Use a symlink to _retail_ if you want to keep your original folder names and structure.
  • Always back up your WTF folder before making any changes to protect your configuration.

Important: Backup Your WTF Folder

The WTF folder contains your WoW configuration files, including the crucial config.wtf file that stores all your game settings. Before making any changes, always back up this folder to avoid losing your settings. This is especially important because there is a known issue where launching World of Warcraft after using the Companion can sometimes overwrite or corrupt config.wtf. Having a backup allows you to restore your original settings if that happens.

Creating the Data Folder and File

The Companion requires a Blizzard-like folder structure: Create a main folder named World of Warcraft. Inside it, create two subfolders: _retail_ and Data.

  • The _retail_ folder should contain your full World of Warcraft game installation (including Wow.exe and all other files).
  • The Data folder must contain at least one file (e.g., a simple text file). This file can be empty or contain any text, but it’s necessary for the Companion to function properly.

Required Folder Structure

For WeakAuras Companion to work correctly, your folder layout must look like this:

World of Warcraft/
β”œβ”€β”€ _retail_/Wow.exe
└── Data/file.txt
  • The _retail_ folder holds your WoW game files.
  • The Data folder must be directly inside World of Warcraft and contain at least one file.

How to Create a Symlink (Avoid Renaming or Moving Your Original Folder)

A symbolic link lets you point to your existing WoW _retail_ folder without renaming or moving it. This lets the Companion access the folder as if it was inside World of Warcraft, keeping your original setup intact.

Steps for Creating the Folder Structure and Symlink

On Windows (Command Prompt)

  1. Open Command Prompt as Administrator (required).

  2. Navigate to the drive where you want to create the folders, for example:

cd C:\
  1. Create the main folder, the Data folder inside it, and add a file:
mkdir "World of Warcraft\Data"
echo This is a test file. > "World of Warcraft\Data\file.txt"
  1. Create the symlink _retail_ inside World of Warcraft pointing to your WoW 3.3.5a folder:
mklink /D "C:\World of Warcraft\_retail_" "C:\world of warcraft 3.3.5a"

The command format is:

mklink /D "to_path" "from_path"
  • "to_path" is where the symlink will be created (the new link folder).
  • "from_path" is the real folder the symlink points to (the actual data folder).

On macOS / Linux (Terminal)

  1. Open Terminal.

  2. Navigate to the drive or folder where you want to create the WoW folder, for example:

cd ~/
  1. Create the main folder, the Data folder inside it, and add a file:
mkdir -p "World of Warcraft/Data"
echo "This is a test file." > "World of Warcraft/Data/file.txt"
  1. Create the symlink _retail_ inside World of Warcraft pointing to your WoW 3.3.5a folder:
ln -s "/path/to/your/world of warcraft 3.3.5a" "World of Warcraft/_retail_"

Note: The ln -s command format is:

ln -s "from_path" "to_path"
  • "from_path" is the real folder the symlink points to.
  • "to_path" is where the symlink will be created.

In this example, it creates a symbolic link named _retail_ inside World of Warcraft that points to your actual WoW 3.3.5a installation folder.