Installation

This guide covers installing Two-Face on all supported platforms.

Quick Install

Pre-built Binaries

Download the latest release for your platform from GitHub Releases:

Extract and Run

Windows:

# Extract to a folder
Expand-Archive two-face-windows-x64.zip -DestinationPath C:\two-face

# Run
C:\two-face\two-face.exe

Linux/macOS:

# Extract
tar xzf two-face-linux-x64.tar.gz

# Make executable
chmod +x two-face

# Run
./two-face

Building from Source

For the latest features or unsupported platforms, build from source.

Prerequisites

1. Rust Toolchain (1.70+)

   curl --proto '=https' --tlsv1.2 -sSf https://sh.rustup.rs | sh
   

2. Platform-Specific Dependencies

   Windows:

   • Visual Studio Build Tools
   • vcpkg with OpenSSL:

     git clone https://github.com/microsoft/vcpkg.git C:\vcpkg
     cd C:\vcpkg
     .\bootstrap-vcpkg.bat
     .\vcpkg install openssl:x64-windows
     $env:VCPKG_ROOT = "C:\vcpkg"
     

   Linux (Debian/Ubuntu):

   sudo apt install build-essential pkg-config libssl-dev libasound2-dev
   

   Linux (Fedora/RHEL):

   sudo dnf install gcc pkg-config openssl-devel alsa-lib-devel
   

   macOS:

   xcode-select --install
   # OpenSSL usually provided by system
   

Build Steps

# Clone repository
git clone https://github.com/nisugi/two-face.git
cd two-face

# Build release version
cargo build --release

# Binary is at target/release/two-face

Build Options

# Build without sound support (smaller binary)
cargo build --release --no-default-features

# Build with all features
cargo build --release --features sound

Data Directory

Two-Face stores configuration in a data directory:

Structure

~/.two-face/
├── config.toml          # Main configuration
├── layout.toml          # Window layout
├── keybinds.toml        # Key bindings
├── highlights.toml      # Text highlighting
├── colors.toml          # Color theme
├── simu.pem             # eAccess certificate (auto-downloaded)
├── two-face.log         # Debug log
└── profiles/            # Per-character profiles
    └── CharName/
        ├── layout.toml
        └── highlights.toml

Custom Data Directory

Override the default location:

# Via command line
two-face --data-dir /path/to/custom/dir

# Via environment variable
export TWO_FACE_DIR=/path/to/custom/dir
two-face

Verifying Installation

1. Check version:

   two-face --version
   

2. View help:

   two-face --help
   

3. Test terminal colors: Launch Two-Face and check if colors display correctly. If colors look wrong:

   # Set truecolor support
   export COLORTERM=truecolor
   two-face
   

Troubleshooting Installation

Windows: “vcruntime140.dll not found”

Install the Visual C++ Redistributable.

Windows: OpenSSL errors

Ensure VCPKG_ROOT is set and OpenSSL is installed via vcpkg.

Linux: “libasound.so not found”

Install ALSA library:

# Debian/Ubuntu
sudo apt install libasound2

# Fedora
sudo dnf install alsa-lib

macOS: “cannot be opened because the developer cannot be verified”

Right-click the binary, select “Open”, then click “Open” in the dialog.

All Platforms: Colors not working

1. Use a modern terminal (Windows Terminal, iTerm2, etc.)
2. Set COLORTERM=truecolor environment variable
3. Ensure your terminal supports 24-bit color

Next Steps

With Two-Face installed, continue to First Launch to connect to the game.

See Also

• Building from Source - Detailed build guide for developers
• Configuration Reference - Config file documentation
• Troubleshooting - Common issues and solutions