> ## Documentation Index
> Fetch the complete documentation index at: https://devdocs.xbox.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Manage game streaming (wdgamestream.exe)

> Manage game streaming (wdgamestream.exe)

Use this tool to query whether a console is currently enabled for game streaming and to manage this state.

| Command                                                    | Description                                                                                                |
| :--------------------------------------------------------- | :--------------------------------------------------------------------------------------------------------- |
| [startlistening](#wdgamestream_startlistening)             | Devkit starts listening for connections.                                                                   |
| [stoplistening](#wdgamestream_stoplistening)               | Devkit stops listening for connections.                                                                    |
| [status](#wdgamestream_status)                             | Queries streaming status of devkit.                                                                        |
| [listconfigs](#wdgamestream_listconfigs)                   | Lists the streaming base configurations supported.                                                         |
| [enableremoteconnect](#wdgamestream_enableremoteconnect)   | Enable remote connect for the specified user. This setting persists across device reboot.                  |
| [disableremoteconnect](#wdgamestream_disableremoteconnect) | Disable remote connect for the specified user. This setting persists across device reboot.                 |
| [remoteconnectstatus](#wdgamestream_remoteconnectstatus)   | Queries the remote connect status for the specified user.                                                  |
| [setconfigoverride](#wdgamestream_setconfigoverride)       | Sets stream setting override(s) for the base stream configuration.                                         |
| [clearconfigoverride](#wdgamestream_clearconfigoverride)   | Clears stream setting override(s) that were set from the `setconfigoverride` command.                      |
| [dumpconfigoverride](#wdgamestream_dumpconfigoverride)     | Writes any stream setting overrides that have been set from the `setconfigoverride` command to the devkit. |

<a id="wdgamestream_startlistening" />

## wdgamestream startlistening

Starts listening for direct connect streaming connections on the devkit.

`wdgamestream startlistening [version=<version>] [config=<config>]`

<Note>For best compatibility, it recommended to **not** set `version` or `config`</Note>

| Parameter | Description                                                                                                                                                       |
| :-------- | :---------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| version   | Optional parameter that specifies the protocol version to use. Defaults to the latest protocol version that's supported by the console.                           |
| config    | Optional parameter to specify the stream configuration to use. The default is the highest bitrate configuration that's supported by the targeted Development Kit. |

<a id="wdgamestream_stoplistening" />

## wdgamestream stoplistening

Stops listening for direct connect streaming connections on the devkit.

`wdgamestream stoplistening`

<a id="wdgamestream_status" />

## wdgamestream status

Queries the streaming status of the devkit.

`wdgamestream status [/B] [/S]`

| Option | Description                                                                                                                                                                                                                       |
| ------ | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `/B`   | Specifies bare format. When enabled, the <b>status</b> command only prints a bare output. Bare mode must be used with at least one other flag, indicating which of the status data you want to retrieve (for example, <b>/S</b>). |
| `/S`   | Specifies streaming status only. When enabled, the <b>status</b> command only prints the streaming status of the devkit.                                                                                                          |

<a id="wdgamestream_listconfigs" />

## wdgamestream listconfigs

List the streaming base configurations supported. Provides a way to list out which streaming configuration options are available from the devkit.

`wdgamestream listconfigs`

<a id="wdgamestream_enableremoteconnect" />

## wdgamestream enableremoteconnect

Enable remote connect for the specified user.

`wdgamestream enableremoteconnect accountEmail=xxxx@y.com`

| Option         | Description                                                                                                                                                                                                                                           |
| -------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `accountEmail` | Required parameter. Specifies the email account for which remote connect should be enabled. Please note that this account must be currently signed in on the XBOX to enable remote connect and should be used when logging into the streaming client. |

<a id="wdgamestream_disableremoteconnect" />

## wdgamestream disableremoteconnect

Disables remote connect for the specified user.

`wdgamestream disableremoteconnect accountEmail=xxxx@y.com`

| Option         | Description                                                                                                                                                                                                                                           |
| -------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `accountEmail` | Required parameter. Specifies the email account for which remote connect should be enabled. Please note that this account must be currently signed in on the XBOX to enable remote connect and should be used when logging into the streaming client. |

<a id="wdgamestream_remoteconnectstatus" />

## wdgamestream remoteconnectstatus

Queries the remote connect status for the specified user.

`wdgamestream remoteconnectstatus accountEmail=xxxx@y.com`

| Option         | Description                                                                                                                                                                                                                                           |
| -------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `accountEmail` | Required parameter. Specifies the email account for which remote connect should be enabled. Please note that this account must be currently signed in on the XBOX to enable remote connect and should be used when logging into the streaming client. |

<a id="wdgamestream_setconfigoverride" />

## wdgamestream setconfigoverride

Sets one or more setting override of the base stream configuration. The base stream configuration for direct connect is specified by the `config` parameter of the `startlistening` command. The base stream configuration for remote connect is determined by XBOX services. Setting overrides are applied on `startlistening` for direct connect and on new stream connections for remote connect. Overrides do not persist between reboots and need to be reset after reboot if desired.

`wdgamestream setconfigoverride [maxBitrate=<value>] [minBitrate=<value>] [maxResolution=<value>] [minResolution=<value>] [allowDirectCapture=<true | false>]`

| Option               | Description                                                                                                                        |
| -------------------- | ---------------------------------------------------------------------------------------------------------------------------------- |
| `allowDirectCapture` | Optional boolean that enables or disables direct capture. Default value: <i>true</i>.                                              |
| `maxBitrate`         | Optional parameter that overrides the maximum bitrate of the stream. Example value: <i>12000000</i>.                               |
| `minBitrate`         | Optional parameter that overrides the minimum bitrate of the stream. Example value: <i>6000000</i>.                                |
| `maxResolution`      | Optional parameter that overrides the suggested maximum resolution of the video stream. Example values: <i>720p</i>, <i>1080p</i>. |
| `minResolution`      | Optional parameter that overrides the suggested minimum resolution of the video stream. Example values: <i>720p</i>, <i>1080p</i>. |

<a id="wdgamestream_clearconfigoverride" />

## wdgamestream clearconfigoverride

Clears one or more setting override(s) that were set with the `setconfigoverride` command.

`wdgamestream clearconfigoverride [/A] [maxBitrate] [minBitrate] [maxResolution] [minResolution] [allowDirectCapture]`

| Option               | Description                                                  |
| -------------------- | ------------------------------------------------------------ |
| `/A`                 | Clears all overrides.                                        |
| `allowDirectCapture` | Optional parameter to clear the direct capture override.     |
| `maxBitrate`         | Optional parameter to clear the maximum bitrate override.    |
| `minBitrate`         | Optional parameter to clear the minimum bitrate override.    |
| `maxResolution`      | Optional parameter to clear the maximum resolution override. |
| `minResolution`      | Optional parameter to clear the minimum resolution override. |

<a id="wdgamestream_dumpconfigoverride" />

## wdgamestream dumpconfigoverride

Writes all setting overrides that have been set from the `setconfigoverride` command to the devkit.

`wdgamestream dumpconfigoverride`

## See also

[Manage game streaming (xbgamestream.exe)](/tools/tools-console/commandlinetools/xbgamestream)

[Devkit Command-line tools](/tools/tools-console/console_commandlinetools/consolecommandlinetools)

[XTF transport errors](/tools/tools-console/commandlinetools/xtf-transport-errors)


## Related topics

- [Manage game streaming (xbgamestream.exe)](/tools/tools-console/commandlinetools/xbgamestream.md)
- [Console-based command-line tools](/tools/tools-console/console_commandlinetools/consolecommandlinetools.md)
- [Console-based command-line tools for XBOX](/tools/tools-console/console_commandlinetools/index.md)
- [Streaming page (Dev Home)](/tools/tools-console/devhome/devhome-streaming.md)
- [packageutil.exe](/build/core-features/common/packaging/deployment/packageutil.md)