Companion setup guide

Everything you need to get the Companion running: install it, create a token and fill in the settings. Haven't got it yet? Download the Companion.

Set it up in four steps

  1. Install it. Run the downloaded file.
  2. Connect it to your account. In the settings window that opens on first launch, click Connect to your account. Your browser opens; sign in with Battle.net if asked, check the code matches the one in the Companion and click Connect this Companion. The Companion fills in your token and BattleTag and saves them.
  3. Check the other settings if you like (details below).
  4. Play. When a game starts the panel shows your teammates. Press F9 to show or hide it.

Or create a token by hand

Connect is the easy way. If it doesn't work for you, you can make a token on this site and paste it into the companion instead. A token is how the companion proves it's you without you typing your Battle.net password into it.

  1. Open your account page (signed-in menu, top right, then Account and companion). If you aren't signed in yet, sign in with Battle.net first.
  2. Scroll to Desktop companion. In the box that says Label, type any name that helps you remember where it's used, such as Gaming PC. This is only a nickname for you, not the token.
  3. Click Create token. A green box appears with a code that starts with hsa_ followed by letters and numbers.
  4. Copy the whole code now (click it to select it, then Ctrl+C). It is shown only once. If you lose it, just make a new token and revoke the old one on the same page.

Keep your token private. Anyone who has it can upload replays and send votes as you. You can revoke a token on the account page at any time and it stops working immediately.

What to put in the settings window

  • Your BattleTag: exactly as it appears in Battle.net, with the # and the numbers, like Name#1234. Connect fills this in for you. The companion uses it to know which player is you in the lobby.
  • Upload token: filled in by Connect. If you made one by hand, paste the whole code, starting with hsa_, with no quotes and no spaces before or after it. The box shows dots, which is normal. If you leave it blank the companion still works but your votes stay on your PC and replays aren't uploaded.
  • Site: leave it as https://hotsanalyzer.com.
  • Show / hide hotkey: click the box, then press the key you want (F9 by default).

Click Save and restart. If it says "That doesn't look like a token", the code was cut off or doesn't start with hsa_: copy it again.

Before your first game

  • Play in Windowed or Windowed (Fullscreen) mode (in game: Options, Video, Display Mode). In true Fullscreen Windows draws the game over the companion and you won't see it.
  • The companion lives in the system tray, near the clock. Click the little arrow to see hidden icons. Right-click it for Settings, About and "Start with Windows".
  • Want to try it first? Right-click the Companion tray icon (near the clock) and tick Demo mode to see the panel with sample players. A banner reminds you it's on and has a button to turn it off.
  • Hover mode (tray menu: Small logo tab) keeps the panel as a small faded logo tab that drops down when you hover it, so it stays out of the way of the game's screen scrolling. Press and drag the tab to put it wherever suits you; it remembers the spot. If the tab is near the bottom of the screen, the panel opens upward so you can see all of it.

Using it in a game

  • Teammates appear as soon as the game loads, and heroes fill in about a minute in. Tap the thumbs and the strength or weakness tags that fit each player.
  • Flip the Enemy team switch at the top to rate opponents too.
  • Your votes are sent to the site automatically, and after the game your replay uploads and is matched up with them.
  • Games against AI aren't supported, because the game doesn't record the bots as players.

Troubleshooting

Something not working? See the Companion troubleshooting page.