4K/UHD Rendering

By default, Supra renders content at the same resolution that the client device's browser reports — typically Full HD (1920x1080) due to limitations in platform/vendor manufacturer software. You can override this to enable 4K/UHD rendering.

How It Works

Since Supra renders content on the server and streams it as a video to client devices, you can take advantage of the same high-resolution video playback capabilities that devices use for regular video content. Even if a device browser is limited to 1080p, its video decoder may support 4K.

Enabling 4K/UHD Rendering

To activate 4K/UHD rendering for an applet, add the supraDsn configuration field alongside supra: enabled in the applet timing configuration:

Configuration Key	Value	Description
supra	enabled	Activates Supra mode (required)
supraDsn	?forceScreenSize=3840x2160	Forces 4K/UHD resolution rendering

Setting via Box

1. Navigate to the client device's detail page in Box.
2. Open the Applets tab.
3. Ensure the Supra toggle is enabled for the target applet.
4. Add the supraDsn configuration key with the value ?forceScreenSize=3840x2160 to the applet's timing configuration.

Setting via API

When creating or updating a timing via the signageOS REST API, include the supraDsn field in the configuration:

{
	"configuration": {
		"supra": "enabled",
		"supraDsn": "?forceScreenSize=3840x2160"
	}
}

What Happens After Configuration

1. The client device detects the configuration change.
2. The Supra Server rescales content to the configured resolution (3840x2160).
3. The Supra Screen applet renders the streamed content at 4K/UHD.
4. Wait up to 1 minute for the content to display in the new resolution.

No additional actions are required.

Other Resolutions

The forceScreenSize parameter supports any resolution in WIDTHxHEIGHT format:

Resolution	Value	Notes
Full HD	1920x1080	Default on most devices
QHD	2560x1440	Requires capable display hardware
4K/UHD	3840x2160	Requires capable display hardware
Custom	WIDTHxHEIGHT	Any resolution supported by the Supra Server

Performance Considerations

Higher resolutions increase the CPU and bandwidth requirements on the Supra Server. If 4K/UHD is not required, keeping the default 1920x1080 saves server resources.

Related Topics

• Monitoring — Monitor Supra Server performance and resource usage