Skip to content

turboplay

Use turboplay to launch Turbo applications with a graphical wrapper for turbo.exe commands and to stream applications from remote servers over RDP.

Usage

text
turboplay turbo <command> [<options>...]
turboplay <command-file>
turboplay rdp --rdp-host=<hostname> [--rdp-program=<program>] [--rdp-user=<user>] [--rdp-password=<password>] [--rdp-domain=<domain>] [--rdp-cmd=<args>] [--rdp-port=<port>]

Description

  • Provides a UI-driven launcher for turbo.exe commands so you can avoid the command prompt.
  • Accepts a Turbo command file for scripted launches.
  • Connects to remote application servers for RDP-based streaming via the Turbo URI scheme or direct RDP parameters.
  • Automatically adds --format=rpc to parse CLI output and --show-eula-for-rpc to display EULAs when present.
  • Ignores the Turbo CLI --wait-after-error and --wait-after-exit flags because the UI cannot capture interactive input.

Options

  • --quiet — Hide all graphical user interfaces until the application launches.
  • --start-progress-ui-immediately — Show the status dialog immediately before any events are detected from turbo.exe.
  • --wait-for-window — Keep the status dialog open until the application's main UI appears.
  • --delete-cmd-file — Delete the specified command file immediately after reading it.
  • --app-title — Set the title of the status dialog.
  • --debug-vm — Override the path to the VM.
  • --log — Specify the location of the log file.
  • --startup-file — Pass through a startup file to turbo.exe.
  • --startup-verb — Pass through a startup verb to turbo.exe.
  • --isolate — Pass through the isolation setting to turbo.exe.
  • --merge-file — Pass through the merge file setting to turbo.exe.

Examples

bash
# Launch an image with a graphical status dialog
turboplay turbo run --format=rpc my-image
bash
# Execute a Turbo command from a text file
turboplay turbo "C:\Users\<user>\AppData\Local\Turbo\Containers\shortcuts\My App.txt"
bash
# Connect directly to a remote desktop app
turboplay rdp --rdp-host=<hostname> --rdp-program=<remoteAppProgram> --rdp-user=<rdpUsername> --rdp-password=<rdpPassword>

Turbo URI Scheme

The Turbo URI scheme directs turboplay to either execute a local application or connect to a remote application server.

text
turbo://{portalAuthority}/{configPath}?t={type}&h={hash}&v={version}
  • portalAuthority — Trusted domain that hosts the configuration.
  • configPath — Path of the service, typically config.
  • typeconfig for local launches or remoteAppConfig for remote streaming.
  • hash — Hash of the configuration to ensure it is not tampered with.
  • version — Current version, 1.

Local Configuration Example

turbo://turbo.net/config?t=config&h=sha256:e28dd1863f82e6b2f46303311540ae194045a58756cd1c4fbbbc4c778021bc84&v=1

json
{
  "id": "2b68b3de-51e2-4a60-b822-bd810a55146f",
  "repoId": "mozilla/firefox",
  "appTitle": "Firefox",
  "verb": "try",
  "isolation": "full",
  "isolateNetwork": false,
  "routes": [],
  "redirectedDomains": [],
  "adGroupPermissions": [],
  "startupFile": "",
  "vm": "",
  "layers": [],
  "using": [],
  "sync": false,
  "tnlr": false,
  "enableRemoteCommands": true,
  "v": "1"
}

Remote Configuration Example

turbo://turbo.net/config?t=remoteAppConfig&h=sha256:51d021ef9da4ee6c7910a4d5f19325fba77888ba94255ab67e0e4c0d8053fa6d&v=1

json
{
  "v": 1,
  "sessionId": "e3e9df43-8f1e-4b0c-a371-8080b67cbc66",
  "host": "192.0.2.1",
  "auth": {
    "user": "randomWindowsUser",
    "password": "randomWindowsPassword"
  },
  "app": "turboplay",
  "args": "turbourl turbo://config.to/run"
}

Legacy Support

Turbo Play maintains support for legacy applications through config and model URLs.

text
/config
/model
/xsandboxname
/xsandboxpath
/register
/cachemode
/clientconfig
/xvm