Show player and team stats of a currently played, replayed or last played Company of Heroes 2 match.

Example output on Windows Terminal with gruvbox colors and Inconsolata font.

You can either run CoH2 Live Stats as a standalone bundled application or install and run it with Python.

1. Download latest release of CoH2LiveStats-bundle-[version].zip
2. Unzip and run CoH2LiveStats.exe

1. Run pip install coh2-live-stats
2. Run python -m coh2_live_stats or simply coh2livestats

1. Get source code
   • Download source files and unzip
   • or download and install Git and run git clone https://github.com/brofi/coh2-live-stats.git
2. Download and install Python >= 3.12
3. Run pip install . from project root
4. Run python -m coh2_live_stats or simply coh2livestats

• Microsoft Windows
• (Optional) Windows Terminal for proper UTF-8 support
• or Linux

CoH2 Live Stats is configured via a TOML configuration file. A default configuration file named _coh2livestats.toml is supplied with the bundled application. A configuration file can be put in the user's home directory (%USERPROFILE%) or left next to the application's executable.
A configuration file can have one of the following names:

• _coh2livestats.toml
• .coh2livestats.toml
• coh2livestats.toml
• _coh2_live_stats.toml
• .coh2_live_stats.toml
• coh2_live_stats.toml

The first valid configuration file detected in the above order is used. The following sections describe all available configuration attributes grouped by TOML table. All attributes ungrouped are found here. More information on TOML syntax is found here.

• Add full border and remove the average row
• Remove column drop_ratio and num_games
• Add column streak and prestige
• Move column prestige to the front
• Move column faction in front of column name
• Unify faction colors

[table]
border = 'full'
show_average = false

[table.columns.drop_ratio]
visible = false

[table.columns.num_games]
visible = false

[table.columns.streak]
visible = true

[table.columns.prestige]
visible = true
pos = -1

[table.columns.faction]
pos = 1

[table.columns.name]
pos = 2

[table.colors.faction]
okw = "red"
su = "blue"
uk = "blue"

A minimalistic output configuration

[table]
color = false
header = false
border = 'none'
show_average = false

[table.columns]
rank.visible = false
win_ratio.visible = false
drop_ratio.visible = false
num_games.visible = false
country.visible = false
team_rank.visible = false

• Create virtual environment: python -m venv venv

• Activate virtual environment:

  • Bash: . venv/bin/activate
  • PowerShell: venv\Scripts\Activate.ps1
  • cmd.exe: venv\Scripts\activate.bat

• Install project with development dependencies in editable mode:

$ pip install invoke
$ inv install --dev

• Install pre-commit hooks:

$ pre-commit install

• Install missing stub packages:

$ mypy --install-types --non-interactive src tests scripts tasks.py

• Build with setuptools and build and create a PyInstaller bundle:

$ inv build

• Distribution bundle: .\dist_bundle\CoH2LiveStats-bundle-{version}.zip
• See inv -l and inv [task] -h for more information on available invoke tasks

logfile = "%USERPROFILE%\\Documents\\My Games\\Company of Heroes 2\\warnings.log"

[notification]
play_sound = true
sound = "horn"

[table]
color = true
border = "inner"
header = true
show_average = true
always_show_team = false
drop_ratio_high_threshold = 0.05
win_ratio_high_threshold = 0.6
win_ratio_low_threshold = 0.5
prestige_star_char = "*"
prestige_half_star_char = "~"

[table.colors]
border = "BRIGHT_BLACK"
label = "BRIGHT_BLACK"

[table.colors.player]
high_drop_rate = "RED"
high = "BRIGHT_WHITE"
low = "BRIGHT_BLACK"
win_streak = "GREEN"
loss_streak = "RED"

[table.colors.faction]
wm = "RED"
su = "RED"
okw = "CYAN"
us = "BLUE"
uk = "YELLOW"

[table.columns]
[table.columns.faction]
label = "Fac"
visible = true
align = "l"
pos = 0

[table.columns.rank]
label = "Rank"
visible = true
align = "r"
pos = 0

[table.columns.level]
label = "Lvl"
visible = true
align = "r"
pos = 0

[table.columns.prestige]
label = "XP"
visible = false
align = "l"
pos = 0

[table.columns.streak]
label = "+/-"
visible = false
align = "l"
pos = 0

[table.columns.wins]
label = "W"
visible = false
align = "l"
pos = 0

[table.columns.losses]
label = "L"
visible = false
align = "l"
pos = 0

[table.columns.win_ratio]
label = "W%"
visible = true
align = "r"
pos = 0

[table.columns.drop_ratio]
label = "Drop%"
visible = true
align = "r"
pos = 0

[table.columns.num_games]
label = "Total"
visible = true
align = "l"
pos = 0

[table.columns.team]
label = "Team"
visible = true
align = "c"
pos = 0

[table.columns.team_rank]
label = "T_Rank"
visible = true
align = "r"
pos = 0

[table.columns.team_level]
label = "T_Lvl"
visible = true
align = "r"
pos = 0

[table.columns.steam_profile]
label = "Profile"
visible = false
align = "l"
pos = 0

[table.columns.country]
label = "Country"
visible = true
align = "l"
pos = 0

[table.columns.name]
label = "Name"
visible = true
align = "l"
pos = 0