DepotDownloader

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.

via Windows Package Manager CLI (aka winget)

On Windows, winget users can download and install the latest Terminal release by installing the SteamRE.DepotDownloader package:

winget install --exact --id SteamRE.DepotDownloader

via Homebrew

On macOS, Homebrew users can download and install that latest release by running the following commands:

brew tap steamre/tools
brew install depotdownloader

Usage

Downloading one or all depots for an app

./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).

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

./DepotDownloader -app <id> -pubfile <id> [-username <username> [-password <password>]]

For example: ./DepotDownloader -app 730 -pubfile 1885082371

Downloading a workshop item using ugc id

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