![ShamanForever: a shaman HUD for World of Warcraft: Forever](docs/banner.png)

A configurable HUD for shamans on World of Warcraft: Forever: the buffs, imbues and cooldowns a shaman watches, as icons you can arrange anywhere. Requires WoW: Forever (interface 16001).

<a href="docs/gallery/README.md"><img src="docs/gallery/hud-preview-and-unlocked.png" width="560" alt="ShamanForever's HUD in preview mode with positioning unlocked"></a>

More screenshots: [options gallery](docs/gallery/README.md).

## Download

- [CurseForge](https://www.curseforge.com/wow/addons/shamanforever)
- [Wago](https://addons.wago.io/addons/shamanforever)
- [GitHub releases](https://github.com/cassidymichael/ShamanForever/releases)

## Features

A collection of highly configurable HUD elements designed to help shamans playing World of Warcraft: Forever.

Some highlights include:

**Totem bar**: Fully configurable totem bar replacing the default or active totem frames: drop, pick and dismiss totems, Call of the Elements and Totemic Recall, out of range warning, key bindings, themes, and more.

**Shield helpers**: Lightning Shield and Water Shield tracking. Style and animate based on charges left.

**Shock trackers**: Earth, Flame, and Frost Shock monitoring for cooldown, range, mana.

**Flame Shock**: Track Flame Shock on your target with style and animations based on time left or debuff missing.

**Purge**: Show and glow an icon when your target has a purgeable magic buff, with buff duration filter.

**Weapon Imbues**: Rockbiter, Flametongue, Frostbrand, and Windfury imbue status. Warn when missing.

**Swing timer**: Melee swing timer shown as a bar.

**Dedicated ability and proc trackers**: Custom made indicators for shaman abilities such as Stormstrike, Fire Nova, Chain Lightning, Riptide, Rage of the Farseer, Nature's Swiftness, Mana Tide Totem, Earthbind Totem, Tremor Totem, Grounding Totem, Stoneclaw Totem, Totemic Projection, Elemental Focus, Maelstrom Weapon, Flurry, Improved Stormstrike. Not just cooldowns, also event, duration and condition-based warnings and animation styles.

**Utility and reagent trackers**: Water Walking, Water Breathing, Reincarnation. Know when you are low on reagents, see Reincarnation cooldown, get warnings on buff expiry or when drowning.

**Racial trackers**: All shaman races have their racial abilities included; Stoneform, Blood Fury, Shatter Curse, Berserking, Rapid Regeneration, Skysight, Walk on Air, War Stomp.

**Extremely customisable styling**: Font and text styles, border options, bar textures, including those from other installed addons through LibSharedMedia.

**Layout and preview system**: Drag and drop element groups live on the screen and quickly adjust size, scale, opacity. Get a sense of the action with preview modes. Structured group-based layout for consistency of layout.

**Many opacity and idle settings**: Control the opacity of all groups, plus dedicated "idle when" logic to allow setups like hiding an element when it's on or off cooldown, when a buff is up or down, only in combat, and more.

... and many more! Feature requests are highly encouraged. Please help us make this addon more valuable for all shamans!

## Usage

*   `/sf` opens the options window (or use the minimap button).
*   Key bindings for the totem bar: Escape > Options > Keybindings > ShamanForever, or use the Quick Keybinds feature.
*   `/sf lock` to unlock positioning.
*   `/sf preview` shows your HUD in various modes to get a sense of it in action.

## Feedback

Ideas, requests or problems are welcome, any of these ways:

- A post in `#feedback` on [Discord](https://discord.gg/VaXH8CQZFG).
- A comment on [CurseForge](https://www.curseforge.com/wow/addons/shamanforever/comments).
- An [issue on GitHub](https://github.com/cassidymichael/ShamanForever/issues).

## Development

ShamanForever is created and maintained with the help of AI tools.

- [CHANGELOG.md](CHANGELOG.md): what changed in each version.

## Art

The options banners are public-domain paintings: Thomas Moran, *The Chasm of the Colorado*; Joseph Wright of Derby, *Vesuvius from Portici*; Frederic Edwin Church, *Rainy Season in the Tropics* and *Aurora Borealis*; Francisque Millet, *Mountain Landscape with Lightning*. The corner and divider ornaments are public domain / CC0 (Wikimedia Commons). The logo is Blizzard's shaman crest, redrawn, over the same paintings and Ivan Aivazovsky's *Breaking Wave*, with a CC0 wood texture from ambientCG. The link icons on the About page are from Simple Icons (CC0). Spell icons are Blizzard's, from the game, as is the art of the Cooldown Manager, Forever action button, Outer halo, Proc glow and Blizzard's flash looks, and of the totem theme modelled on Blizzard's totem bar. The Carved stone, Aged bronze and Carved wood borders and the Emblem pop burst were made with an AI image model (Google Gemini), as was the art of the Stone and bronze, Stone bosses, Wood and bone and Iron and ember totem themes.

## Licence

Copyright (C) 2026 Michael Cassidy. ShamanForever is free software: you can redistribute it and/or
modify it under the terms of the GNU General Public License as published by the Free Software
Foundation, either version 3 of the License, or (at your option) any later version. See LICENSE.

Releases up to 0.12.1 were published under the MIT licence. The bundled libraries (LibStub,
CallbackHandler, LibDataBroker, LibDBIcon) keep their own licences.