Skip to content
GrindhouseDocs

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.

NeedsA linked Steam account
Background syncEvery 30 minutes, or Get recent matches
Demo files.dem, .dem.gz, .dem.bz2, .dem.zst
Upload limit1 GB per demo

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

WayMatchesWhat you getWhen it runsWhat you do
Match-sharing codesPremier, Competitive, WingmanFull 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 closedPaste two codes once
Demo uploadAny CS2 demo you played in: matchmaking, FACEIT, scrimsFull breakdown and 2D replayWhen you upload a filePick the file each time
FACEIT linkFACEITScoreboard only, plus your FACEIT level and EloIn the background on Grindhouse's serversLink your account once
Demo upload Any CS2 demo you played in Match-sharing codes Premier · Competitive · Wingman FACEIT link Sign in with FACEIT or nickname Is the demo still on Valve's servers? about 30 days Yes No Full breakdown Rounds, kill feed, economy Aim, entry and utility stats Findings and coaching 2D replay Scoreboard only Kills, deaths, assists, HS%, MVPs FACEIT also has ADR and entries No rounds, no 2D replay Upload the demo to upgrade it
How a match gets in, and what it becomes.

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 pageFull breakdownScoreboard only
Final score, K / D / A, headshot %, MVPsYesYes
ADR, multi-kills, opening duels, clutches, utility damage, enemies flashedYesFACEIT matches only
Rating and KASTYesNo
Aim stats: accuracy, spotted accuracy, spray accuracy, counter-strafe, time to damage, time to kill, crosshair placementYesNo
Rounds strip, kill feed, economy per roundYesNo
How you played: findings, drills, every stat vs your rankEvery statOnly the stats the scoreboard has
2D replayYesNo

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

  1. 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.

  2. 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.

  3. 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.

  4. 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.

  5. 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.

Authentication codeAAAA-AAAAA-AAAA
Latest match codeCSGO-xxxxx-xxxxx-xxxxx-xxxxx-xxxxx

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

MessageWhat it means
Paste your authentication code
Paste your latest match code
That field is empty.
Format: AAAA-AAAAA-AAAAThe authentication code isn't three groups of 4, 5 and 4 letters or digits.
Starts with CSGO- and has five groups of 5The 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

Settings, Match history with codes saved: the Background sync row with the Syncing badge and Last synced 25 min ago, and the Match codes row with the partly hidden match code, Authentication code saved, Replace and the more-actions menu
Settings → Match history once your codes are saved and syncing.

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.

SettingsMatches pageWhat it meansWhat to do
OffMatch sharing offNo codes saved.Add them, or upload demos.
Waiting for first syncMatch sharing: waiting for first syncCodes saved. The first background sync runs shortly and brings in the match whose code you pasted.Nothing.
SyncingMatch sharing onBackground sync is on and working.Nothing.
Needs a newer match codeMatch sharing needs a newer codeSteam no longer accepts the saved match code.Press Update codes and paste the code of your most recent match.
Authentication code rejectedMatch sharing code rejectedSteam rejected the authentication code.Create a new one on Steam's page and save it with Update codes.
Waiting for the serverMatch sharing: waiting for the serverYour 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 errorMatch sharing errorYour 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.

  1. 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.

  2. Pick one or more demos

    .dem, or a compressed .dem.gz, .dem.bz2 or .dem.zst, up to 1 GB each. Pick several at once and they upload one after the other.

  3. 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.

  4. 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.

The Matches page during a demo upload: the sync status at the top right reads Uploading match730_….dem… 50% with Import demo file greyed out next to it, and a row at the top of the list shows the upload with its progress bar
A demo upload in progress: the sync status and the row at the top of the list show how far it is.
SizeUp to 1 GB per demo
At once2 per account
Stalled uploadExpires after 1 hour
WhoYou must be in the match

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\replays inside your CS2 folder, named match730_….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

MessageWhat 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.

  1. Open Connections

    Go to Settings → Connections. The FACEIT row says Not linked: "Adds your level and your FACEIT matches."

  2. 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.

  3. 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

MessageWhat it means
Enter your FACEIT nicknameThe 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.

StatusIn its menuWhat it means
Background sync offUpload a demo, or turn on background syncNo background source yet: "Add your match-sharing codes in Settings and new matches arrive by themselves."
Background sync not on yetUpload a demo to import a matchYour match-sharing codes are saved, but background sync isn't switched on on Grindhouse's side yet. Under it: why.
Background sync onBackground sync is onGrindhouse 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.
OfflineOffline, 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 finishImport didn't finishA 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 finishSync didn't finishA 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.