SMD 1.5.0 Source

00 Steam depot tool, Rust and Tauri v2

Steam Manifest [ Downloader ] depots to disk

Drag in a .lua or .st file, or search by App ID. SMD resolves the depot IDs, manifest GIDs and depot keys, then writes the depot contents to a folder you pick.

  • Windows 10, 11 and Linux
  • Desktop, terminal and Docker
  • Rust and Tauri v2
  • GPL-2.0
Current release
1.5.0
Download engines
02
Configurable source types
05
Ways to run it
03
  • Rust
  • Tauri v2
  • Steam PICS
  • Anonymous CDN session
  • Manifest request codes
  • Chunk download and decryption
  • .NET 9 desktop runtime
  • gbe_fork
  • Steamless
  • GitHub sources
  • archive.org items
  • HTTPS folder
  • Hubcap API
  • Ryuu API
  • WebKitGTK
  • AppImage
  • NSIS
  • Terminal UI
  • Headless CLI
  • Docker
  • GPL-2.0

01 Capability

six blocks

What it does

One file or one App ID goes in. Depot IDs, manifest GIDs and depot keys come back, and the depot contents land in a folder you choose.

Two download engines

A pure Rust pipeline talks to Steam's CDN directly: anonymous login, manifest request codes, chunk download and chunk decryption, all in process, with no .NET involved. It is the default, and the app still labels it experimental. A bundled .NET engine, DepotDownloaderMod, is there when you would rather use that instead.

The Rust pipeline keeps a small checkpoint while it downloads. Resume a cancelled download from the history and it continues where it stopped, checking only a few chunks around that point instead of re-reading the whole game. A full check of every file is one click away when you want it.

enginerust-cdn
  • loginanonymous
  • requestmanifest request code
  • transferchunk download
  • decryptchunk decryption, in process
  • dotnetnot required
  • resumecontinues from a checkpoint
enginebundled dotnet
  • bundledyes
  • dotnet.NET 9 desktop runtime

Sources you configure

Point SMD at GitHub repositories, archive.org items or a plain HTTPS folder. Add the Hubcap and Ryuu APIs as well if you hold a key for them.

Sources are queried in the order you set. The check for whether an App ID exists stops at the first source that answers, so the order you choose is the order that decides.

sourcesqueried in order
  • githubrepositories you list
  • archive.orgitems
  • httpsplain folder
  • hubcapapi, key required
  • ryuuapi, key required
  • probestops at the first answer

Live depot metadata

Platform, architecture and language come from Steam PICS at the moment you look, so the depot list you select from is the one Steam is serving now.

For each depot the app shows the depot ID, the manifest ID, the platform and architecture it targets, and the size.

Switch on Like Steam in the settings and SMD picks the depots itself: the ones that make up the base game for your system and language, without DLC. They all go into one game folder, the way Steam installs them. One button adds the DLC as well. Off by default, so you keep choosing every depot yourself.

depot listrecreation
depot manifest os arch size
10001072057…93606windowsx641.4 GB
10001172057…41288windowsx86640 MB
10001272057…07734linuxx641.1 GB
10001372057…55019linuxx64212 MB
Recreation of the app's depot list, drawn in HTML rather than captured. The columns are fields the app shows for each depot. The values are placeholders.

After the files land

Patching is optional and separate from downloading. You can patch with the gbe_fork emulator, which has a variant picker, 21 settings and per file patch selection. In Like Steam mode, the DLC you downloaded is marked as owned in the emulator settings automatically. You can detect and remove SteamStub DRM with Steamless, and install a Steam API check bypass. For achievement pop-ups the emulator step points you to Achievement Watcher.

You can also add the game to your Steam library as a non-Steam entry, with banner, hero, logo and icon. SMD checks first whether Steam is running, because Steam would drop the entry when it exits, and offers to close and restart it for you. If Steam is installed somewhere SMD does not look, you pick the Steam folder once and it is remembered. On Windows it creates desktop and Start Menu shortcuts as well.

optional stepspost download
  • 01gbe_fork patch, variant picker, 21 settings, per file selection, chosen DLC marked
  • 02Steamless, detects and removes SteamStub DRM
  • 03Steam API check bypass
  • 04Steam library entry with banner, hero, logo, icon
  • 05Windows desktop and Start Menu shortcuts

Keep a game current

A game you downloaded before can be updated in place from the history. Only the parts that changed are downloaded, files the new version no longer has are deleted, and everything that never belonged to the game, such as saves and emulator settings, stays where it is. Depots whose manifest did not change are skipped entirely.

A speed limit in MB/s or Mbit/s keeps the rest of your connection usable and applies to a download that is already running. And if you start a long download before bed, SMD can shut the PC down when it is done, after a countdown you can cancel.

updatein place
  • changedonly those parts are downloaded
  • unchangeddepot skipped
  • removeddeleted from the folder
  • your fileskept
while it runsoptional
  • speed limitMB/s or Mbit/s, applied live
  • when doneshut down after a 60 s countdown

Desktop, terminal or container

Next to the desktop app there is a terminal version, a single binary called smd. Started without arguments it opens a full interface in the terminal, with all five steps, the history and the settings, usable with mouse or keyboard.

Its subcommands search, download and list the history without any interface, for servers and scripts, and there is a Docker image on ghcr.io. The Linux binary is static, so it runs on any distribution. Desktop and terminal share settings and history.

smdterminal version
  • smdinteractive terminal interface
  • smd searchfind an App ID or its depots
  • smd downloaddownload, update, limit, shut down
  • smd historypast downloads
  • --jsonprogress as JSON lines
  • dockerghcr.io/mcbabel/steam-manifest-downloader

fig. 01generated artwork, not product data

02 Sequence

five steps

From file to folder

  1. Upload or search

    Drag and drop a .lua or .st file onto the window, or search by App ID. Configured sources are queried in the order you set, and the check for an App ID stops at the first source that answers.

  2. Select depots

    SMD resolves depot IDs, manifest GIDs and depot keys, and reads platform, architecture and language from Steam PICS. You pick the depots you want, or let Like Steam mode pick the base game for you. Add to Queue lines up several games.

  3. Download

    Run the pure Rust CDN pipeline or the bundled .NET engine. Contents are written to the folder you pick, after a check that they fit on the disk. A depot that fails is retried, and one bad depot no longer stops the rest. A cancelled run continues from where it stopped. A speed limit and a shutdown after the download are optional.

  4. Shortcuts and Steam library

    Add the game to your Steam library as a non-Steam entry, with banner, hero, logo and icon attached. SMD finds Steam on its own, or you choose the Steam folder. On Windows, desktop and Start Menu shortcuts are created as well.

  5. Emulator

    Optionally patch with gbe_fork using the variant picker, its 21 settings and per file patch selection. Remove SteamStub DRM with Steamless, or install the Steam API check bypass. A folder you patched before can be edited or reverted. Later, the same game can be updated, checked or started from the history.

03 Install

03 Install

four routes

Four ways in, depending on what you run.

Arch based distributions have packages in the AUR. Everywhere else on Linux there is an AppImage, and Windows 10 and 11 have an installer and a standalone ZIP. For servers and scripts there is the terminal version and a Docker image.

Arch, CachyOS, Manjaro

From the AUR

Two packages for the desktop app: the first installs the released binary, the second builds locally. They conflict with each other, so only one can be installed. The terminal version has a package of its own.

paru -S steam-manifest-downloader-bin

Released binary.

paru -S steam-manifest-downloader

Builds locally.

paru -S steam-manifest-downloader-terminal-bin

Terminal version, installs smd.

Other Linux

AppImage

Take the AppImage from the latest release. It brings WebKitGTK and everything else it needs, so nothing has to be installed. Make it executable and start it:

chmod +x Steam.Manifest.Downloader_*_amd64.AppImage

Runs on Ubuntu 22.04, Debian 12 and newer.

Windows 10 and 11

Installer or standalone ZIP

Both sit on the same releases page, and neither asks for admin rights. The installer sets the app up per user with a Start Menu entry. The standalone ZIP needs no installation at all: extract it into a folder of your own and start the app from there. It already contains gbe_fork, Steamless and the Steam API check bypass, so the emulator step works without extra downloads, which helps on PCs where GitHub downloads are blocked.

  • installerNSIS, per user, _x64-setup.exe
  • standaloneZIP, no install, _windows-standalone.zip
  • adminnot needed
  • runtimenone for the default engine

Only the optional DepotDownloaderMod engine needs the .NET 9 Desktop Runtime, and the app tells you if it is missing.

Servers, scripts, Docker

Terminal version

The terminal version is a single file per system on the releases page, Steam-Manifest-Downloader-Terminal_<version>_linux-x64 or _windows-x64.exe. Start it without arguments for the terminal interface, or use its commands. On Arch it is in the AUR as steam-manifest-downloader-terminal-bin. The same program is published as a Docker image:

docker run --rm -v smd-data:/data -v "$PWD/games:/games" ghcr.io/mcbabel/steam-manifest-downloader download 220

Downloads land in /games, settings and history in /data. Add -it and leave out the command for the terminal interface. Details are in the documentation.

04 Inside the app

04 The rest of the app

twelve details

Inside the app

history

A history that does the work

Every download is kept with its cover art. Search, filter and sort it, see when a game has an update, check and repair its files, start the game, resume a cancelled run or open its folder.

update

Update instead of starting over

Update brings an existing download to the newest version. Only changed parts are fetched, and saves and settings stay.

speed

A speed limit that applies live

Cap downloads in MB/s or Mbit/s. A change applies at once, even to a download that is already running.

power

Shut down when it is done

Switch it on during a download and the PC shuts down afterwards. A 60 second countdown lets you change your mind, and the next start offers the steps that were skipped.

steam

Steam library without surprises

Before a game is added, SMD checks whether Steam is running and can close and restart it, so the entry is not lost. A Steam install in an unusual place is found once you point at its folder.

interface

Two themes, two languages

Dark and light themes ship together. The desktop app and the terminal version are available in English and in German, down to the download log, error messages and smd --help.

telemetry

Off unless you turn it on

Opt in and off by default. If you switch it on, the payload is sealed on the client before it leaves the machine.

license

GPL-2.0, source in the open

Released under GPL-2.0, with the full source in the repository.

queue

Several games in a row

Add to Queue keeps downloads waiting, also across restarts. They run one after another, and the shutdown switch waits for the last one.

like steam

Depots picked for you

An optional mode selects the base game for your system and language, puts it in one folder and adds DLC on request, marked for gbe_fork.

network

Proxy with a test button

An HTTP, HTTPS or SOCKS5 proxy applies to every download. The test shows at once whether Steam answers, and errors name the real cause without leaking API keys.

desktop

Shortcuts and progress

Ctrl+O, Ctrl+F, Ctrl+H and Ctrl+comma reach the main screens. Progress shows on the taskbar and in the window title, and a warning comes before a download that does not fit.

05 Questions

05 Questions

fifteen answers

Questions

Short answers here, with the longer versions in the documentation.

Which files can I drop in?

A .lua or .st file. The file picker filters on those two extensions, and anything else is turned away with the message Please select a .lua or .st file. You can skip the file entirely and search by App ID instead.

Which systems does it run on?

Windows 10 and 11, and Linux. On Windows there is an NSIS installer that installs per user, and a standalone ZIP that needs no installation, neither asks for admin rights. On Arch, CachyOS and Manjaro there are two AUR packages, and everywhere else on Linux there is an AppImage that brings everything it needs. The terminal version runs on both systems, and its Docker image anywhere Docker runs on an Intel or AMD processor.

Do I need .NET installed?

Only for the bundled .NET engine, which wants the .NET 9 Desktop Runtime. The app checks for it on first launch. The pure Rust pipeline does chunk download and decryption in process and needs nothing extra.

Where do the depot keys come from?

From the sources you configure: GitHub repositories, archive.org items, a plain HTTPS folder, and the Hubcap and Ryuu APIs if you hold a key. They are queried in the order you set, and the check for whether an App ID exists stops at the first source that answers.

What happens if a download is interrupted?

Nothing is lost. Resume a cancelled download from the history and it continues from where it stopped, checking only the last chunks before that point. You can also choose to check every file first, which takes longer on big games. A download started again from scratch verifies the chunks already on disk rather than pulling everything a second time.

Can I update a game I downloaded earlier?

Yes. Open the history and pick Update on that entry. SMD downloads into the existing folder, fetches only the parts that changed, deletes files the new version no longer has and leaves saves, emulator settings and your own files alone. In the terminal version the same works with smd download --update <folder>.

Can I run it without a desktop, on a server or in Docker?

Yes. The terminal version smd searches, downloads and shows the history from the command line, and its Docker image is on ghcr.io as ghcr.io/mcbabel/steam-manifest-downloader. Started in an interactive terminal it also offers the full interface.

Can I limit the speed or shut down the PC afterwards?

Both. The speed limit sits in the settings and takes MB/s or Mbit/s. The switch to shut down the PC is on the download screen, and a 60 second countdown runs before the PC turns off, so you can still cancel. When you start SMD again it offers to continue with the steps that were skipped: shortcuts, Steam library and emulator.

Can it pick the depots for me?

Yes, if you switch on Like Steam in the settings. SMD then selects the depots of the base game for your system and language, downloads them into one game folder like Steam does, and leaves DLC out until you press the button to add them. DLC you add is marked as owned for gbe_fork. In the terminal version the same is smd download --like-steam, with --dlc for the DLC.

SMD does not find my Steam install. What now?

Choose the Steam folder in the settings, or straight from the Steam library step when it says Steam was not found. SMD checks that the folder really is a Steam install with a signed in user and remembers it. On Windows it reads the install path from the registry, on Linux it looks in the usual places, including Flatpak and Snap.

Every download fails with a connection error. Can a proxy help?

If your network blocks Steam, enter an HTTP, HTTPS or SOCKS5 proxy in the settings and press Test to see whether Steam answers through it. The error message names the actual cause, such as a refused connection, a DNS problem or an antivirus intercepting HTTPS. When nothing gets through at all, SMD stops early instead of trying every depot.

Which AUR package should I pick?

For the desktop app, use steam-manifest-downloader-bin for the released binary, or steam-manifest-downloader if you would rather build locally. The two conflict, so install one or the other. For the terminal version there is steam-manifest-downloader-terminal-bin, which installs smd and works next to either of them.

What is the emulator step for?

It is optional work after the download. You can patch with gbe_fork, which has a variant picker, 21 settings and per file patch selection. The bundled Steamless can detect and remove SteamStub DRM, and a Steam API check bypass can be installed. None of it is needed to get a depot onto disk.

Does it send anything back?

Telemetry is opt in and off by default. If you switch it on, the payload is sealed on the client before it leaves the machine.

Can it download a beta or private branch?

No. It signs in anonymously, which reaches the public branch only. Anything behind a password needs a tool that can pass those credentials, such as SteamRE's DepotDownloader.

06 Download

1.5.0

Version 1.5.0 is on the releases page.

Windows installer and standalone ZIP, Linux AppImage, AUR packages for Arch, CachyOS and Manjaro, the terminal version and a Docker image. Source under GPL-2.0.

Colophon