config.toml Reference

The main configuration file controlling Two-Face’s behavior, connection settings, and general preferences.

Location

~/.two-face/config.toml

Complete Reference

#
# Two-Face Configuration
#

[connection]
# Default host for Lich proxy mode
host = "127.0.0.1"

# Default port for Lich proxy mode
port = 8000

# Default character name (used for profile loading)
character = ""

# Timeout for connection attempts (seconds)
timeout = 30

[interface]
# Enable clickable links in game text
links = true

# Show window borders by default
show_borders = true

# Default border style: "plain", "rounded", "double", "thick"
border_style = "rounded"

# Mouse support
mouse = true

# Scroll speed (lines per scroll event)
scroll_speed = 3

# Command history size
history_size = 1000

[sound]
# Enable sound effects
enabled = true

# Master volume (0.0 - 1.0)
volume = 0.8

# Play startup music
startup_music = true

# Sound file paths (relative to data dir or absolute)
# alert_sound = "sounds/alert.wav"

[tts]
# Enable text-to-speech
enabled = false

# TTS rate (words per minute, platform dependent)
rate = 150

# Which streams to speak
streams = ["main"]

# Speak room descriptions
speak_rooms = true

# Speak player speech
speak_speech = true

[logging]
# Log level: "error", "warn", "info", "debug", "trace"
level = "warn"

# Log file path (relative to data dir)
file = "two-face.log"

# Log to console (for debugging)
console = false

[behavior]
# Auto-scroll to bottom on new text
auto_scroll = true

# Flash window on important events
flash_on_alert = false

# Notification sound on important events
sound_on_alert = false

# Pause input during roundtime (experimental)
pause_on_rt = false

[performance]
# Maximum lines to buffer per text window
max_buffer_lines = 2000

# Frame rate target
target_fps = 60

# Enable performance metrics collection
collect_metrics = true

Section Details

[connection]

Controls how Two-Face connects to the game.

Note: Direct mode (--direct) ignores these settings and uses command-line credentials.

[interface]

Visual and interaction settings.

Border styles:

• "plain" - Single line: ─│─│┌┐└┘
• "rounded" - Rounded corners: ─│─│╭╮╰╯
• "double" - Double line: ═║═║╔╗╚╝
• "thick" - Thick line: ━┃━┃┏┓┗┛

[sound]

Audio settings.

Note: Requires the sound feature to be compiled in.

[tts]

Text-to-speech accessibility features.

Supported streams: "main", "speech", "thoughts", "combat"

[logging]

Diagnostic logging configuration.

Log levels (from least to most verbose):

• "error" - Only errors
• "warn" - Errors and warnings
• "info" - Normal operation info
• "debug" - Debugging details
• "trace" - Very verbose tracing

[behavior]

Client behavior tweaks.

[performance]

Performance tuning.

Examples

Minimal Config

[connection]
port = 8000
character = "MyCharacter"

High-Performance Config

[performance]
max_buffer_lines = 1000
target_fps = 120
collect_metrics = false

[interface]
links = false  # Disable link parsing for speed

Accessibility Config

[tts]
enabled = true
rate = 175
streams = ["main", "speech"]
speak_rooms = true
speak_speech = true

[interface]
scroll_speed = 5

Environment Variable Overrides

Some settings can be overridden via environment variables:

See Also

• layout.toml - Window layout configuration
• Character Profiles - Per-character settings
• Environment Variables - All environment variables