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 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. `-branch <branchname>` | download from specified branch if available (default: Public). `-branchpassword <pass>` | branch password if applicable. `-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. `-pubfile <#>` | the PublishedFileId to download. (Will automatically resolve to UGC id) `-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) `-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-servers <#>` | maximum number of content servers to use. (default: 20). `-max-downloads <#>` | maximum number of chunks to download concurrently. (default: 8). `-loginid <#>` | a unique 32-bit integer Steam LogonID in decimal, required if running multiple instances of DepotDownloader concurrently. `-use-lancache` | forces downloads over the local network via a Lancache instance `-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. ", 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"