@admonition{ Host authority | @htmlonly
By providing the host authority (URI + port), you can easily open each configuration option in the config UI.
Host authority:
@endhtmlonly
}
Sunshine will work with the default settings for most users. In some cases you may want to configure Sunshine further.
The default location for the configuration file is listed below. You can use another location if you
choose, by passing in the full configuration file path as the first argument when you start Sunshine.
Example
sunshine~/sunshine_config.conf
The default location of the apps.json is the same as the configuration file. You can use a custom
location by modifying the configuration file.
Default Config Directory
OS
Location
Docker
@code{}/config@endcode
FreeBSD
@code{}~/.config/sunshine@endcode
Linux
@code{}~/.config/sunshine@endcode
macOS
@code{}~/.config/sunshine@endcode
Windows
@code{}%ProgramFiles%\Sunshine\config@endcode
Although it is recommended to use the configuration UI, it is possible manually configure Sunshine by
editing the conf file in a text editor. Use the examples as reference.
Interval in seconds between automatic checks for new Sunshine releases. Set to 0 to disable periodic checking.
Checks are date-based: Sunshine compares its build date to the latest release (and pre-releases if enabled) and notifies when a newer build is available.
Allow Select/Back inputs to also trigger DS4 touchpad click. Useful for clients looking to
emulate touchpad click on Xinput devices.
@hint{Only applies when gamepad is set to ds4 manually. Unused in other gamepad modes.}
If the Back/Select button is held down for the specified number of milliseconds,
a Home/Guide button press is emulated.
@tip{If back_button_timeout < 0, then the Home/Guide button will not be emulated.}
Sending scancodes enhances compatibility with games and apps but may result in incorrect keyboard input
from certain clients that aren't using a US English keyboard layout.
Enable if keyboard input is not working at all in certain applications.
Disable if keys on the client are generating the wrong input on the host.
@caution{Applies to Windows only.}
It may be possible that you cannot send the Windows Key from Moonlight directly. In those cases it may be useful to
make Sunshine think the Right Alt key is the Windows key.
When enabled, Sunshine will pass through high resolution scroll events from Moonlight clients.
This can be useful to disable for older applications that scroll too fast with high resolution scroll
events.
When enabled, Sunshine will pass through native pen/touch events from Moonlight clients.
This can be useful to disable for older applications without native pen/touch support.
Sometimes it may be useful to map keybindings. Wayland won't allow clients to capture the Win Key
for example.
@tip{See [virtual key codes](https://docs.microsoft.com/en-us/windows/win32/inputdev/virtual-key-codes)}
@hint{keybindings needs to have a multiple of two elements.}
@note{This option is not available in the UI. A PR would be welcome.}
**FreeBSD/Linux + pipewire:**
@code{}
pactl info | grep Source
# in some causes you'd need to use the `Sink` device, if `Source` doesn't work, so try:
pactl info | grep Sink
@endcode
**macOS:**
Sunshine can only access microphones on macOS due to system limitations.
To stream system audio use
[Soundflower](https://github.com/mattingalls/Soundflower) or
[BlackHole](https://github.com/ExistentialAudio/BlackHole).
**Windows:**
Enter the following command in command prompt or PowerShell.
@code{}
%ProgramFiles%\Sunshine\tools\audio-info.exe
@endcode
If you have multiple audio devices with identical names, use the Device ID instead.
}
@attention{If you want to mute the host speakers, use
[virtual_sink](#virtual_sink) instead.}
The audio device that's virtual, like Steam Streaming Speakers. This allows Sunshine to stream audio,
while muting the speakers.
@tip{See [audio_sink](#audio_sink)!}
@tip{These are some options for virtual sound devices.
* Stream Streaming Speakers (Linux, macOS, Windows)
* Steam must be installed.
* Enable [install_steam_audio_drivers](#install_steam_audio_drivers)
or use Steam Remote Play at least once to install the drivers.
* [Virtual Audio Cable](https://vb-audio.com/Cable) (macOS, Windows)
}
Installs the Steam Streaming Speakers driver (if Steam is installed) to support surround sound and muting
host audio.
@note{This option is only supported on Windows.}
Select the video card you want to stream.
@tip{To find the appropriate values follow these instructions.
**FreeBSD/Linux + VA-API:**
Unlike with *amdvce* and *nvenc*, it doesn't matter if video encoding is done on a different GPU.
@code{}
ls /dev/dri/renderD* # to find all devices capable of VAAPI
# replace ``renderD129`` with the device from above to list the name and capabilities of the device
vainfo --display drm --device /dev/dri/renderD129 | \
grep -E "((VAProfileH264High|VAProfileHEVCMain|VAProfileHEVCMain10).*VAEntrypointEncSlice)|Driver version"
@endcode
To be supported by Sunshine, it needs to have at the very minimum:
`VAProfileH264High : VAEntrypointEncSlice`
**Windows:**
Enter the following command in command prompt or PowerShell.
@code{}
%ProgramFiles%\Sunshine\tools\dxgi-info.exe
@endcode
For hybrid graphics systems, DXGI reports the outputs are connected to whichever graphics
adapter that the application is configured to use, so it's not a reliable indicator of how the
display is physically connected.
}
Select the display number you want to stream.
@tip{To find the appropriate values follow these instructions.
**FreeBSD/Linux:**
During Sunshine startup, you should see the list of detected displays:
@code{}
Info: Detecting displays
Info: Detected display: DVI-D-0 (id: 0) connected: false
Info: Detected display: HDMI-0 (id: 1) connected: true
Info: Detected display: DP-0 (id: 2) connected: true
Info: Detected display: DP-1 (id: 3) connected: false
Info: Detected display: DVI-D-1 (id: 4) connected: false
@endcode
You need to use the id value inside the parenthesis, e.g. `1`.
**macOS:**
During Sunshine startup, you should see the list of detected displays:
@code{}
Info: Detecting displays
Info: Detected display: Monitor-0 (id: 3) connected: true
Info: Detected display: Monitor-1 (id: 2) connected: true
@endcode
You need to use the id value inside the parenthesis, e.g. `3`.
**Windows:**
During Sunshine startup, you should see the list of detected displays:
@code{}
Info: Currently available display devices:
[
{
"device_id": "{64243705-4020-5895-b923-adc862c3457e}",
"display_name": "",
"friendly_name": "IDD HDR",
"info": null
},
{
"device_id": "{77f67f3e-754f-5d31-af64-ee037e18100a}",
"display_name": "",
"friendly_name": "SunshineHDR",
"info": null
},
{
"device_id": "{daeac860-f4db-5208-b1f5-cf59444fb768}",
"display_name": "\\\\.\\DISPLAY1",
"friendly_name": "ROG PG279Q",
"info": {
"hdr_state": null,
"origin_point": {
"x": 0,
"y": 0
},
"primary": true,
"refresh_rate": {
"type": "rational",
"value": {
"denominator": 1000,
"numerator": 119998
}
},
"resolution": {
"height": 1440,
"width": 2560
},
"resolution_scale": {
"type": "rational",
"value": {
"denominator": 100,
"numerator": 100
}
}
}
}
]
@endcode
You need to use the `device_id` value.
}
Select which display Sunshine should prepare before streaming. When set to one of the virtual options, Sunshine will manage a Sudovda virtual display instead of relying on your physical monitor.
Default
@code{}
disabled
@endcode
Example
@code{}
virtual_display_mode = shared
@endcode
Choices
disabled
Use the physical display selected via output_name.
per_client
Create a dedicated virtual display per client connection.
shared
Reuse a single virtual display for all clients. Faster reconnects, but only one virtual layout is maintained.
Perform additional resolution configuration for the display device.
@note{"Optimize game settings" must be enabled in Moonlight for this option to work.}
@note{Applies to Windows only.}
Default
@code{}auto@endcode
Example
@code{}
dd_resolution_option = manual
@endcode
Choices
disabled
Perform no additional configuration.
auto
Change resolution to the requested resolution from the client.
manual
Change resolution to the user specified one (set via [dd_manual_resolution](#dd_manual_resolution)).
Perform additional refresh rate configuration for the display device.
@note{Applies to Windows only.}
Default
@code{}auto@endcode
Example
@code{}
dd_refresh_rate_option = manual
@endcode
Choices
disabled
Perform no additional configuration.
auto
Change refresh rate to the requested FPS value from the client.
manual
Change refresh rate to the user specified one (set via [dd_manual_refresh_rate](#dd_manual_refresh_rate)).
prefer_highest
Prefer the highest available refresh rate for the selected resolution. Recommended when using a virtual display + RTSS to minimize VSYNC engagement on hosts with global VSYNC enabled and G-SYNC with ULLM.
Specify manual refresh rate to be used.
@note{[dd_refresh_rate_option](#dd_refresh_rate_option) must be set to `manual`}
@note{Applies to Windows only.}
Additional delay in milliseconds to wait before reverting configuration when the app has been closed or the last session terminated.
Main purpose is to provide a smoother transition when quickly switching between apps.
@note{Applies to Windows only.}
When enabled, display configuration is reverted upon disconnect of all clients instead of app close or last session termination.
This can be useful for returning to physical usage of the host machine without closing the active app.
@warning{Some applications may not function properly when display configuration is changed while active.}
@note{Applies to Windows only.}
Comma-separated list or JSON array of display device identifiers to ignore when saving display snapshots.
Excluded devices are removed from session and golden snapshots so Sunshine will not restore to transient or dummy displays.
@note{Applies to Windows only.}
Keep at least one display unexcluded so snapshots remain valid.
Device IDs accept the GUID reported by `/api/display-devices` (preferred) or the `\\.\DISPLAYX` name.
Ideal when using both a virtual display and a physical dummy plug so restores skip the dummy plug.
Keyboard shortcut key that restores the display snapshot and tears down any virtual displays.
Useful for forcing virtual displays off and restoring snapshots when Sunshine is paused or stuck.
The modifier keys for this hotkey are configured separately via dd_snapshot_restore_hotkey_modifiers.
Accepts function keys (F1-F24), letters, digits, or a virtual-key code.
@note{Applies to Windows only.}
Modifier keys for the snapshot restore hotkey.
Accepts a delimiter-separated list (e.g., ctrl+alt+shift, ctrl|shift, win, none).
Supported tokens: ctrl/control, alt, shift, win/windows/meta, none/off/disabled.
@note{Applies to Windows only.}
When enabled, Sunshine activates the virtual display driver and makes it the only active display during stream startup.
@note{Applies to Windows only.}
Remap the requested resolution and FPS to another display mode.
Depending on the [dd_resolution_option](#dd_resolution_option) and
[dd_refresh_rate_option](#dd_refresh_rate_option) values, the following mapping
groups are available:
`mixed` - both options are set to `auto`.
`resolution_only` - only [dd_resolution_option](#dd_resolution_option) is set to `auto`.
`refresh_rate_only` - only [dd_refresh_rate_option](#dd_refresh_rate_option) is set to `auto`.
For each of those groups, a list of fields can be configured to perform remapping:
`requested_resolution` - resolution that needs to be matched in order to use this remapping entry.
`requested_fps` - FPS that needs to be matched in order to use this remapping entry.
`final_resolution` - resolution value to be used if the entry was matched.
`final_refresh_rate` - refresh rate value to be used if the entry was matched.
If `requested_*` field is left empty, it will match everything.
If `final_*` field is left empty, the original value will not be remapped and either a requested, manual
or current value is used. However, at least one `final_*` must be set, otherwise the entry is considered
invalid.
@note{"Optimize game settings" must be enabled on client side for ANY entry with `resolution`
field to be considered.}
@note{First entry to be matched in the list is the one that will be used.}
@tip{`requested_resolution` and `final_resolution` can be omitted for `refresh_rate_only` group.}
@tip{`requested_fps` and `final_refresh_rate` can be omitted for `resolution_only` group.}
@note{Applies to Windows only.}
When using Sunshine's virtual display driver, create and set the virtual monitor to double the target refresh rate to avoid unexplained FPS drops seen on virtual screens.
Disable only if a specific game or virtual monitor behaves incorrectly with the doubled refresh.
@note{Applies to Windows virtual displays only.}
Forces Windows to run the capture output at 30 Hz with HDR enabled so physical HDMI dummy plugs expose 10-bit colour.
Sunshine also keeps the "Disable VSYNC" override engaged to ensure the driver profile disables VSYNC during streams.
Default
@code{}false@endcode
Example
@code{}
dd_wa_dummy_plug_hdr10 = true
@endcode
Notes
Only enable this when using a physical dummy plug that needs the 10-bit HDR workaround.
The workaround applies to directly launched applications only; Desktop streams keep their normal refresh rate so everyday use remains smooth.
See the @hyperlink{https://github.com/Nonary/documentation/wiki/DummyPlugs#enabling-10-bit-color-on-dummy-plugs-at-high-resolutions}{Dummy Plugs guide} for full setup details.
Sunshine tries to save bandwidth when content on screen is static or a low framerate. Because many clients expect a constant stream of video frames, a certain amount of duplicate frames are sent when this happens. This setting controls the lowest effective framerate a stream can reach.
Default
@code{}
0
@endcode
Choices
0
Use half the stream's FPS as the minimum target.
1-1000
Specify your own value. The real minimum may differ from this value.
Set the IP address to bind Sunshine to. This is useful when you have multiple network interfaces
and want to restrict Sunshine to a specific one. If not set, Sunshine will bind to all available
interfaces (0.0.0.0 for IPv4 or :: for IPv6).
Note: The address must be valid for the system and must match the address family
being used. When using IPv6, you can specify an IPv6 address even with address_family set to "both".
This determines when encryption will be used when streaming over your local network.
@warning{Encryption can reduce streaming performance, particularly on less powerful hosts and clients.}
Default
@code{}
0
@endcode
Example
@code{}
lan_encryption_mode = 0
@endcode
Choices
0
encryption will not be used
1
encryption will be used if the client supports it
2
encryption is mandatory and unencrypted connections are rejected
This determines when encryption will be used when streaming over the Internet.
@warning{Encryption can reduce streaming performance, particularly on less powerful hosts and clients.}
Default
@code{}
1
@endcode
Example
@code{}
wan_encryption_mode = 1
@endcode
Choices
0
encryption will not be used
1
encryption will be used if the client supports it
2
encryption is mandatory and unencrypted connections are rejected
Maximum size in KiB for each outgoing video send batch.
The default is 64 KiB.
Lower values can improve stream stability on cheaper switches, routers, and Wi-Fi hardware by reducing burst size,
but at the cost of less than 1 ms of additional host-side delay.
Determines where Sunshine stores log sessions. When this value points to a file (the default),
Sunshine keeps a rolling logs folder next to that file and keeps the last 30 sessions,
each capped at about 10 MiB by rolling ~2MB log files. Pointing to a directory stores the
logs folder at the specified location.
The private key used for the web UI and Moonlight client pairing. For best compatibility,
this should be an RSA-2048 private key.
@warning{Not all Moonlight clients support ECDSA keys or RSA key lengths other than 2048 bits.}
The certificate used for the web UI and Moonlight client pairing. For best compatibility,
this should have an RSA-2048 public key.
@warning{Not all Moonlight clients support ECDSA keys or RSA key lengths other than 2048 bits.}
The file used by new LuminalShine features to persist web authentication tokens and notification state.
If left unset, it defaults to luminalshine_state.json in the same directory as other Sunshine data.
Percentage of error correcting packets per data packet in each video frame.
@warning{Higher values can correct for more network packet loss,
but at the cost of increasing bandwidth usage.}
Quantization Parameter. Some devices don't support Constant Bit Rate. For those devices, QP is used instead.
@warning{Higher value means more compression, but less quality.}
Minimum number of CPU threads used for encoding.
@note{Increasing the value slightly reduces encoding efficiency, but the tradeoff is usually worth it to
gain the use of more CPU cores for encoding. The ideal value is the lowest value that can reliably encode
at your desired streaming settings on your hardware.}
Allows the client to request HEVC Main or HEVC Main10 video streams.
@warning{HEVC is more CPU-intensive to encode, so enabling this may reduce performance when using software
encoding.}
Default
@code{}
0
@endcode
Example
@code{}
hevc_mode = 2
@endcode
Choices
0
advertise support for HEVC based on encoder capabilities (recommended)
1
do not advertise support for HEVC
2
advertise support for HEVC Main profile
3
advertise support for HEVC Main and Main10 (HDR) profiles
Allows the client to request AV1 Main 8-bit or 10-bit video streams.
@warning{AV1 is more CPU-intensive to encode, so enabling this may reduce performance when using software
encoding.}
Default
@code{}
0
@endcode
Example
@code{}
av1_mode = 2
@endcode
Choices
0
advertise support for AV1 based on encoder capabilities (recommended)
1
do not advertise support for AV1
2
advertise support for AV1 Main 8-bit profile
3
advertise support for AV1 Main 8-bit and 10-bit (HDR) profiles
Capture and encode SDR sessions in 10-bit when the client and encoder negotiate HEVC/AV1 Main10 support.
@note{HDR stays disabled.}
@note{Applies to HEVC or AV1 only; H.264 streaming remains 8-bit.}
@warning{May cause crashes on client devices with older GPUs that don't support HEVC 10-bit decoding.}
Automatic
Sunshine will use the first capture method available in the order of the table below
Example
@code{}
capture = kms
@endcode
Choices
nvfbc
Use NVIDIA Frame Buffer Capture to capture direct to GPU memory. This is usually the fastest method for
NVIDIA cards. NvFBC does not have native Wayland support and does not work with XWayland.
@note{Applies to Linux only.}
wlr
Capture for wlroots based Wayland compositors via wlr-screencopy-unstable-v1. It is possible to capture
virtual displays in e.g. Hyprland using this method.
@note{Applies to Linux only.}
kms
DRM/KMS screen capture from the kernel. This requires that Sunshine has `cap_sys_admin` capability.
@note{Applies to Linux only.}
x11
Uses XCB. This is the slowest and most CPU intensive so should be avoided if possible.
@note{Applies to FreeBSD and Linux only.}
ddx
Use DirectX Desktop Duplication API to capture the display. This is well-supported on Windows machines.
@note{Applies to Windows only.}
wgc
Use Windows.Graphics.Capture to capture the display. Captures at a variable rate.
@note{Windows only.}
@note{NVIDIA Ultra Low Latency Mode (ULLM) can hurt performance; avoid this by either using a monitor whose refresh rate exceeds the stream and capping FPS to stop ULLM from engaging, or simply disable Low Latency Mode in the driver.}
@tip{On NVIDIA cards, selecting this option will resolve stream freezes caused by high VRAM utilization.}
wgcc
Use Windows.Graphics.Capture to capture the display. Captures at a constant rate.
@note{Windows only.}
@note{NVIDIA Ultra Low Latency Mode (ULLM) can hurt performance; avoid this by either using a monitor whose refresh rate exceeds the stream and capping FPS to stop ULLM from engaging, or simply disable Low Latency Mode in the driver.}
@tip{On NVIDIA cards, selecting this option will resolve stream freezes caused by high VRAM utilization.}
Path to the LosslessScaling.exe executable used for frame generation or upscaling.
If empty, Sunshine will attempt to auto-detect common installation locations.
@note{Applies to Windows only.}
These options integrate with Windows tooling to manage frame pacing and related behavior during a stream.
They appear in the Frame Limiter section of the settings UI.
Forces the NVIDIA driver VSYNC setting to Off for the Sunshine profile while streaming. Sunshine restores the previous VSYNC setting when streaming stops.
Use this when you globally enable VSYNC in the driver but need Sunshine sessions to run without it. This option no longer changes Ultra Low Latency Mode or pre-rendered frames.
When NVIDIA-specific overrides are unavailable, Sunshine falls back to forcing the active display to its highest available refresh rate during streams to minimize VSYNC engagement.
Notes:
Windows only; uses NVIDIA NvAPI overrides when available and relies on the Sunshine display helper for refresh-rate fallbacks.
Automatically enabled when the Dummy Plug HDR workaround is active.
On non-NVIDIA GPUs, the refresh-rate fallback acts as a best-effort VSYNC mitigation.
@note{Legacy configurations may still use @code{rtss_disable_vsync_ullm}. Sunshine continues to accept the old key and maps it to @code{frame_limiter_disable_vsync}.}
NVENC encoder performance preset.
Higher numbers improve compression (quality at given bitrate) at the cost of increased encoding latency.
Recommended to change only when limited by network or decoder, otherwise similar effect can be accomplished
by increasing bitrate.
@note{This option only applies when using NVENC [encoder](#encoder).}
Enable two-pass mode in NVENC encoder.
This allows to detect more motion vectors, better distribute bitrate across the frame and more strictly
adhere to bitrate limits. Disabling it is not recommended since this can lead to occasional bitrate
overshoot and subsequent packet loss.
@note{This option only applies when using NVENC [encoder](#encoder).}
Default
@code{}
quarter_res
@endcode
Example
@code{}
nvenc_twopass = quarter_res
@endcode
Choices
disabled
One pass (fastest)
quarter_res
Two passes, first pass at quarter resolution (faster)
full_res
Two passes, first pass at full resolution (slower)
Assign higher QP values to flat regions of the video.
Recommended to enable when streaming at lower bitrates.
@note{This option only applies when using NVENC [encoder](#encoder).}
@warning{Enabling this option may reduce performance.}
Single-frame VBV/HRD percentage increase.
By default Sunshine uses single-frame VBV/HRD, which means any encoded video frame size is not expected to
exceed requested bitrate divided by requested frame rate. Relaxing this restriction can be beneficial and
act as low-latency variable bitrate, but may also lead to packet loss if the network doesn't have buffer
headroom to handle bitrate spikes. Maximum accepted value is 400, which corresponds to 5x increased
encoded video frame upper size limit.
@note{This option only applies when using NVENC [encoder](#encoder).}
@warning{Can lead to network packet loss.}
Controls NVENC split-frame encoding for supported HEVC or AV1 sessions.
NVIDIA drivers already enable split-frame encoding automatically for many 4K-and-above workloads.
Set this to enabled when you want the same behavior at lower resolutions too, such as 2560x1440 at 120 Hz.
Set it to disabled to prevent split-frame encoding even when the driver would normally use it automatically.
@note{Applies to NVENC HEVC or AV1 only. H.264 does not use split-frame encoding.}
@note{Requires NVENC API 12.1 or newer.}
Use realtime gpu scheduling priority in NVENC when hardware accelerated gpu scheduling (HAGS) is enabled
in Windows. Currently, NVIDIA drivers may freeze in encoder when HAGS is enabled, realtime priority is used
and VRAM utilization is close to maximum. Disabling this option lowers the priority to high, sidestepping
the freeze at the cost of reduced capture performance when the GPU is heavily loaded.
@note{This option only applies when using NVENC [encoder](#encoder).}
@note{Applies to Windows only.}
@tip{Changing the capture method to Windows.Graphics.Capture also resolves this problem without any additional changes.}
Adaptive P-State algorithm which NVIDIA drivers employ doesn't work well with low latency streaming,
so Sunshine requests high power mode explicitly.
@note{This option only applies when using NVENC [encoder](#encoder).}
@warning{Disabling this is not recommended since this can lead to significantly increased encoding latency.}
@note{Applies to Windows only.}
Sunshine can't capture fullscreen OpenGL and Vulkan programs at full frame rate unless they present on
top of DXGI. With this option enabled Sunshine changes global Vulkan/OpenGL present method to
"Prefer layered on DXGI Swapchain". This is system-wide setting that is reverted on Sunshine program exit.
@note{This option only applies when using NVENC [encoder](#encoder).}
@note{Applies to Windows only.}
Prefer CAVLC entropy coding over CABAC in H.264 when using NVENC.
CAVLC is outdated and needs around 10% more bitrate for same quality, but provides slightly faster
decoding when using software decoder.
@note{This option only applies when using H.264 format with the
NVENC [encoder](#encoder).}
This options enables use of HEVC on older Intel GPUs that only support low power encoding for H.264.
@note{This option only applies when using quicksync [encoder](#encoder).}
@caution{Streaming performance may be significantly reduced when this option is enabled.}
The encoder usage profile is used to set the base set of encoding parameters.
@note{This option only applies when using amdvce [encoder](#encoder).}
@note{The other AMF options that follow will override a subset of the settings applied by your usage
profile, but there are hidden parameters set in usage profiles that cannot be overridden elsewhere.}
The encoder rate control.
@note{This option only applies when using amdvce [encoder](#encoder).}
@warning{The `vbr_latency` option generally works best, but some bitrate overshoots may still occur.
Enabling HRD allows all bitrate based rate controls to better constrain peak bitrate, but may result in
encoding artifacts depending on your card.}
Enable Hypothetical Reference Decoder (HRD) enforcement to help constrain the target bitrate.
@note{This option only applies when using amdvce [encoder](#encoder).}
@warning{HRD is known to cause encoding artifacts or negatively affect encoding quality on certain cards.}
The quality profile controls the tradeoff between speed and quality of encoding.
@note{This option only applies when using amdvce [encoder](#encoder).}
Variance Based Adaptive Quantization (VBAQ) can increase subjective visual quality by prioritizing
allocation of more bits to smooth areas compared to more textured areas.
@note{This option only applies when using amdvce [encoder](#encoder).}
Realtime encoding.
@note{This option only applies when using macOS.}
@warning{Disabling realtime encoding might result in a delayed frame encoding or frame drop.}
Enabling this option can avoid dropped frames over the network during scene changes, but video quality may
be reduced during motion.
@note{This option only applies for H.264 and HEVC when using VA-API [encoder](#encoder) on AMD GPUs.}
The encoder preset to use.
@note{This option only applies when using software [encoder](#encoder).}
@note{From [FFmpeg](https://trac.ffmpeg.org/wiki/Encode/H.264#preset).
A preset is a collection of options that will provide a certain encoding speed to compression ratio. A slower
preset will provide better compression (compression is quality per filesize). This means that, for example, if
you target a certain file size or constant bit rate, you will achieve better quality with a slower preset.
Similarly, for constant quality encoding, you will simply save bitrate by choosing a slower preset.
Use the slowest preset that you have patience for.}
The tuning preset to use.
@note{This option only applies when using software [encoder](#encoder).}
@note{From [FFmpeg](https://trac.ffmpeg.org/wiki/Encode/H.264#preset).
You can optionally use -tune to change settings based upon the specifics of your input.
}
Default
@code{}
zerolatency
@endcode
Example
@code{}
sw_tune = zerolatency
@endcode
Choices
film
use for high quality movie content; lowers deblocking
animation
good for cartoons; uses higher deblocking and more reference frames
grain
preserves the grain structure in old, grainy film material
stillimage
good for slideshow-like content
fastdecode
allows faster decoding by disabling certain filters
Controls whether Sunshine removes auto-synced games when they are uninstalled in Playnite.
Set to true to drop entries immediately when Playnite reports them as uninstalled.
List of Playnite library plugin IDs whose installed games should always be auto-synced.
Accepts a JSON array of objects with id/name pairs or a comma-separated list of plugin IDs.
Any installed game originating from the listed plugins is included even if it is not in the recent list.
List of Playnite categories to omit from Sunshine's auto-sync. Accepts a JSON array of objects
with id/name pairs or a comma-separated list of category names. Any
game tagged with one of these categories is skipped even if it matches recent-activity or
inclusion-category rules.