> **Experimental**
>
> `@aws-cdk/aws-medialive-alpha` is an [**experimental**](/stability) (alpha) package: its API may change in any release, without a major version bump.
# VideoSelectorSettings

Video selector settings for an input.

- Stability: [Experimental](/cdk/api/stability.html)
- Source: [`lib/video-selection.ts`](https://github.com/aws/aws-cdk/blob/v2.275.0-alpha.0/packages/@aws-cdk/aws-medialive-alpha/lib/video-selection.ts#L114)

## Example

```ts
declare const stack: Stack;
declare const input: medialive.IInput;
declare const bucket: s3.IBucket;
declare const video: medialive.EncodeConfiguration;

new medialive.Channel(stack, 'Channel', {
  inputs: [{
    input,
    audioSelectors: [
      medialive.AudioSelector.byLanguage('eng', 'eng', medialive.AudioLanguageSelectionPolicy.STRICT),
    ],
    captionSelectors: [
      medialive.CaptionSelector.embedded('embedded'),
    ],
    videoSelector: {
      colorSpace: medialive.VideoColorSpace.HDR10,
      colorSpaceUsage: medialive.VideoColorSpaceUsage.FORCE,
      selectBy: medialive.VideoSelection.byProgramId(1),
    },
  }],
  outputGroups: [
    medialive.OutputGroupConfiguration.hls({
      name: 'hls',
      destinations: [medialive.OutputDestination.toBucket(bucket, 'live/stream')],
      outputs: [{ encodes: [video], outputName: 'hls_out' }],
    }),
  ],
});
```

## Properties

- `colorSpace`: [VideoColorSpace](/cdk/api/v2/docs/@aws-cdk_aws-medialive-alpha.VideoColorSpace.html) — The color space of the input video.

  **Default:** service default

- `colorSpaceUsage`: [VideoColorSpaceUsage](/cdk/api/v2/docs/@aws-cdk_aws-medialive-alpha.VideoColorSpaceUsage.html) — How `colorSpace` is applied when it is not `FOLLOW`.

  **Default:** MediaLive service default

- `hdr10`: [Hdr10Settings](/cdk/api/v2/docs/@aws-cdk_aws-medialive-alpha.Hdr10Settings.html) = none — HDR10 color space metadata for the input.

- `selectBy`: [VideoSelection](/cdk/api/v2/docs/@aws-cdk_aws-medialive-alpha.VideoSelection.html) — Selects the specific video to extract from the input (by PID or by program).

  **Default:** MediaLive selects the video automatically