Skip to content
Desktop app built in Electron for tracking your competitive match history in Overwatch.
JavaScript CSS Other
Branch: master
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Type Name Latest commit message Commit time
Failed to load latest commit information.
__mocks__ Fix failing HelpPage test Jul 9, 2019
dist/installers Fix path to package.json Sep 1, 2018
docs Bump nokogiri from 1.8.5 to 1.10.4 in /docs Sep 7, 2019
public Add season 13, bump version to 0.2.0 Nov 3, 2018
screenshots Update screenshots to show roles Aug 4, 2019
.travis.yml Include role field on export, import Sep 7, 2019
LICENSE.txt Add license Jul 14, 2018
Procfile Only run a single script to launch in dev Jul 4, 2018 Put commands together in readme Sep 1, 2019
package.json Bump react-scripts to 3.1.1 Sep 7, 2019
tsconfig.json Convert RoleImage to typescript Aug 17, 2019

Competiwatch Desktop

Build Status

Download the app - see what's new

This is a desktop app for Windows and macOS to track your competitive match history in Overwatch. I wanted to see my progress over time, more than what the game or sites like Overbuff provide. The app lets you see which heroes you're performing best on, which roles, whether you do better on weekday mornings or weekend evenings, whether joining voice chat helps your win rate, that sort of thing.

Screenshot of match history

Screenshot of log match form

Screenshot of trends page

Screenshot of settings page

Screenshot of accounts page

See the changelog for what has changed each version.


  • Track matches across different roles, accounts, and competitive seasons
  • Log details such as your new SR, which people you played with, whether you were in a 6-stack or solo queuing, what time you played, whether you got Play of the Game, which heroes you played, and what map you played
  • Export your match history as a CSV file (Comma-Separated Value)
  • Import your match history for past seasons
  • View charts summarizing your season
  • Log your placement matches and regular season games
  • See when you go on win streaks or loss streaks
  • Choose between a dark and light theme, or automatic based on time of day
  • Works in Windows and macOS

How to Install

For version 1.9 and later, download the Windows installer from the latest release. I've tested this on Windows 7 and Windows 10. Just run the installer and a Competiwatch shortcut will be added to your desktop.

You can also download the non-installer version and unzip the folder wherever you'd like. Run the app via the Competiwatch.exe executable in that folder.

You will probably be prompted by Windows that the app is unrecognized; the message in Windows 10 reads "Windows SmartScreen prevented an unrecognized app from starting." Sorry about that, it's being worked on. You can choose to run the app anyway (hit "more info" in Windows 10) and it shouldn't prompt you again for that version.

How to Uninstall

If you installed via the installer in Windows, just use the Control Panel and Add/Remove Programs to uninstall Competiwatch. The shortcut should be removed from your desktop.

If you did not use the installer, you can just delete the folder that has Competiwatch.exe in it, wherever you unzipped that folder.

How to Develop

This app was built with node version 8.11.3 and yarn 1.15.2 (npm will also work, if you'd prefer, I used npm version 6.8.0). See the contributing guidelines.

yarn install
yarn run dev

The app should launch and also open in your browser. You can close the browser tab.

Log Files

While you run the app, Electron logs will end up in the following places:

  • on macOS: ~/Library/Logs/Competiwatch/log.log
  • on Windows: %USERPROFILE%\AppData\Roaming\Competiwatch\log.log
  • on Linux: ~/.config/Competiwatch/log.log

React logs will show in your terminal. You can run tail -f ~/Library/Logs/Competiwatch/log.log in macOS in a separate terminal from yarn run dev to monitor Electron logs while the app is running.

How to Run Tests

yarn install
yarn test

To see test coverage, run yarn test -- --coverage. A coverage report will display in your terminal or you can open coverage/lcov-report/index.html in your browser.

How to Build Executables

For macOS, from a Mac run:

# produce a new directory in dist/ that has a distributable .app file:
yarn run electron-build-macos

For Windows, from a Windows machine run:

# produce new directories in dist/ with .exe files:
yarn run electron-build-windows

# generate an installer in dist/installers/:
yarn run electron-build-windows-installer
You can’t perform that action at this time.