Character Profiles

Two-Face supports per-character configuration through profiles, allowing different layouts, highlights, and settings for each character.

Overview

Profiles let you:

Use different layouts for different playstyles (hunting warrior vs. merchant)
Customize highlights per character (different friend lists, creature lists)
Override any global setting on a per-character basis

Profile Structure

Profiles are stored in ~/.two-face/profiles/<CharacterName>/:

~/.two-face/
├── config.toml           # Global defaults
├── layout.toml           # Global layout
├── keybinds.toml         # Global keybinds
├── highlights.toml       # Global highlights
├── colors.toml           # Global colors
│
└── profiles/
    ├── Warrior/          # Warrior's profile
    │   ├── layout.toml   # Warrior's layout
    │   └── highlights.toml
    │
    ├── Wizard/           # Wizard's profile
    │   ├── layout.toml
    │   ├── highlights.toml
    │   └── keybinds.toml
    │
    └── Merchant/         # Merchant's profile
        └── layout.toml

Using Profiles

Loading a Profile

Specify the character name when launching:

two-face --character Warrior

Or set a default in config.toml:

[connection]
character = "Warrior"

Profile Loading Order

Load global config from ~/.two-face/
If profile exists, overlay files from profiles/<CharName>/
Missing profile files fall back to global

Example flow for --character Warrior:

File	Source
config.toml	Global (no profile override)
layout.toml	`profiles/Warrior/layout.toml`
keybinds.toml	Global (no profile override)
highlights.toml	`profiles/Warrior/highlights.toml`
colors.toml	Global (no profile override)

Creating a Profile

Method 1: Manual Creation

# Create profile directory
mkdir -p ~/.two-face/profiles/MyCharacter

# Copy files you want to customize
cp ~/.two-face/layout.toml ~/.two-face/profiles/MyCharacter/
cp ~/.two-face/highlights.toml ~/.two-face/profiles/MyCharacter/

# Edit the copies
vim ~/.two-face/profiles/MyCharacter/layout.toml

Method 2: Start from Defaults

Launch with a new character name:

two-face --character NewCharacter

Two-Face uses global defaults. Then copy and customize as needed.

Profile-Specific Settings

Layout Differences

A warrior might want:

# profiles/Warrior/layout.toml

[[windows]]
name = "main"
type = "text"
width = "70%"
height = "80%"

# Large status area for combat
[[windows]]
name = "vitals"
type = "dashboard"
width = "30%"
height = "40%"

A merchant might prefer:

# profiles/Merchant/layout.toml

[[windows]]
name = "main"
type = "text"
width = "100%"
height = "90%"

# No combat widgets, maximize text area

Highlight Differences

Warrior with creature highlights:

# profiles/Warrior/highlights.toml

[[highlights]]
name = "hunting_targets"
pattern = "(?i)\\b(goblin|orc|troll|giant)s?\\b"
fg = "#FF6600"
bold = true

Merchant with item highlights:

# profiles/Merchant/highlights.toml

[[highlights]]
name = "valuable_items"
pattern = "(?i)\\b(gold|silver|gem|diamond)s?\\b"
fg = "#FFD700"
bold = true

[[highlights]]
name = "materials"
pattern = "(?i)\\b(leather|silk|velvet|mithril)\\b"
fg = "#00FFFF"

Keybind Differences

Combat character:

# profiles/Warrior/keybinds.toml

[[keybinds]]
key = "F1"
action = "send"
argument = "attack"

[[keybinds]]
key = "F2"
action = "send"
argument = "feint"

Spellcaster:

# profiles/Wizard/keybinds.toml

[[keybinds]]
key = "F1"
action = "send"
argument = "incant 901"

[[keybinds]]
key = "F2"
action = "send"
argument = "incant 903"

Shared vs. Profile-Specific

Keep Global (Shared)

colors.toml - Usually same theme everywhere
config.toml - Connection settings shared

Make Profile-Specific

layout.toml - Different layouts per playstyle
highlights.toml - Different creatures/items/friends
keybinds.toml - Different combat macros

Profile Tips

1. Start Simple

Only create profile overrides for files you need to change. Let others fall back to global.

2. Use Consistent Names

Match your character name exactly (case-sensitive on some systems):

# Good
--character Nisugi
~/.two-face/profiles/Nisugi/

# May not work
--character nisugi
~/.two-face/profiles/Nisugi/  # Case mismatch!

For settings shared across some (but not all) characters, create a “base” profile and copy from it:

# Create a hunting base
cp -r ~/.two-face/profiles/Warrior ~/.two-face/profiles/hunting-base

# New hunting character
cp -r ~/.two-face/profiles/hunting-base ~/.two-face/profiles/NewHunter

4. Version Control

Consider version controlling your profiles:

cd ~/.two-face
git init
git add .
git commit -m "Initial Two-Face configuration"

Troubleshooting Profiles

Profile Not Loading

Check character name spelling (case-sensitive)
Verify directory exists: ls ~/.two-face/profiles/
Check file permissions
Look for errors in ~/.two-face/two-face.log

Wrong Settings Applied

Check which profile is loaded (shown on startup)
Verify the file exists in the profile directory
Check for syntax errors in the profile file

Resetting a Profile

# Remove profile to use global defaults
rm -rf ~/.two-face/profiles/CharName/

# Or reset specific file
rm ~/.two-face/profiles/CharName/layout.toml

Example: Multi-Character Setup

~/.two-face/
├── config.toml
├── layout.toml           # Balanced default layout
├── keybinds.toml         # Common keybinds
├── highlights.toml       # Common highlights
├── colors.toml           # Dark theme for all
│
└── profiles/
    ├── Ranger/
    │   ├── layout.toml   # Compact hunting layout
    │   ├── highlights.toml # Creature + foraging
    │   └── keybinds.toml # Ranged combat macros
    │
    ├── Empath/
    │   ├── layout.toml   # Group-focused layout
    │   └── highlights.toml # Wounds + group members
    │
    └── Bard/
        ├── layout.toml   # RP-friendly layout
        └── highlights.toml # Song + speech focus

Two-Face Documentation