Skip to content

Get your matches on Deadlock trackers

Install the background tool

  1. Download the installer.

    Download for WindowsIf Windows says it protected your PC, click More info, then Run anyway.
  2. Open it. It installs for your account only, so no admin rights are needed, and starts by itself every time you sign in.

  3. A small window opens and shows every match you send. You can close it, the tool keeps running.

  4. Play Deadlock. Your matches are sent while you play.

  5. To also send your past matches, close Deadlock and run this once in PowerShell.

    & "$env:LOCALAPPDATA\deadlock-api-ingest\deadlock-api-ingest.exe" --own-matches
Install with PowerShell instead
  1. Open PowerShell as administrator: right-click Start, then Terminal (Admin) or Windows PowerShell (Admin).

  2. Paste the installer and press Enter.

    irm https://raw.githubusercontent.com/deadlock-api/deadlock-api-ingest/master/install-windows.ps1 | iex
  3. Press Y when it asks about auto-start, or wait 10 seconds.

Uninstall

Installed with the installer: remove Deadlock API Ingest under Settings, Apps, Installed apps. Installed with PowerShell: run this.

& "$env:LOCALAPPDATA\deadlock-api-ingest\uninstall-windows.ps1"
  1. Paste the installer into a terminal. It installs into your home folder and starts on login, no sudo needed.

    curl -fsSL https://raw.githubusercontent.com/deadlock-api/deadlock-api-ingest/master/install-linux.sh | bash
  2. Play Deadlock. Your matches are sent while you play.

  3. To see the matches you have sent, run deadlock-api-ingest --gui.

  4. To also send your past matches, close Deadlock and run this once in a terminal.

    deadlock-api-ingest --own-matches
Uninstall
~/.local/share/deadlock-api-ingest/uninstall-linux.sh
  1. Start the container. If Steam lives somewhere else, change the folder before the :.

    docker run -d --restart unless-stopped --name deadlock-api-ingest \
      -v ~/.steam/steam:/root/.steam/steam:ro \
      ghcr.io/deadlock-api/deadlock-api-ingest:latest
  2. Play Deadlock. Your matches are sent while you play.

  3. To also send your past matches, close Deadlock and run this once in a terminal.

    docker exec deadlock-api-ingest deadlock-api-ingest --own-matches
Uninstall
docker rm -f deadlock-api-ingest

Why install it

  • Every match you play, on every tracker

    It sends each match as soon as Deadlock loads it, and everything already in your Steam cache.

  • Your whole match history, not just new games

    Run the last install step once, with Deadlock closed, and it also sends your past matches that are still missing.

  • Finds matches nobody has yet

    While Deadlock is closed, it uses your Steam session to fetch up to 40 missing matches a day: new matches of your Steam friends first, then matches nobody has sent yet.

  • Unlocks your player tracker

    Every account it sent matches for in the last 14 days gets its player tracker for free once we have checked one of those matches, no sign-in needed.

  • Set up once

    It starts with your PC and stays out of the way. Nothing to click after the install.

  • Open source and private

    It sends match IDs and your public Steam ID, nothing else. Your Steam login is never sent to us.

Background tool or one-time upload

FeatureBackground toolCache upload
Sends the matches already in your Steam cacheIncludedIncluded
Sends every new match by itselfIncludedNot included
Finds matches still missing for everyoneIncludedNot included
Unlocks your player trackerIncludedNot included
Runs in the browser, nothing to installNot includedIncluded

Upload your Steam cache once

  1. Find the httpcache folder inside your Steam install.

    C:\Program Files (x86)\Steam\appcache\httpcache
    ~/Library/Application Support/Steam/appcache/httpcache
    ~/.local/share/Steam/appcache/httpcache
    ~/.steam/steam/appcache/httpcache
    ~/.var/app/com.valvesoftware.Steam/.local/share/Steam/appcache/httpcache
    Flatpak, Snap and other installs
    ~/.var/app/com.valvesoftware.Steam/.steam/steam/appcache/httpcache
    ~/.var/app/com.valvesoftware.Steam/.steam/root/appcache/httpcache
    ~/.steam/root/appcache/httpcache
    ~/.steam/debian-installation/appcache/httpcache
    ~/snap/steam/common/.local/share/Steam/appcache/httpcache
    ~/snap/steam/common/.steam/steam/appcache/httpcache
    ~/snap/steam/common/.steam/root/appcache/httpcache
  2. Drop the folder here, or choose it. Your browser reads it, only match IDs are sent.

    Drop the httpcache folder here

Questions

Why are my Deadlock matches missing on Statlocker, Tracklock or other trackers?

Valve does not publish a list of every match. To load a match's stats and replay, a tracker needs its match ID and a salt, a key that Deadlock downloads through Steam when it shows you the match. Deadlock API finds many matches by itself, but not all of them, and a match it has not found is missing on every tracker built on its data until someone sends that match ID and salt.

How do I get my matches on tracker sites?

Install the background tool on this page. It sends every match you play to Deadlock API, which passes it on to Statlocker, Tracklock, Lockblaze and the other sites that use its data. To send the matches already on your PC once, without installing anything, upload your Steam cache folder instead.

What is the difference between the background tool and the cache upload?

The background tool runs on your PC all the time. It sends the matches already in your Steam cache when it starts, then each new match as Deadlock downloads or loads it. While the game is closed, it asks Steam for up to 40 missing matches a day for each Steam account saved on your PC: new matches of your Steam friends who play Deadlock first, then matches still missing for everyone. The cache upload runs once in your browser and sends what is in your cache right now, so new matches need another upload. It needs no install and works on macOS, where the tool only runs in Docker.

Where is Steam's httpcache folder?

It is the httpcache folder inside Steam's appcache folder. On Windows that is C:\Program Files (x86)\Steam\appcache\httpcache, on macOS ~/Library/Application Support/Steam/appcache/httpcache, and on Linux usually ~/.local/share/Steam/appcache/httpcache or ~/.steam/steam/appcache/httpcache.

What does it send, and is it safe?

The cache upload sends only match IDs and their salts, taken from the addresses of the match files in Steam's cache. The background tool sends the same plus your Steam account ID, a public number that already appears in every match you play. To find your friends' new matches, it also sends the account IDs of your Steam friends. While Deadlock runs, it reads match salts from the game's memory, read-only. It asks Steam for missing matches with the saved sessions of the Steam accounts on your PC and never sends those sessions to Deadlock API. Nothing else about your account, your PC or your other games is sent. The tool is open source on GitHub, and its README lists the switches that turn off the Steam requests and the memory reading.

Do I get the player tracker for running the tool?

Yes. Every Steam account the background tool sent matches for in the last 14 days gets its player tracker on deadlock-api.com for free: full match history, rank progression, hero stats, and the teammates and opponents you play with most. There is nothing to sign in to: open your profile on the tracker page once we have checked one of the matches the tool sent. A match counts for whoever sent it first, so matches someone else already sent do not unlock it. The one-time cache upload does not unlock it, because it does not send your Steam account ID.

Does it work on macOS?

The cache upload does: choose ~/Library/Application Support/Steam/appcache/httpcache and the matches are sent. Finder hides the Library folder, so press Cmd+Shift+G in the file dialog and paste the path. The background tool runs on Windows and Linux, and on macOS in Docker. In the Docker command, mount "$HOME/Library/Application Support/Steam" instead of ~/.steam/steam, keeping the quotes because the path has a space.