This console tool enables you to output pieces of information about your CS:GO user profile and latest matches. You can also use the tool to upload demo sharecodes to https://csstats.gg/ (formerly csgostats.gg).
| Branch | CI | Code Quality | Spell Check |
|---|---|---|---|
&query=$%5B%27version%27%5D&color=blue){kind=icon} |
 |
 |
 |
The installation is easy. It's just a zipped folder containing the application.
Download the zip file, extract it to a location of your choice and then run the app.
- Download the latest release of
csgo-cli-vX.Y.Z.zipfrom Github: https://github.com/jakoch/csgo-cli/releases/latest - Extract the zip file. Switch to the "csgo_cli" folder.
- Then run
csgo_clion the command-line interface or just runupdate.batto upload your recent matches.
- Windows
- Steam application running
- CS:GO application not running
Display commands:
csgo_cliOutput:
csgo_cli v1.0.3, https://github.com/jakoch/csgo-cli
Copyright (c) 2018-2019 Jens A. Koch.
CS:GO Console shows your user account, stats and latest matches.
You can also use the tool to upload demo sharecodes to csgostats.gg.
Usage:
command [options] [arguments]
Available commands:
-user Show your profile (SteamID, AccountID, MM-Rank, Likes, VAC-Status)
-matches Show your past matches in table form
-upload Upload your past matches to csgostats.gg
-s, sharecode Upload a demo sharecode to csgostats.gg
Options:
-h, help Display this help message
-v, verbose Increase verbosity of messages
-V, Version Display application versionFetch matches and upload to csgostats (or just use update.bat):
csgo_cli -matches -uploadIf you encounter any issues, please use the verbose mode for debugging purposes:
csgo_cli -matches -upload -verboseThe tool connects to your running Steam as CS:GO game client (SteamApp 730). It communicates with the Steam API to request the serialized player and match infos. The structure of the serialized data is described by the csgo-protobufs. These infos are then deserialized using Protobuf and placed into iterable objects for further processing and output.
Automatic Upload of Demo ShareCodes to http://csgostats.gg/
The ShareCode is an URL, which you might pass around to your friends.
It looks like so: steam://rungame/730/76561202255233023/+csgo_download_match%20CSGO-xxxxx-xxxxx-xxxxx-xxxxx-xxxxx
If you click on this URL or open it in a browser tab it will tell Steam to launch CS:GO, automatically download the demo and open it for replay. The code at the end of the URL is the id of the match.
The tool requests your latest matches and builds the ShareCodes for the demos. The ShareCodes are then automatically uploaded to https://csgostats.gg/
This avoids the manual posting of the sharecode via the csgostats webinterface or the posting to the csgostats steam group, where the bots pick it up. https://csgostats.gg/getting-the-sharecode
The file containing the logic for uploading the ShareCode is ShareCodeUpload.cpp.
uploadShareCode() uses cURL to POST the ShareCode. Posting data to csgostats.gg is difficult because the server is Cloudflare protected. Even normal browsing behavior can trigger a cloudflare redirect to a captcha page or a website ban.
Before we can POST one or multiple sharecodes, a GET request to csgostats.gg is needed to get a cURL connection handle, including all relevant cookies. The cURL handle is then re-used for one or more POST requests (sending the cookies as header data and the sharecode(s) as post data).
The response is then parsed by processJsonResponse(). There are 4 response possibilities: There is a HTML response by Cloudflare, the HTML captcha page. There are 3 JSON response types by csgostats.gg: error, queued, complete. See testProcessJsonResponse()
For testing purposes: Posting a ShareCode to csgostats.gg using cURL on the CLI
curl "https://csgostats.gg/match/upload/ajax" -H "accept-language: en" -H "content-type: application/x-www-form-urlencoded; charset=UTF-8" -H "accept: application/json, text/javascript, */*; q=0.01" -H "x-requested-with: XMLHttpRequest" --data "sharecode=CSGO-WSACM-qX5Gv-ikbi3-Z6uOW-TGwPB&index=0"
- Steamworks SDK API Docs
- The official Steamworks SDK is used for making the Steam API connection and requesting data.
- Google Protobuf
- A language-neutral, platform-neutral, extensible mechanism for serializing structured data.
- Protobuf is used for deserializing the player and match infos.
- CS:GO Protobufs
- The csgo-protobufs are provided by the steamdb.info project.
- The Protobuf Compiler (protoc) is used during the build process to compile the csgo-protobufs to C++ objects for data access.
- nlohmann/json
- nlohmann/json is used to parse the JSON responses from the csgostats server (error, complete, queued).
- ConsoleTable (inside /src)
- ConsoleTable is used to print tables to the console.
- Curl
- libcurl is used for transferring data.
- CMake
- CMake is used as build tool.
- Github Actions
- Github Actions is used as build and deployment service.
Before releasing a new version:
- Update Version number in vcpkg.json
- Update CHANGELOG.md
- CI setup
- cmake
-
appveyor.yaml- switched to Github Actions @ 09/2021-
VC15 x64
-
- added Github Actions (./github/workflows)
- MSVC22 - VC17 - x64-windows-static
- vendor dependencies
- steam sdk
- encrypt
- decrypt via env secret
- protobuf
- cs:go protobufs
- patch cs:go protobuf syntax
- curl
-
rapidjson - nlohmann-json
- fmt
- spdlog
- steam sdk
- package and deploy the application
- package and deploy the dependencies
- exclude sw_sdk (not redistributable), ship encrypted version
- connect as CSGO GameClient to Steam
- fetch player info
- calculate steamids
- fetch latest matches
- calculate demo share-codes
- upload demo share-codes to csgostats.gg
- curl based share-code uploader
-
rapid-json based response parser - nlohmann-json based response parser
- to avoid re-posting sharecodes (ShareCodeCache)
- store matches locally (json, cvs, sqlite)
- request additional steam profile data via web-api
- colors on the CLI (LOSS red, WIN green)