Customization Overview

Two-Face is highly customizable, allowing you to tailor every aspect of your gameplay experience.

Customization Areas

Two-Face can be customized in these areas:

Area	Purpose	Configuration
Layouts	Window arrangement	`layout.toml`
Themes	Colors and styling	`colors.toml`
Highlights	Text pattern matching	`highlights.toml`
Keybinds	Keyboard shortcuts	`keybinds.toml`
Sounds	Audio alerts	Per-highlight
TTS	Text-to-speech	`config.toml`

Quick Customization Commands

Command	Opens
`.layout`	Layout editor
`.highlights`	Highlight browser
`.keybinds`	Keybind browser
`.colors`	Color palette browser
`.themes`	Theme browser
`.window <name>`	Window editor

Customization Guides

This section covers:

Creating Layouts - Design your window arrangement
Creating Themes - Customize colors and styling
Highlight Patterns - Advanced text matching
Keybind Actions - All available actions
Sound Alerts - Audio notifications
TTS Setup - Text-to-speech configuration

Per-Character Customization

Each character can have unique settings:

~/.two-face/
├── config.toml              # Global defaults
├── layout.toml              # Default layout
├── colors.toml              # Default colors
├── highlights.toml          # Default highlights
├── keybinds.toml            # Default keybinds
└── characters/
    └── MyCharacter/
        ├── layout.toml      # Character-specific layout
        ├── colors.toml      # Character-specific colors
        ├── highlights.toml  # Character-specific highlights
        └── keybinds.toml    # Character-specific keybinds

Configuration Loading Order

Character-specific file (if exists)
Global file (fallback)
Embedded defaults (final fallback)

Example: Profession-Based Layouts

Create different layouts for different professions:

~/.two-face/characters/
├── Warrior/
│   └── layout.toml    # Combat-focused layout
├── Empath/
│   └── layout.toml    # Healing-focused layout
└── Wizard/
    └── layout.toml    # Spell-focused layout

Hot-Reloading

Many settings can be reloaded without restarting:

Command	Reloads
`.reload colors`	Color configuration
`.reload highlights`	Highlight patterns
`.reload keybinds`	Keyboard shortcuts
`.reload layout`	Window layout
`.reload config`	All configuration

Backup Your Customizations

Before major changes:

# Backup all configuration
cp -r ~/.two-face ~/.two-face-backup

# Backup specific file
cp ~/.two-face/layout.toml ~/.two-face/layout.toml.bak

Share your configurations with others:

Export relevant .toml files
Share via GitHub Gist, Discord, etc.
Others can copy to their ~/.two-face/ directory

Popular Layout Packs

The Two-Face community shares layout packs:

Hunting layouts
Merchant layouts
Roleplay layouts
Accessibility layouts

Customization Tips

Start Simple

Begin with default settings and customize incrementally:

Play with defaults for a few sessions
Identify pain points
Make one change at a time
Test each change before moving on

Use the Editors

The built-in editors are often easier than editing files:

.layout          # Visual layout editor
.highlights      # Browse and edit highlights
.keybinds        # Browse and edit keybinds
.window main     # Edit main window properties

Keep Notes

Document your customizations:

# In any .toml file, add comments:

# Combat creature highlighting
# Red for dangerous, orange for normal
[creature_dangerous]
pattern = "(?i)\\b(dragon|lich|demon)\\b"
fg = "#FF0000"

Test in Safe Areas

Test new configurations in safe game areas before combat:

Make changes
Reload: .reload highlights
Test with game output
Adjust as needed

Two-Face Documentation