base on Steam depot downloader utilizing the SteamKit2 library. DepotDownloader =============== Steam depot downloader utilizing the SteamKit2 library. Supports .NET 8.0 This program must be run from a console, it has no GUI. ## Installation ### Directly from GitHub Download a binary from [the releases page](https://github.com/SteamRE/DepotDownloader/releases/latest). ### via Windows Package Manager CLI (aka winget) On Windows, [winget](https://github.com/microsoft/winget-cli) users can download and install the latest Terminal release by installing the `SteamRE.DepotDownloader` package: ```powershell winget install --exact --id SteamRE.DepotDownloader ``` ### via Homebrew On macOS, [Homebrew](https://brew.sh) users can download and install that latest release by running the following commands: ```shell brew tap steamre/tools brew install depotdownloader ``` ## Usage ### Downloading one or all depots for an app ```powershell ./DepotDownloader -app <id> [-depot <id> [-manifest <id>]] [-username <username> [-password <password>]] [other options] ``` For example: `./DepotDownloader -app 730 -depot 731 -manifest 7617088375292372759` By default it will use anonymous account ([view which apps are available on it here](https://steamdb.info/sub/17906/)). To use your account, specify the `-username <username>` parameter. Password will be asked interactively if you do not use specify the `-password` parameter. ### Downloading a workshop item using pubfile id ```powershell ./DepotDownloader -app <id> -pubfile <id> [-username <username> [-password <password>]] ``` For example: `./DepotDownloader -app 730 -pubfile 1885082371` ### Downloading a workshop item using ugc id ```powershell ./DepotDownloader -app <id> -ugc <id> [-username <username> [-password <password>]] ``` For example: `./DepotDownloader -app 730 -ugc 770604181014286929` ## Parameters #### Authentication Parameter | Description ----------------------- | ----------- `-username <user>` | the username of the account to login to for restricted content. `-password <pass>` | the password of the account to login to for restricted content. `-remember-password` | if set, remember the password for subsequent logins of this user. (Use `-username <username> -remember-password` as login credentials) `-qr` | display a login QR code to be scanned with the Steam mobile app `-no-mobile` | prefer entering a 2FA code instead of prompting to accept in the Steam mobile app. `-loginid <#>` | a unique 32-bit integer Steam LogonID in decimal, required if running multiple instances of DepotDownloader concurrently. #### Downloading Parameter | Description ------------------------ | ----------- `-app <#>` | the AppID to download. `-depot <#>` | the DepotID to download. `-manifest <id>` | manifest id of content to download (requires `-depot`, default: current for branch). `-ugc <#>` | the UGC ID to download. `-pubfile <#>` | the PublishedFileId to download. (Will automatically resolve to UGC id) `-branch <branchname>` | download from specified branch if available (default: Public). `-branchpassword <pass>` | branch password if applicable. #### Download configuration Parameter | Description ----------------------- | ----------- `-all-platforms` | downloads all platform-specific depots when `-app` is used. `-os <os>` | the operating system for which to download the game (windows, macos or linux, default: OS the program is currently running on) `-osarch <arch>` | the architecture for which to download the game (32 or 64, default: the host's architecture) `-all-archs` | download all architecture-specific depots when `-app` is used. `-all-languages` | download all language-specific depots when `-app` is used. `-language <lang>` | the language for which to download the game (default: english) `-lowviolence` | download low violence depots when `-app` is used. `-dir <installdir>` | the directory in which to place downloaded files. `-filelist <file.txt>` | the name of a local file that contains a list of files to download (from the manifest). prefix file path with `regex:` if you want to match with regex. each file path should be on their own line. `-validate` | include checksum verification of files already downloaded. `-manifest-only` | downloads a human readable manifest for any depots that would be downloaded. `-cellid <#>` | the overridden CellID of the content server to download from. `-max-downloads <#>` | maximum number of chunks to download concurrently. (default: 8). `-use-lancache` | forces downloads over the local network via a Lancache instance. #### Other Parameter | Description ----------------------- | ----------- `-debug` | enable verbose debug logging. `-V` or `--version` | print version and runtime. ## Frequently Asked Questions ### Why am I prompted to enter a 2-factor code every time I run the app? Your 2-factor code authenticates a Steam session. You need to "remember" your session with `-remember-password` which persists the login key for your Steam session. ### Can I run DepotDownloader while an account is already connected to Steam? Any connection to Steam will be closed if they share a LoginID. You can specify a different LoginID with `-loginid`. ### Why doesn't my password containing special characters work? Do I have to specify the password on the command line? If you pass the `-password` parameter with a password that contains special characters, you will need to escape the command appropriately for the shell you are using. You do not have to include the `-password` parameter on the command line as long as you include a `-username`. You will be prompted to enter your password interactively. ### I am getting error 401 or no manifest code returned for old manifest ids Try logging in with a Steam account, this may happen when using anonymous account. Steam allows developers to block downloading old manifests, in which case no manifest code is returned even when parameters appear correct. ### Why am I getting slow download speeds and frequent connection timeouts? When downloading old builds, cache server may not have the chunks readily available which makes downloading slower. Try increasing `-max-downloads` to saturate the network more. ", Assign "at most 3 tags" to the expected json: {"id":"9695","tags":[]} "only from the tags list I provide: [{"id":77,"name":"3d"},{"id":89,"name":"agent"},{"id":17,"name":"ai"},{"id":54,"name":"algorithm"},{"id":24,"name":"api"},{"id":44,"name":"authentication"},{"id":3,"name":"aws"},{"id":27,"name":"backend"},{"id":60,"name":"benchmark"},{"id":72,"name":"best-practices"},{"id":39,"name":"bitcoin"},{"id":37,"name":"blockchain"},{"id":1,"name":"blog"},{"id":45,"name":"bundler"},{"id":58,"name":"cache"},{"id":21,"name":"chat"},{"id":49,"name":"cicd"},{"id":4,"name":"cli"},{"id":64,"name":"cloud-native"},{"id":48,"name":"cms"},{"id":61,"name":"compiler"},{"id":68,"name":"containerization"},{"id":92,"name":"crm"},{"id":34,"name":"data"},{"id":47,"name":"database"},{"id":8,"name":"declarative-gui "},{"id":9,"name":"deploy-tool"},{"id":53,"name":"desktop-app"},{"id":6,"name":"dev-exp-lib"},{"id":59,"name":"dev-tool"},{"id":13,"name":"ecommerce"},{"id":26,"name":"editor"},{"id":66,"name":"emulator"},{"id":62,"name":"filesystem"},{"id":80,"name":"finance"},{"id":15,"name":"firmware"},{"id":73,"name":"for-fun"},{"id":2,"name":"framework"},{"id":11,"name":"frontend"},{"id":22,"name":"game"},{"id":81,"name":"game-engine "},{"id":23,"name":"graphql"},{"id":84,"name":"gui"},{"id":91,"name":"http"},{"id":5,"name":"http-client"},{"id":51,"name":"iac"},{"id":30,"name":"ide"},{"id":78,"name":"iot"},{"id":40,"name":"json"},{"id":83,"name":"julian"},{"id":38,"name":"k8s"},{"id":31,"name":"language"},{"id":10,"name":"learning-resource"},{"id":33,"name":"lib"},{"id":41,"name":"linter"},{"id":28,"name":"lms"},{"id":16,"name":"logging"},{"id":76,"name":"low-code"},{"id":90,"name":"message-queue"},{"id":42,"name":"mobile-app"},{"id":18,"name":"monitoring"},{"id":36,"name":"networking"},{"id":7,"name":"node-version"},{"id":55,"name":"nosql"},{"id":57,"name":"observability"},{"id":46,"name":"orm"},{"id":52,"name":"os"},{"id":14,"name":"parser"},{"id":74,"name":"react"},{"id":82,"name":"real-time"},{"id":56,"name":"robot"},{"id":65,"name":"runtime"},{"id":32,"name":"sdk"},{"id":71,"name":"search"},{"id":63,"name":"secrets"},{"id":25,"name":"security"},{"id":85,"name":"server"},{"id":86,"name":"serverless"},{"id":70,"name":"storage"},{"id":75,"name":"system-design"},{"id":79,"name":"terminal"},{"id":29,"name":"testing"},{"id":12,"name":"ui"},{"id":50,"name":"ux"},{"id":88,"name":"video"},{"id":20,"name":"web-app"},{"id":35,"name":"web-server"},{"id":43,"name":"webassembly"},{"id":69,"name":"workflow"},{"id":87,"name":"yaml"}]" returns me the "expected json"