# Vamoose's Dye Studio
**A dye companion for WoW Housing. Browse all 62 dyes by color, build custom palettes, plan your purchasing with target stocks, and dye decor live with a Blizzard-replacement picker.**
A standalone dye companion. No other addons required (Auctionator optional for Send-to-AH).
---
## What's New in v2.7.0
- **Saved Dyes** -- saved dye combinations now use one name everywhere. The live editor's save button is "Save Dyes", the gallery and the Canvas chip wall are "Saved Dyes", and the save popup names new entries "Saved 1", "Saved 2".
- **Auto-save is on by default** -- every Apply saves that decor type's dyes as a Saved Dyes entry. Existing installs get the setting switched on once with this update; turn it off in Config if you prefer manual saves. Your hand-typed entry names are never overwritten by auto-saves.
- **Auto-stage newest** -- an optional checkbox on the Saved Dyes panel. When it is on, selecting a decor whose type has Saved Dyes pre-loads the newest entry as pending changes, so dyeing a row of identical bookshelves is one Apply per piece. Nothing is spent until you Apply, and Revert clears it.
- **Shift-click searches the Auction House** -- shift-click any dye row or herb row to run a Browse search for it (the AH must be open). This works from every tab, switches the AH to the Buy view if needed, and on the 12.1 PTR searches the family dye item.
- **Nine colour families** -- the Colors tab now groups dyes into the nine official families (Red, Orange, Yellow, Green, Blue, Purple, Brown, Black, White), ordered light to dark within each family. Family headers show how many applications you hold; dyes you cannot apply are dimmed.
- **Ready for patch 12.1** -- on the PTR, Dye Studio understands the new family-dye model end to end: the Herbs tab becomes a per-family crafting cost planner, the Stock tab pools counts by the shared family stack, and dye herbs in your bags wear small coloured dots for the families they craft (with a tooltip listing the dyes). Nothing changes on 12.0.7.
## Features
### Dye Browser
Browse every housing dye with multiple ways to organize them.
- **Colors tab** — the nine official dye families (Red, Orange, Yellow, Green, Blue, Purple, Brown, Black, White), each section ordered light to dark. Click a chip to filter; click "All" to see grouped sections. Family headers show the applications you hold.
- **Custom tab** — Your own saved palettes with side popout. Click any palette to filter; Edit mode lets you click dyes to add/remove. Import/export strings to share.
- **Theme tab** — 23 curated palettes (factions, classes, seasons).
- **Herbs tab** — Reverse-lookup which dyes each herb crafts into, with current AH prices per herb and stock counts. On the 12.1 PTR this becomes a per-family cost planner: each family row shows the cheapest craft cost per dye next to the dye's own AH price and how many you can craft from herbs on hand.
- **Owned filter** — The "Owned only" toggle in Live mode's action bar shows only dyes in your inventory (bags + bank + reagent bank + warband).
- **Search** — Filter the dye list by name; works across all tabs.
- **Shift-click** any dye or herb to search the Auction House for it.
### Color Harmony
Pick a dye and Dye Studio suggests colour companions for it, drawn from the full dye catalogue.
- **Strategies** — Neutral grounding, Monochromatic (lighter and darker of the same hue), Analogous (wheel neighbours), Complement (the opposite), Split-complementary, Triadic, and Clash (a deliberately discordant hue). A neutral dye swaps these for Tones, Contrast, and Accent.
- **Colors tab** — the suggestions appear as a band of swatches beneath the selected dye, over a wash of that colour. Click a swatch to jump to that dye.
- **Live mode and Canvas** — a strategy strip (Live) or a Harmonise menu (Canvas) fills the decor's other channels around your focused channel in one click, completing every channel of the piece.
- **Coverage-aware** — each channel shows what part it dyes and how much of the decor's surface it covers ("Part - Material - NN%"). Harmonise reads this to place the lead colour on the largest surface. The "Apply all" toggle re-dyes every channel from one starter dye, balanced by area.
### Stock Tab
Plan your dye purchasing across your full collection target rather than one dye at a time.
- **Per-color-group targets** — "Target 3 of every red dye" sets the floor for the whole group. Collapsible per-group sections show have, target, and need.
- **Per-dye overrides** — Want 10 Horde Red specifically? Override the group default; a small revert button lets you reset back to the group baseline. (12.0.7 only: on the 12.1 PTR a family shares one dye stack, so targets are set per family.)
- **Master +/-** — Bumps every group target up or down by 1 (shift+click for 10).
- **Two modes**:
- **Buy** — restock by buying finished dyes from the AH
- **Craft** — restock by buying herbs and crafting. The side panel shows the consolidated herb shopping list with each herb's cheapest unit price and total cost
- **One-click Restock-and-Send-to-AH** — Sends a shopping list to Auctionator (separate VDS-Dyes and VDS-Herbs lists per mode). Auctionator is optional. If it's not installed, the send button shows a prompt instead of erroring.
- **Cost rollups** — Top stat strip shows at-target, total, deficit, and cost. Bottom button shows total spend before you commit.
### Custom Palettes
Create, edit, and share color combinations.
- **Up to 20 palettes** with up to 20 dyes each
- **Auto-named when you create one** — "Palette 1", "Palette 2"... or type your own
- **Edit mode** — Click any dye in the main list to toggle membership. The dye chips above show the current contents
- **Import / Export** — Share palettes as encoded strings. The import dialog accepts the current `VDS:` format and the legacy `VDSR:` format from the beta
- **Rename / Delete / Export** buttons under the palette list
### Live Dye Mode
Replaces Blizzard's dye picker with VDS when you open a decor's dye slot.
- **Auto-open** — Toggle "Replace Blizzard's dye picker" in Config. On by default. The VDS window opens automatically inside the housing editor when you click a dye slot.
- **Per-slot focus** — The active slot has a gold border (matching the Canvas channel picker). Click any dye to apply to the focused slot.
- **Cost preview** — "+N dye(s) -N back" tracks Blizzard's dye-bottle costs as you preview changes.
- **Recent dyes strip** — The last 12 dyes you applied show as swatches under the action bar. Click one to apply it to the focused slot. Saved account-wide between sessions.
- **Owned-only warnings** — Slot labels go red when you're previewing a dye you don't own, and the locked Apply button's tooltip names the missing dye.
- **Revert / Apply** — Apply commits your changes. Revert puts every slot back to the last applied state and keeps you in the editor. Both grey out when there are no pending changes.
- **Owned only toggle** — Action-bar checkbox filters the dye list to dyes you own while editing.
- **Auto-save** — On by default ("Auto-save dyes on Apply" in Config) saves each applied combination as a Saved Dyes entry.
- **Save Dyes button** — Saves the decor's currently displayed dyes without applying them.
- **Auto-stage newest** — Optional checkbox on the Saved Dyes panel: selecting a decor whose type has Saved Dyes pre-loads the newest entry as pending changes.
### Canvas Tab
Preview dye combinations on a 3D decor model before applying them to a real decor.
- **Decor picker with category filter** — Category dropdown narrows the list to a Housing category (Furnishings, Walls, etc.)
- **Scope filter at the top** — Narrows the available dyes to a curated theme or one of your custom palettes; default is "All Dyes"
- **Available decor** — Lists every available dyeable decor, owned or unowned
- **Per-row channel droplets and saved-dyes count** — Each picker row shows droplet icons for the decor's dye channels and a count badge for its Saved Dyes
- **Saved Dyes chip wall** — Saved entries for the selected decor appear as color chips below the channel pickers in the preview panel. Click a chip to apply
- **Per-channel editor** — Pick a channel, pick a dye, see it on the model immediately
- **3D ModelScene preview** — Drag to orbit, scroll to zoom
- **Saved dyes per decor** — Auto-named "Saved 1", "Saved 2"... or type your own. Saving the same combination twice no longer creates a duplicate. Up to 10 saved entries per decor
- **Save via the chip wall** — The "+" tile at the end of the chip wall saves the current channel selections as a new entry
- **Random / Clear** — Quick-action buttons under the channel editor. Random fills channels from the current Scope; Clear empties all three channels
- **Saved Dyes also appear in Live mode's gallery** — Live's gallery shows the same entries as 3D preview tiles with hover-X to delete
---
## Quick Start
Type **`/dyes`** or **`/vds`** to open the Dye Studio.
### Commands
- `/dyes` or `/vds` — Toggle Dye Studio
- `/vds debug` — Toggle debug logging
- `/vds minimap` — Toggle the minimap icon
- `/vds hardreset` — Wipe all VDS data (requires /reload)
### Pro Tips
- **Click a dye** to select it (detail strip shows below). **Shift-click** to search the AH by name.
- **Stock tab is the new shopping workflow.** The per-row cart count is gone; targets in the Stock tab drive the Restock-and-Send-to-AH flow.
- **Canvas right-click** clears the active channel. **Canvas left-click** applies the dye to the active channel.
- **Live mode** keeps the same window open inside Blizzard's housing editor.
- **Custom palettes** — Click "+ New" and press Enter to accept the auto-name. Click "Edit" to start clicking dyes to add or remove.
- **Help button (?)** in the title bar shows the full feature guide.
- **Minimap button** — Click to toggle the studio, drag to reposition. Hide it with `/vds minimap` or the Config toggle.
---
## Installation
1. Download from CurseForge (or extract to `World of Warcraft/_retail_/Interface/AddOns/`)
2. Folder must be named `VamoosesDyeStudio`
3. `/reload` in-game
4. Type `/dyes` to open
---
## Requirements
- World of Warcraft: Midnight (12.0.0+)
- Access to Housing (level requirement)
---
## More Addons by Vamoose
---
## Support & Feedback
Found a bug or have a suggestion? Report it on our Discord.
---
**Author:** Vamoose
**Version:** 2.7.0
**Game Version:** 12.0.5 / 12.0.7 (Midnight)
---
*Keywords: dye, dyes, dyeing, color, colors, colour, colours, housing, house, decor, decoration, palette, palettes, theme, pigment, herb, herbs, crafting, restock, auction, auctionator, midnight, 12.0.7, 12.1, blizzard replacement, dye picker, canvas, loadout, swatch, dye studio, vamoose*
