VideoConfiguration

Additional configuration for video playback.

Properties

• enable_hardware_acceleration(bool) –

  Whether to enable hardware acceleration.

• hardware_decoding_api(str | None) –

  Sets the --hwdec

• height(Number | None) –

  The fixed height for the video output.

• output_driver(str | None) –

  Sets the --vo property

• scale(Number) –

  The scale for the video output.

• width(Number | None) –

  The fixed width for the video output.

Properties

enable_hardware_acceleration

enable_hardware_acceleration: bool = True

Whether to enable hardware acceleration. When disabled, may cause battery drain, device heating, and high CPU usage.

hardware_decoding_api

hardware_decoding_api: str | None = None

Sets the --hwdec property on native backend.

The default value is platform dependent

• Windows, GNU/Linux, macOS & iOS : "auto"
• Android: "auto-safe"

height

height: Number | None = None

The fixed height for the video output.

output_driver

output_driver: str | None = None

Sets the --vo property on native backend.

The default value is platform dependent

• Windows, GNU/Linux, macOS & iOS : "libmpv"
• Android: "gpu"

scale

scale: Number = 1.0

The scale for the video output. Specifying this option will cause width & height to be ignored.

width

width: Number | None = None

The fixed width for the video output.