Companion troubleshooting

The code was cut off or has extra characters. A token starts with hsa_. Copy the whole thing again, with no quotes and no spaces before or after.

The BattleTag in Settings must match yours exactly, including the # and the number. The lobby is read from the game as it loads, so wait until the loading screen. Games against AI aren't supported, because the game doesn't record the bots as players.

Open Settings and confirm a token is saved. Then check the account page: each token shows when it was last used, and a revoked token stops working immediately. If in doubt, create a new token and paste it in. Votes are matched to the game once its replay uploads.

Check you aren't in true Fullscreen: in game, choose Options, Video, Display Mode, then Windowed or Windowed (Fullscreen). Press your hotkey (F9 by default) in case it's hidden, and look for the tray icon near the clock (click the little arrow for hidden icons). If Demo mode is on, the panel shows sample players instead of your game; turn it off from the banner or the tray menu. If you use Hover mode, the panel is a small faded tab that can sit under another window's buttons; press and drag it somewhere clearer.

Replays upload after a game ends, and need a saved token. Very long or very old replays can take a while. You can always upload a replay by hand from the upload page.

Right-click the tray icon, choose About and check for updates. The panel also shows a badge when a new version is out. You can also download the latest installer and run it over your current copy, or see all versions.

Demo mode is on. In demo mode the Companion shows sample players and ignores your real games. Turn it off from the orange banner on the panel, from the tray menu (Demo mode). The Companion restarts and goes back to reading your games. In version 0.5.18 and later, demo mode also switches itself off whenever the Companion restarts; if yours keeps showing sample players, update it from the tray menu (About).