# CustomTalkingHead

CustomTalkingHead is a lightweight World of Warcraft Retail addon that customizes Blizzard’s original Talking Head frame without replacing the dialogue system.

It keeps Blizzard’s native artwork and behavior while giving you more control over its appearance. The frame position remains managed through Blizzard Edit Mode.

## Features

- Resize the Talking Head frame from 25% to 150%
- Adjust text size independently from 50% to 200%
- Keep the selected text size fixed at all times
- Automatically divide long dialogue into pages instead of shrinking the text
- Show or hide the portrait and its surrounding artwork
- Choose between several native Blizzard fonts
- Adjust background opacity from 0% to 100%
- Use a silent screen preview before testing with real dialogue
- Save settings account-wide
- Automatic localization for English, Spanish, French, German, Italian, and Portuguese
- No external libraries or dependencies

## Fixed text size and automatic paging

CustomTalkingHead never automatically reduces the text size selected by the user.

When a dialogue line is too long to fit, the addon divides it into automatic pages while keeping the same font size. Words are not split, and the pages advance during the original voice line.

## Portrait controls

The portrait can be shown or hidden.

When it is hidden, the dialogue text uses the available space on the left side of the frame. This only changes the visual presentation and does not skip, close, or ignore the dialogue.

## Background opacity

Background opacity can be adjusted from 0% to 100%.

- 0% removes the text background
- 50% matches Blizzard’s original appearance
- 100% adds a fully opaque backing while preserving the native artwork

## Positioning

CustomTalkingHead does not add a separate dragging system.

Use Blizzard Edit Mode to move the Talking Head frame. The addon respects the position and footprint saved by Edit Mode.

## Audio and chat

CustomTalkingHead does not modify:

- Voice playback
- Audio volume
- Chat events
- Dialogue skipping
- Talking Head close behavior

It only changes the visual presentation of the frame.

## Slash commands

`/cth`
Open the settings panel.

`/cth preview`
Show or hide the silent screen preview.

`/cth scale 80`
Set the frame scale.

`/cth text 125`
Set the fixed text size.

`/cth background 50`
Set the background opacity.

`/cth portrait on`
Show the portrait.

`/cth portrait off`
Hide the portrait.

`/cth reset`
Restore the default settings.

## Default settings

- Frame scale: 60%
- Text size: 100%
- Portrait: enabled
- Background opacity: 50%
- Font: Blizzard Default

## Compatibility

Designed for World of Warcraft Retail.

## Feedback and bug reports

When reporting a problem, please include:

- WoW client language
- Resolution or UI scale
- Frame scale and text size
- Whether the portrait was enabled
- A screenshot or Lua error, when available