Bring in your matches
Three ways to get your Premier, Competitive, Wingman and FACEIT matches into Grindhouse, what each one gives you, and what every sync message means.
Grindhouse finds your matches through the Steam account you linked (see Account & Steam). There are three ways in. Most players save their match-sharing codes once and upload a demo now and then.
The three ways in
| Way | Matches | What you get | When it runs | What you do |
|---|---|---|---|---|
| Match-sharing codes | Premier, Competitive, Wingman | Full breakdown and 2D replay while Valve still has the demo. Scoreboard only after that. | In the background on Grindhouse's servers, even with your browser closed | Paste two codes once |
| Demo upload | Any CS2 demo you played in: matchmaking, FACEIT, scrims | Full breakdown and 2D replay | When you upload a file | Pick the file each time |
| FACEIT link | FACEIT | Scoreboard only, plus your FACEIT level and Elo | In the background on Grindhouse's servers | Link your account once |
Full breakdown or scoreboard only
Every match lands in one of two states. A match that came in with its demo gets everything. A match without one keeps the final scoreboard and carries a Scoreboard only tag in the list; hover the tag to see why.
| On the match page | Full breakdown | Scoreboard only |
|---|---|---|
| Final score, K / D / A, headshot %, MVPs | Yes | Yes |
| ADR, multi-kills, opening duels, clutches, utility damage, enemies flashed | Yes | FACEIT matches only |
| Rating and KAST | Yes | No |
| Aim stats: accuracy, spotted accuracy, spray accuracy, counter-strafe, time to damage, time to kill, crosshair placement | Yes | No |
| Rounds strip, kill feed, economy per round | Yes | No |
| How you played: findings, drills, every stat vs your rank | Every stat | Only the stats the scoreboard has |
| 2D replay | Yes | No |
Heads up: Valve deletes match demos after about a month
A Valve match that reaches Grindhouse later than that comes in as scoreboard only: the demo is gone, so only the scoreboard Valve still lists can be saved. Keep background sync on, or upload a demo while you still have it.
A full match never goes back to scoreboard only. A scoreboard-only match becomes a full one when its demo arrives later: upload the same match's demo (see where to find demos) and the existing match is upgraded, not duplicated.
Match-sharing codes
Valve gives every player two codes that let an app read their CS2 match history: an authentication code, and the code of a recent match. Save them once and Grindhouse fetches each new Premier, Competitive and Wingman match for you, downloads the demo and reads it. This runs on Grindhouse's servers, so it keeps going with your browser closed, and it catches matches you play on any PC.
Set it up
Open Match history
Go to Settings → Match history and press Set up on the Background sync row. Set up background sync in the Matches page's sync status menu and the Import your matches step of the Finish setting up row on Home take you there with the steps open.
Open Steam's page
Press Open Steam's page. It opens Valve's official match history page, help.steampowered.com/en/wizard/HelpWithGameIssue/?appid=730&issueid=128. Sign in to Steam there if it asks, with the Steam account you linked to Grindhouse.
Copy your two codes
Under Access to Your Match History, click Create Authentication Code. You need that code and the code next to Your most recently completed match token. Easiest: select that whole section of Steam's page and copy it once.
Paste them into Grindhouse
Press Paste from clipboard. Grindhouse finds both codes in whatever you copied and fills in the fields (your browser may ask first). Or paste each code into its field. A field shows Looks right once its format matches.
Save
Press Save and start syncing. Grindhouse checks the pair with Steam, saves it and asks for the first background sync straight away, so it runs shortly. You see "Match codes saved", and the status reads Waiting for first sync (in Settings and in the Matches page's sources menu), then Syncing.
Note: Sync starts at the code you paste
Steam hands out match codes in order, after a code you already have. The first sync after you save brings in the match whose code you pasted, then every match you finish from then on. Older matches can't be reached this way: upload their demos if you want them. Paste the code of your most recent match. Steam stops accepting codes older than about 30 days.
Messages when you save
| Message | What it means |
|---|---|
| Paste your authentication code Paste your latest match code | That field is empty. |
| Format: AAAA-AAAAA-AAAA | The authentication code isn't three groups of 4, 5 and 4 letters or digits. |
| Starts with CSGO- and has five groups of 5 | The match code isn't in Valve's format. Copy it again from Steam's page. |
| Steam didn't accept that authentication code. Create a new one on Steam's page. | Steam says the code isn't valid for your Steam account. Check that Steam's page is signed in with the account linked to Grindhouse, create a new code and paste it. |
| That match code isn't valid. Copy your most recent one from Steam's page. | The match code can't be read. |
| Steam doesn't recognise this share code for your account (codes older than about 30 days stop working). Use the code of your most recent match. | The match code is too old, or belongs to someone else. Copy the one next to Your most recently completed match token. |
| Connect your Steam account first. | Link Steam under Settings → Connections. |
| Grindhouse didn't answer. Try again. | No answer within 20 seconds. |
Paste from clipboard tells you what it found: "Found both codes. Check them and press Save.", "Found your match code. Still need the authentication code.", "Found your authentication code. Still need the match code." or "No codes on the clipboard. Copy them from Steam's page first."
Status

In Settings, Match history leads with the Background sync row: a status badge, Last synced once a check has run, and a line on what it means. On the Matches page the same status is in the sync status menu at the top right; a status that needs you (a code to fix, an error, waiting for the server) also shows next to it, and clicking it opens Settings.
| Settings | Matches page | What it means | What to do |
|---|---|---|---|
| Off | Match sharing off | No codes saved. | Add them, or upload demos. |
| Waiting for first sync | Match sharing: waiting for first sync | Codes saved. The first background sync runs shortly and brings in the match whose code you pasted. | Nothing. |
| Syncing | Match sharing on | Background sync is on and working. | Nothing. |
| Needs a newer match code | Match sharing needs a newer code | Steam no longer accepts the saved match code. | Press Update codes and paste the code of your most recent match. |
| Authentication code rejected | Match sharing code rejected | Steam rejected the authentication code. | Create a new one on Steam's page and save it with Update codes. |
| Waiting for the server | Match sharing: waiting for the server | Your codes are saved, but background sync isn't switched on on Grindhouse's side yet. The text says why. | Nothing. New matches import once it's on; upload demos meanwhile. |
| Sync error | Match sharing error | Your saved codes can't be used: "Your saved authentication code can't be read any more. Save it again." When Steam or Grindhouse's Steam connection is down for a while, you see no error: your codes are kept and new matches come in on a later sync. | Save your codes again. |
How often it syncs
- Grindhouse checks everyone's codes for new matches every 30 minutes.
- Saving your codes starts a check for you right away. So does Get recent matches on the Matches page.
- The first check after you save brings in the match of the code you pasted, the same way as the ones after it. If Steam rejects the codes, it waits until you've fixed them.
- For each new match, Grindhouse downloads the demo from Valve and reads it: full breakdown and 2D replay. If Valve no longer has the demo, or the demo can't be read, it saves the scoreboard instead.
- A demo that fails to download for another reason is tried again on the next check. After three failed tries the match comes in as scoreboard only, so one broken demo can't hold up the rest. While Valve still has that demo, Grindhouse tries it again later in the background, and the match becomes a full one when it works.
- When many matches are waiting, they come in 20 at a time, one batch right after the other.
Change or remove your codes
Once saved, a Match codes row shows the latest match code Grindhouse has reached, partly hidden, which moves forward as matches come in, and Authentication code saved (the code itself is never shown again). Replace opens the steps again (it says Update codes when Steam needs new ones); Esc or Cancel closes them. Remove codes, in the ⋯ menu next to it, asks first: background sync stops, the matches already imported stay, and you can still upload demos.
Upload a demo
Uploads work for any CS2 demo you played in: a matchmaking demo, a FACEIT demo from the match room, a scrim, a league game. Each one gives the full breakdown and a 2D replay.
Press Import demo file
It's at the top right of the Matches page. It's also on the No matches yet page, on a FACEIT match that only has its scoreboard and on a match whose demo couldn't be read.
Pick one or more demos
.dem, or a compressed.dem.gz,.dem.bz2or.dem.zst, up to 1 GB each. Pick several at once and they upload one after the other.Wait for the upload, then the read
The sync status at the top of the Matches page shows "Uploading match730_….dem… 42%", then "Reading match730_….dem…", and a row at the top of the list shows the progress. Reading a big demo, or one waiting behind others, takes a minute or two. Keep the tab open while it uploads: leaving asks first, and an upload you leave is cancelled.
The match opens
With one demo, its match page opens by itself as soon as it's ready, if you're still on Matches, a match or Home. With several, they appear in the list with a New tag.

A demo is matched to you by your Steam account, so you can only import matches you played in. Uploading the same file twice updates the same match.
Where to find demos
- Matchmaking
- In CS2, Watch → Your matches downloads a recent match's demo. CS2 saves it in
game\csgo\replaysinside your CS2 folder, namedmatch730_….dem. Keep that name: Grindhouse reads the match from it, so the upload lands on the same match background sync knows and upgrades a scoreboard-only one. - FACEIT
- Download the demo in the FACEIT match room and upload the file as it is. FACEIT's file name (it starts with
1-followed by the match id) tells Grindhouse which FACEIT match it is, so it upgrades the scoreboard your FACEIT link brought in. A browser's " (1)" at the end of the name is fine. - Anything else
- Scrims, league games, a demo a friend sent: they show up with the source Uploaded demo.
On a Valve match, the match page's Share code button copies its share code. Paste it in CS2 under Watch → Your matches to download that match's demo.
Upload messages
| Message | What to do |
|---|---|
| Imported 1 demo. / Imported 3 demos. | Done. "1 of 3 couldn't be imported: …" adds the reason for the ones that failed. |
| Pick a CS2 demo: a .dem file (.dem.gz, .dem.bz2 and .dem.zst work too). | None of the files you picked is a demo. |
| That demo is over 1 GB, too big to upload. | Compress it (.dem.zst, .dem.bz2 or .dem.gz) and upload that. |
| 1 file was skipped (not a .dem file, or over 1 GB). | The other files went up; that one didn't. |
| A demo is still uploading. Pick the next one when it's done. | Wait for the current upload. This also blocks Get recent matches until it's done. |
| Connect your Steam account first: a demo is matched to you by your Steam account. | Link Steam under Settings → Connections. |
| This file isn't a CS2 demo. Pick a .dem file (or a .dem.bz2, .dem.zst or .dem.gz). | The file has a demo's name but isn't one. |
| This is a CS:GO demo. Only CS2 demos can be imported. | CS:GO demos can't be read. |
| The file couldn't be unpacked. Check that the download finished, then upload it again. | The compressed file is cut off or damaged. Download it again. |
| This demo couldn't be read. It may be damaged, or from a CS2 version Grindhouse can't read yet. | Try another copy of the demo. |
| The demo has no completed rounds. | The demo ends before a round finished. |
| You're not in this match. Only matches you played in can be imported. | Your linked Steam account isn't one of the players. |
| This match is already stored, and you're not in it. | Same rule: someone who played it already imported it. |
| You already have 2 demos uploading. Wait for them to finish. | Another tab is uploading. Wait, then try again. |
| Demo uploads are paused for a moment. Try again a bit later. | Uploads are switched off for a while on Grindhouse's side. |
| The upload stopped for over an hour and expired. Upload the demo again. | Start over. |
| The upload was interrupted. Check your connection and try again. | The connection dropped. Each piece is retried a few times before this shows. |
| Your session has ended. Sign in again, then upload the demo. | Sign in again. |
| The Grindhouse server couldn't take the demo right now. Try again in a minute. | Try again in a minute. |
| Reading the demo is taking very long. It shows up in Matches once it's done. | Nothing: the page stopped waiting after 20 minutes, the read goes on. |
FACEIT
Link your FACEIT account and your FACEIT level and Elo show on your profile, and your FACEIT matches come in on their own.
Open Connections
Go to Settings → Connections. The FACEIT row says Not linked: "Adds your level and your FACEIT matches."
Press Link FACEIT
Depending on how Grindhouse's server is set up, it does one of two things. It takes you to FACEIT's own sign-in and back. Or it opens a box: type your FACEIT nickname and press Link FACEIT. Grindhouse checks that this FACEIT account plays CS2 on your Steam account.
Done
The row shows your nickname, level, Elo and country, with Profile and a ⋯ menu with Unlink FACEIT. Linking starts a FACEIT sync right away.
- The first sync brings in up to your 100 most recent finished FACEIT matches. After that, new ones arrive with every background check (every 30 minutes) or when you press Get recent matches.
- FACEIT matches have the mode FACEIT and the source FACEIT in the Matches filters.
- The Matches page's sync status menu shows FACEIT linked, or FACEIT sync failed when the last FACEIT sync didn't work: for example FACEIT was limiting requests, or some matches were skipped because that FACEIT account plays CS2 on a different Steam account. A failed sync also shows next to the status; click it to open Settings.
Note: Why FACEIT matches are scoreboard only
Grindhouse reads FACEIT matches from FACEIT's data service, which shares each match's scoreboard. FACEIT's demos need a paid FACEIT licence, so they aren't downloaded for you. FACEIT's scoreboard still has more than Valve's: ADR, multi-kills, entry duels, 1v1 and 1v2 clutches, utility damage and enemies flashed.
Tip: Get the full breakdown of a FACEIT match
Download the demo from the FACEIT match room and upload it without renaming it. It replaces the scoreboard with the full breakdown and adds a 2D replay. The match page's Import demo file button on a FACEIT match does the same.
FACEIT messages
| Message | What it means |
|---|---|
| Enter your FACEIT nickname | The nickname box is empty. |
| We couldn't find a FACEIT player with that nickname. | Check the spelling, exactly as on your FACEIT profile. |
| That FACEIT account plays CS2 on a different Steam account than the one linked to Grindhouse. | Link the FACEIT account you play CS2 with on your linked Steam account. |
| That FACEIT account has no CS2 profile, so there's no Steam account to match with yours. Check the nickname, or add CS2 to that account on FACEIT first. | The nickname belongs to a FACEIT account that has never added CS2. Check the spelling, or use the FACEIT account you play CS2 on. |
| That FACEIT account is already linked to another Grindhouse account. | Unlink it there first. |
| FACEIT is limiting how often Grindhouse can look players up right now. Try again in a minute. | FACEIT is rate limiting Grindhouse's server, not you. Wait a minute and press Link FACEIT again. |
| Couldn't reach FACEIT: … / FACEIT answered … / FACEIT sent something unexpected: … | FACEIT can't be reached right now. |
| This FACEIT link has expired. Go back to Grindhouse and try again. You can close this tab. | Shown on the page FACEIT sends you back to, when the sign-in took too long. Start again from Settings. |
| Linking FACEIT needs a FACEIT API key on the Grindhouse server, and this one doesn't have it set up yet. | FACEIT isn't available right now; the FACEIT row says Not available on this server. |
Unlink FACEIT asks first: "Your FACEIT level leaves your profile and new FACEIT matches stop importing. Matches already imported stay. You can link it again any time."
Get recent matches
Get recent matches is the button at the top right of the Matches page. On the website it needs a background source: saved match-sharing codes (status Syncing, Waiting for first sync or Sync error) or a linked FACEIT account. Without one, the button says Set up sync and opens Settings. While your codes are saved but background sync isn't switched on on Grindhouse's side yet (Waiting for the server), it opens Settings too: there's nothing to set up.
Pressing it asks Grindhouse's servers to check your codes and FACEIT right now, then watches for new matches for up to 30 seconds. The sync status shows "Checking for new matches…" while it waits (the menu item says Getting matches…), then one of:
- "Imported 2 matches." The new ones appear in the list with a New tag.
- "You're up to date."
- "Still syncing in the background. New matches show up here when it's done." The check takes longer than 30 seconds, for example when several demos need reading.
It doesn't run during a demo upload ("A demo is still uploading. Sync again when it's done.").
The sync status on Matches
At the top right of the Matches page, the ▾ next to Get recent matches opens how your matches are coming in: what's going on in bold, what the last sync did and when under it, where your matches come from (a dot each), Background sync and Import demo file. Once you have a background source, Home's Your matches repeats the bold part next to its title.
| Status | In its menu | What it means |
|---|---|---|
| Background sync off | Upload a demo, or turn on background sync | No background source yet: "Add your match-sharing codes in Settings and new matches arrive by themselves." |
| Background sync not on yet | Upload a demo to import a match | Your match-sharing codes are saved, but background sync isn't switched on on Grindhouse's side yet. Under it: why. |
| Background sync on | Background sync is on | Grindhouse checks for you. Under it, what your last Get recent matches or upload brought in, for example "Imported 2 matches." or "2 new from background sync.", or "New matches arrive on their own." |
| Checking for new matches… | A sync is running. In the menu: how many new matches it found so far. | |
| Uploading file… 42% Reading file… | A demo upload, then Grindhouse reading it. | |
| Offline | Offline, can't sync right now Offline, can't import right now | Grindhouse can't be reached during a sync or a demo upload. A line over the list says so, with Try again. |
| Import didn't finish | Import didn't finish | A demo upload failed. The line over the list gives the reason, for example "This is a CS:GO demo. Only CS2 demos can be imported." See upload messages. |
| Sync didn't finish | Sync didn't finish | A sync failed. The line over the list gives the reason, for example "Sign in to see and import your matches." |
The menu also lists your match-sharing status and FACEIT linked or FACEIT sync failed, each with a line on what it does, and Open Settings. A source with a problem (a code Valve no longer accepts, a sync error, a failed FACEIT sync) also shows next to the status; click it to open Settings.
Questions
Why don't I see matches from before I added my codes?
Background sync starts at the match code you saved: it brings in that match and the ones after it. Upload the demos of earlier matches you want, while you still have them: Valve keeps match demos for about a month.
Why is one of my matches scoreboard only?
Either Valve had deleted the demo by the time the match came in, or it's a FACEIT match. Hover the Scoreboard only tag for the reason. If you have the demo, upload it and the match becomes a full one.
I play on more than one PC. Do I need to set anything up on each?
No. Match-sharing codes run on Grindhouse's servers and catch every match on your Steam account, wherever you played it.
Is my authentication code safe with Grindhouse?
It's not your Steam password: it only lets an app read your CS2 match history. Grindhouse stores it encrypted, never shows it again, and you can remove it any time with Remove codes in Settings → Match history. Deleting your Grindhouse account removes it too.
Can I import a match I watched but didn't play?
No. Every match is tied to the players in it, and you can only import and open matches your linked Steam account played in.