Command line options and heronite:// links

Start Heronite from scripts: command line options like --launch, --console and --no-gui, game ids for each store, and heronite:// links.

Start Heronite from scripts with options such as --launch. The program is heronite-rs on Linux and with the Windows installer (heronite-rs.exe), and heronite.exe in the Windows portable copy.

Command line options

Option What it does
--launch <game> Starts a game (see below)
--no-gui With --launch: no window; Heronite quits when the game ends
--console Opens in console mode
--fullscreen Opens fullscreen (F11 switches back)
--autostart Used by Start with the system in Settings → General; only then does Start minimized apply
-h, --help Shows the options

Only one Heronite runs at a time: starting it again hands the request (like --launch) to the one already running.

Launch a game from the command line

--launch takes the game’s store id, not its name, optionally with the store tool in front:

heronite-rs --launch gog_1207658930      # GOG game 1207658930
heronite-rs --launch gog 1207658930      # the same
heronite-rs --launch 1207658930          # searches every store
heronite-rs --launch legendary_Fortnite --no-gui
Prefix Store
legendary Epic Games
gog GOG
nile Amazon Games
sideload Games you added yourself

Shortcuts Heronite creates (desktop, Start menu, Steam) already contain the right command, so this is mostly for scripts.

heronite://launch/<game>
heronite://launch/<store>/<game>
heronite://launch?appName=<game>&runner=<store>

The query form also takes:

  • arg=<value>: an argument for the game (repeat it for more)
  • gui=false: start without showing Heronite’s window

Write spaces in names as %20 (My%20Game). To hide the window for every link, turn on Hide the window for heronite:// launches. The old heronite-rs:// scheme still works.

  • Windows installer: registered for your user at every start
  • Windows portable: not registered, so the copy leaves no trace on the PC
  • Linux: registered by scripts/install.sh when built from source
Updated November 4, 2026Something wrong or missing? Tell us on GitHub.