# AIOS CopyBox

AIOS CopyBox gives World of Warcraft chat a separate, selectable text window.
Open it when you need to copy a message, review older lines, or watch one chat
tab without changing your normal chat layout.

Despite the name, CopyBox is standalone. AIOS Core and AIOS_UI are not required.

## What it does

- Loads the existing scrollback from your selected chat window.
- Adds new messages while CopyBox remains open.
- Lets you move forward or backward through available chat windows.
- Preserves clickable item, spell, and achievement links.
- Offers several built-in color and texture themes.
- Remembers its position, selected theme, channel, and settings.
- Defers opening until combat ends when the UI is restricted.

## Commands and controls

Type `/copybox` or `/cb` to open the window.

- Drag the header to move the window.
- Left-click **Channel** for the next chat window; right-click for the previous one.
- Left-click **Theme** for the next theme; right-click for the previous one.
- Click **Select All**, then press Ctrl+C to copy the highlighted text.
- Right-click **Select All** to clear the text box.
- Use **Open/Close** to expand or collapse the window.
- Use the mouse wheel to move through chat history.

The Settings panel controls font size, maximum stored lines, scroll locking,
timestamps, and live updates. The maximum is 1,000 lines to avoid UI slowdowns.

## Installation and compatibility

Extract the ZIP into `World of Warcraft/_retail_/Interface/AddOns/`. The final
folder should be named `AIOS_CopyBox`. Restart the game or type `/reload`.

Version 1.0.1 supports World of Warcraft Retail 12.1.0 and retains the Retail
and Classic interface targets listed in `AIOS_CopyBox.toc`.

## Notes

- Voice-chat frames are intentionally excluded.
- Timestamps apply to messages received while CopyBox is open; Blizzard's
  historical chat entries do not include their original timestamps.
- CopyBox cannot write chat to a text file because WoW addons cannot write
  arbitrary files while the game is running.
