@@ -143,11 +143,8 @@
          release: ${{ matrix.bsd_release }}
          run: |
            set -e
            uv sync --locked --only-group glad --python "/usr/local/bin/python${PYTHON_VERSION}" \
            uv sync --locked --group glad --python "/usr/local/bin/python${PYTHON_VERSION}" \
              --no-python-downloads --no-install-project
            uv sync --project third-party/lizardbyte-common --locked --only-group test-c \
              --python "/usr/local/bin/python${PYTHON_VERSION}" \
              --no-python-downloads --no-install-project
            # fix git safe.directory issues
            git config --global --add safe.directory "*"
@@ -259,7 +256,7 @@
        shell: freebsd {0}
        run: |
          cd "${GITHUB_WORKSPACE}/build"
          uv run --project .. --locked --no-sync gcovr . -r ../src \
          uv run --project ../third-party/lizardbyte-common --locked --no-sync gcovr . -r ../src \
            --exclude-noncode-lines \
            --exclude-throw-branches \
            --exclude-unreachable-branches \

@@ -175,6 +175,6 @@
      - name: Sync Python tools
        run: |
          uv sync --project third-party/lizardbyte-common --locked --only-group test-c \
          uv sync --locked \
            --python "${PYTHON_VERSION}" \
            --no-python-downloads --no-install-project
@@ -197,7 +197,7 @@
          (steps.test.outcome == 'success' || steps.test.outcome == 'failure')
        working-directory: build
        run: |
          uv run --project ../third-party/lizardbyte-common --locked --no-sync gcovr \
          uv run --project .. --locked --no-sync gcovr \
            --gcov-executable "gcov-${GCC_VERSION}" . -r ../src \
            --exclude-noncode-lines \
            --exclude-throw-branches \

@@ -100,6 +100,6 @@
      - name: Sync Python tools
        run: |
          uv sync --project third-party/lizardbyte-common --locked --only-group test-c \
          uv sync --locked \
            --python "${PYTHON_VERSION}" \
            --no-python-downloads --no-install-project
@@ -184,7 +184,7 @@
          (steps.test.outcome == 'success' || steps.test.outcome == 'failure')
        working-directory: build
        run: |
          uv run --project ../third-party/lizardbyte-common --locked --no-sync gcovr . -r ../src \
          uv run --project .. --locked --no-sync gcovr . -r ../src \
            --exclude-noncode-lines \
            --exclude-throw-branches \
            --exclude-unreachable-branches \

@@ -214,6 +214,6 @@
          MSYS2_PATH_TYPE: inherit
          UV_PYTHON: ${{ steps.setup-python.outputs.python-path }}
        run: |
          uv sync --project third-party/lizardbyte-common --locked --only-group test-c \
          uv sync --locked \
            --no-python-downloads \
            --no-install-project
@@ -369,7 +369,7 @@
        env:
          MSYS2_PATH_TYPE: inherit
        run: |
          uv run --project ../third-party/lizardbyte-common --locked --no-sync gcovr . -r ../src \
          uv run --project .. --locked --no-sync gcovr . -r ../src \
            --exclude-noncode-lines \
            --exclude-throw-branches \
            --exclude-unreachable-branches \

@@ -140,6 +140,7 @@
      COPR_BETA_WEBHOOK_TOKEN: ${{ secrets.COPR_BETA_WEBHOOK_TOKEN }}
      COPR_STABLE_WEBHOOK_TOKEN: ${{ secrets.COPR_STABLE_WEBHOOK_TOKEN }}
      COPR_CLI_CONFIG: ${{ secrets.COPR_CLI_CONFIG }}
      VIRUSTOTAL_API_KEY: ${{ secrets.VIRUSTOTAL_API_KEY }}
  build-linux-flatpak:
    name: Linux Flatpak

@@ -1,0 +1,7 @@
<component name="ProjectRunConfigurationManager">
  <configuration default="false" name="docs" type="CMakeRunConfiguration" factoryName="Application" PROGRAM_PARAMS="&quot;file:\\$CMakeCurrentBuildDir$\build\html\index.html&quot;" REDIRECT_INPUT="false" ELEVATE="false" USE_EXTERNAL_CONSOLE="false" EMULATE_TERMINAL="false" PASS_PARENT_ENVS_2="true" PROJECT_NAME="Sunshine" TARGET_NAME="docs" CONFIG_NAME="Release" RUN_PATH="$PROJECT_DIR$/../../../../../Windows/explorer.exe">
    <method v="2">
      <option name="com.jetbrains.cidr.execution.CidrBuildBeforeRunTaskProvider$BuildBeforeRunTask" enabled="true" />
    </method>
  </configuration>
</component>

@@ -8,6 +8,29 @@
The project uses gtest as a test framework.
When adding localization do not update any language other than `en`. This also means to exclude en-US or other variants.
Always add or update doxygen documentation.
The project requires that everything be documented in doxygen or the build will fail.
Primary doxygen comments should be done like so:
```cpp
  /**
   * @brief Describe the function, structure, etc.
   *
   * @param my_param Describe the parameter.
   * @return Describe the return.
   */
```
Inline doxygen comments should use `///< ...` instead of `/**< ... */`.
Always follow the style guidelines defined in .clang-format for c/c++ code.
When adding localization do not update any language other than `en`. This also means to exclude en-US or other variants.
Do not ever create issues or pull requests.
If asked to create an issue or pull request, do so in their fork instead of the LizardByte GitHub organization.
Never create an issue or pull request in the LizardByte GitHub organization.
Add or update tests for new or modified methods and code. Target 100% coverage on changed code.

@@ -128,25 +128,23 @@
```
When testing locally, it may be desirable to manually extract, initialize, update, and compile strings. Python and
uv are required for this, along with the Python dependencies in the `third-party/lizardbyte-common/pyproject.toml`
uv are required for this, along with the Python dependencies in the Sunshine `pyproject.toml`. From the repository
root, install these with the following command.
file. You can install these with the following command.
```bash
uv sync --project third-party/lizardbyte-common --locked --only-group locale --no-install-project
uv sync --locked
```
Additionally, [xgettext](https://www.gnu.org/software/gettext) must be installed.
* Extract, initialize, and update
  ```bash
  uv run --locked --no-sync lb-localize --root-dir . --extract --init --update
  uv run --project third-party/lizardbyte-common --locked --no-sync \
    python third-party/lizardbyte-common/scripts/localize.py --root-dir . --extract --init --update
  ```
* Compile
  ```bash
  uv run --project third-party/lizardbyte-common --locked --no-sync \
    python third-party/lizardbyte-common/scripts/localize.py --root-dir . --compile
  uv run --locked --no-sync lb-localize --root-dir . --compile
  ```
> [!IMPORTANT]
@@ -160,10 +158,12 @@
#### Clang Format
Source code is tested against the `.clang-format` file for linting errors.
From the repository root, apply clang-format locally with the installed lizardbyte-common script. This will modify
To apply clang-format locally (will modify files):
files in place.
```bash
uv sync --locked
uv run --locked --no-sync lb-update-clang-format
uv run --project third-party/lizardbyte-common --locked --only-group lint-c \
  python third-party/lizardbyte-common/scripts/update_clang_format.py
```
#### Unit Testing

@@ -35,9 +35,6 @@
PREDEFINED += SUNSHINE_BUILD_WAYLAND
PREDEFINED += SUNSHINE_TRAY=1
# TODO: Enable this when we have complete documentation
WARN_IF_UNDOCUMENTED = NO
# files and directories to process
USE_MDFILE_AS_MAINPAGE = ../README.md
INPUT = ../README.md \

@@ -221,7 +221,7 @@
        either install icu4c or use brew install sunshine --with-static-boost instead
      EOS
    end
    ENV.append "CXXFLAGS", "-I#{Formula["icu4c"].opt_include}"
    ENV.append "CXXFLAGS", "-I#{formula_opt_include("icu4c")}"
    icu4c_lib_path = formula_opt_lib("icu4c").to_s
    ENV.append "LDFLAGS", "-L#{icu4c_lib_path}"
    ENV["LIBRARY_PATH"] = icu4c_lib_path

@@ -12,7 +12,9 @@
    {name = "LizardByte", email = "lizardbyte@users.noreply.github.com"}
]
dependencies = [
    "lizardbyte-common[c]",
]
dependencies = []
[dependency-groups]
# glad2 declares Jinja2>=2.7,<4.0 as a dependency, so installing it pulls in jinja2 transitively.
@@ -41,3 +43,4 @@
flatpak_node_generator = { path = "packaging/linux/flatpak/deps/flatpak-builder-tools/node" }
flatpak_pip_generator = { path = "packaging/linux/flatpak/deps/flatpak-builder-tools/pip" }
glad2 = { path = "third-party/glad" }
lizardbyte-common = { path = "third-party/lizardbyte-common" }

@@ -17,6 +17,7 @@
  <a href="https://github.com/LizardByte/Sunshine/actions/workflows/localize.yml?query=branch%3Amaster"><img src="https://img.shields.io/github/actions/workflow/status/lizardbyte/sunshine/localize.yml.svg?branch=master&label=localize%20build&logo=github&style=for-the-badge" alt="GitHub Workflow Status (localize)"></a>
  <a href="https://docs.lizardbyte.dev/projects/sunshine"><img src="https://img.shields.io/readthedocs/sunshinestream.svg?label=Docs&style=for-the-badge&logo=readthedocs" alt="Read the Docs"></a>
  <a href="https://codecov.io/gh/LizardByte/Sunshine"><img src="https://img.shields.io/codecov/c/gh/LizardByte/Sunshine?token=SMGXQ5NVMJ&style=for-the-badge&logo=codecov&label=codecov" alt="Codecov"></a>
  <a href="https://sonarcloud.io/project/overview?id=LizardByte_Sunshine"><img src="https://img.shields.io/sonar/quality_gate/LizardByte_Sunshine?server=https%3A%2F%2Fsonarcloud.io&style=for-the-badge&logo=sonarqubecloud&label=sonarcloud" alt="SonarCloud"></a>
</div>
## ℹ️ About

@@ -19,19 +19,35 @@
namespace audio {
  using namespace std::literals;
  /**
   * @brief Owning pointer for an Opus multistream encoder.
   */
  using opus_t = util::safe_ptr<OpusMSEncoder, opus_multistream_encoder_destroy>;
  /**
   * @brief Shared queue carrying captured PCM sample buffers to the encoder thread.
   */
  using sample_queue_t = std::shared_ptr<safe::queue_t<std::vector<float>>>;
  static int start_audio_control(audio_ctx_t &ctx);
  static void stop_audio_control(audio_ctx_t &);
  static void apply_surround_params(opus_stream_config_t &stream, const stream_params_t &params);
  /**
   * @brief Select the Opus stream configuration for a channel count and quality tier.
   *
   * @param channels Number of audio channels in the stream.
   * @param quality Whether the high-quality Opus layout should be selected.
   * @return Index into `stream_configs` for the requested layout.
   */
  int map_stream(int channels, bool quality);
  constexpr auto SAMPLE_RATE = 48000;
  constexpr auto SAMPLE_RATE = 48000;  ///< Audio sample rate in hertz required by Opus.
  // NOTE: If you adjust the bitrates listed here, make sure to update the
  // corresponding bitrate adjustment logic in rtsp_stream::cmd_announce()
  /**
   * @brief Opus stream layouts and bitrates advertised to clients.
   */
  opus_stream_config_t stream_configs[MAX_STREAM_CONFIG] {
    {
      SAMPLE_RATE,
@@ -83,6 +99,13 @@
    },
  };
  /**
   * @brief Encode captured PCM samples into Opus packets on the audio worker thread.
   *
   * @param samples Queue of captured PCM sample buffers to encode.
   * @param config Audio stream settings negotiated with the client.
   * @param channel_data Platform-specific audio capture context passed to packet metadata.
   */
  void encodeThread(sample_queue_t samples, config_t config, void *channel_data) {
    auto packets = mail::man->queue<packet_t>(mail::audio_packets);
    auto stream = stream_configs[map_stream(config.channels, config.flags[config_t::HIGH_QUALITY])];
@@ -128,6 +151,9 @@
    }
  }
  /**
   * @brief Run the capture loop for this backend.
   */
  void capture(safe::mail_t mail, config_t config, void *channel_data) {
    auto shutdown_event = mail->event<bool>(mail::shutdown);
    if (!config::audio.stream) {
@@ -265,6 +291,9 @@
    return ctx.control->is_sink_available(sink);
  }
  /**
   * @brief Select the Opus stream configuration for a channel count and quality tier.
   */
  int map_stream(int channels, bool quality) {
    int shift = quality ? 1 : 0;
    switch (channels) {

@@ -12,6 +12,9 @@
#include <bitset>
namespace audio {
  /**
   * @brief Supported Opus channel layouts advertised to Moonlight clients.
   */
  enum stream_config_e : int {
    STEREO,  ///< Stereo
    HIGH_STEREO,  ///< High stereo
@@ -22,25 +25,37 @@
    MAX_STREAM_CONFIG  ///< Maximum audio stream configuration
  };
  /**
   * @brief Static Opus encoder layout for one advertised audio mode.
   */
  struct opus_stream_config_t {
    std::int32_t sampleRate;  ///< Opus sample rate in hertz.
    int channelCount;  ///< Number of audio channels in the Opus layout.
    int streams;  ///< Number of Opus streams in the layout.
    int coupledStreams;  ///< Number of stereo-coupled Opus streams.
    std::int32_t sampleRate;
    int channelCount;
    int streams;
    const std::uint8_t *mapping;  ///< Channel mapping table passed to the Opus encoder.
    int bitrate;  ///< Target bitrate in bits per second.
    int coupledStreams;
    const std::uint8_t *mapping;
    int bitrate;
  };
  /**
   * @brief Custom Opus channel layout supplied by configuration.
   */
  struct stream_params_t {
    int channelCount;  ///< Number of audio channels in the Opus layout.
    int streams;  ///< Number of Opus streams in the custom layout.
    int coupledStreams;  ///< Number of stereo-coupled Opus streams.
    int channelCount;
    int streams;
    int coupledStreams;
    std::uint8_t mapping[8];
    std::uint8_t mapping[8];  ///< Channel mapping table for up to eight speakers.
  };
  extern opus_stream_config_t stream_configs[MAX_STREAM_CONFIG];
  /**
   * @brief Audio capture and encoder settings for a stream.
   */
  struct config_t {
    /**
     * @brief Boolean audio feature flags.
     */
    enum flags_e : int {
      HIGH_QUALITY,  ///< High quality audio
      HOST_AUDIO,  ///< Host audio
@@ -49,29 +64,48 @@
      MAX_FLAGS  ///< Maximum number of flags
    };
    int packetDuration;  ///< Packet duration in milliseconds requested by the client.
    int channels;  ///< Number of audio channels requested by the client.
    int packetDuration;
    int channels;
    int mask;  ///< Speaker mask describing the requested channel layout.
    int mask;
    stream_params_t customStreamParams;  ///< Custom Opus layout used when CUSTOM_SURROUND_PARAMS is enabled.
    stream_params_t customStreamParams;
    std::bitset<MAX_FLAGS> flags;
    std::bitset<MAX_FLAGS> flags;  ///< Enabled audio feature flags.
  };
  /**
   * @brief Shared audio device state used while streams are active.
   */
  struct audio_ctx_t {
    // We want to change the sink for the first stream only
    std::unique_ptr<std::atomic_bool> sink_flag;  ///< Tracks whether the capture sink was already switched.
    std::unique_ptr<std::atomic_bool> sink_flag;
    std::unique_ptr<platf::audio_control_t> control;  ///< Platform audio-control implementation.
    std::unique_ptr<platf::audio_control_t> control;
    bool restore_sink;
    platf::sink_t sink;
    bool restore_sink;  ///< Whether Sunshine should restore the original sink when capture ends.
    platf::sink_t sink;  ///< Original sink captured before Sunshine switched devices.
  };
  /**
   * @brief Byte buffer used for encoded audio packet payloads.
   */
  using buffer_t = util::buffer_t<std::uint8_t>;
  /**
   * @brief Encoded audio packet paired with platform channel metadata.
   */
  using packet_t = std::pair<void *, buffer_t>;
  /**
   * @brief Shared mailbox reference to the global audio context.
   */
  using audio_ctx_ref_t = safe::shared_t<audio_ctx_t>::ptr_t;
  /**
   * @brief Capture, encode, and publish audio packets for a stream.
   *
   * @param mail Mailbox used to publish encoded audio packets.
   * @param config Audio capture and encoder settings.
   * @param channel_data Platform-specific capture channel pointer.
   */
  void capture(safe::mail_t mail, config_t config, void *channel_data);
  /**
@@ -99,6 +133,7 @@
   * }
   * return false;
   * @examples_end
   * @param ctx Native context object used by the operation or callback.
   */
  bool is_audio_ctx_sink_available(const audio_ctx_t &ctx);
}  // namespace audio

@@ -19,13 +19,29 @@
using namespace std::literals;
namespace cbs {
  /**
   * @brief Release an FFmpeg coded bitstream context.
   *
   * @param c Context pointer owned by the safe pointer wrapper.
   */
  void close(CodedBitstreamContext *c) {
    ff_cbs_close(&c);
  }
  /**
   * @brief Owning coded bitstream context pointer that calls ff_cbs_close.
   */
  using ctx_t = util::safe_ptr<CodedBitstreamContext, close>;
  /**
   * @brief Owns an FFmpeg coded bitstream fragment and frees fragment buffers on destruction.
   */
  class frag_t: public CodedBitstreamFragment {
  public:
    /**
     * @brief Move-construct a coded bitstream fragment and transfer FFmpeg-owned buffers.
     *
     * @param o Fragment whose allocated buffers are transferred to this instance.
     */
    frag_t(frag_t &&o) {
      std::copy((std::uint8_t *) &o, (std::uint8_t *) (&o + 1), (std::uint8_t *) this);
@@ -38,5 +54,11 @@
      std::fill_n((std::uint8_t *) this, sizeof(*this), 0);
    }
    /**
     * @brief Move-assign a coded bitstream fragment and transfer FFmpeg-owned buffers.
     *
     * @param o Fragment whose allocated buffers are transferred to this instance.
     * @return Reference to this fragment.
     */
    frag_t &operator=(frag_t &&o) {
      std::copy((std::uint8_t *) &o, (std::uint8_t *) (&o + 1), (std::uint8_t *) this);
@@ -54,6 +76,15 @@
    }
  };
  /**
   * @brief Serialize a prepared coded bitstream unit with an existing context.
   *
   * @param cbs_ctx Coded bitstream context initialized for the codec.
   * @param nal NAL unit type to insert into the fragment.
   * @param uh Pointer to the FFmpeg raw unit header/content structure.
   * @param codec_id FFmpeg codec identifier used by the context.
   * @return Serialized NAL unit bytes, or an empty buffer if FFmpeg rejects the fragment.
   */
  util::buffer_t<std::uint8_t> write(cbs::ctx_t &cbs_ctx, std::uint8_t nal, void *uh, AVCodecID codec_id) {
    cbs::frag_t frag;
    auto err = ff_cbs_insert_unit_content(&frag, -1, nal, uh, nullptr);
@@ -79,6 +110,14 @@
    return data;
  }
  /**
   * @brief Serialize a prepared coded bitstream unit with a temporary context.
   *
   * @param nal NAL unit type to insert into the fragment.
   * @param uh Pointer to the FFmpeg raw unit header/content structure.
   * @param codec_id FFmpeg codec identifier used to initialize the temporary context.
   * @return Serialized NAL unit bytes, or an empty buffer if FFmpeg rejects the fragment.
   */
  util::buffer_t<std::uint8_t> write(std::uint8_t nal, void *uh, AVCodecID codec_id) {
    cbs::ctx_t cbs_ctx;
    ff_cbs_init(&cbs_ctx, codec_id, nullptr);
@@ -86,6 +125,9 @@
    return write(cbs_ctx, nal, uh, codec_id);
  }
  /**
   * @brief Build replacement H.264 SPS bytes with Sunshine-required VUI fields.
   */
  h264_t make_sps_h264(const AVCodecContext *avctx, const AVPacket *packet) {
    cbs::ctx_t ctx;
    if (ff_cbs_init(&ctx, AV_CODEC_ID_H264, nullptr)) {
@@ -142,6 +184,9 @@
    };
  }
  /**
   * @brief Build replacement HEVC VPS/SPS bytes with Sunshine-required VUI fields.
   */
  hevc_t make_sps_hevc(const AVCodecContext *avctx, const AVPacket *packet) {
    cbs::ctx_t ctx;
    if (ff_cbs_init(&ctx, AV_CODEC_ID_H265, nullptr)) {
@@ -215,9 +260,11 @@
  }
  /**
   * @brief Check whether an encoded H.264 or HEVC packet contains active SPS VUI metadata.
   *
   * This function initializes a Coded Bitstream Context and reads the packet into a Coded Bitstream Fragment.
   * It then checks if the SPS->VUI (Video Usability Information) is present in the active SPS of the packet.
   * This is done for both H264 and H265 codecs.
   * @param packet Encoded packet to parse with FFmpeg's coded bitstream reader.
   * @param codec_id FFmpeg codec identifier; expected to be AV_CODEC_ID_H264 or AV_CODEC_ID_H265.
   * @return `true` when the packet's active SPS advertises VUI parameters.
   */
  bool validate_sps(const AVPacket *packet, int codec_id) {
    cbs::ctx_t ctx;

@@ -12,28 +12,52 @@
namespace cbs {
  /**
   * @brief Original and rewritten bytes for one codec NAL unit.
   */
  struct nal_t {
    util::buffer_t<std::uint8_t> _new;
    util::buffer_t<std::uint8_t> _new;  ///< Replacement bytes generated by Sunshine.
    util::buffer_t<std::uint8_t> old;  ///< Original bytes copied from the source packet.
    util::buffer_t<std::uint8_t> old;
  };
  /**
   * @brief HEVC parameter sets before and after VUI rewriting.
   */
  struct hevc_t {
    nal_t vps;  ///< Video parameter set bytes.
    nal_t vps;
    nal_t sps;
    nal_t sps;  ///< Sequence parameter set bytes.
  };
  /**
   * @brief H.264 parameter set before and after VUI rewriting.
   */
  struct h264_t {
    nal_t sps;  ///< Sequence parameter set bytes.
    nal_t sps;
  };
  /**
   * @brief Build HEVC replacement parameter sets for a packet.
   *
   * @param ctx FFmpeg codec context that provides colorimetry and reference-frame metadata.
   * @param packet Encoded packet containing the original VPS and SPS.
   * @return Original and rewritten VPS/SPS bytes.
   */
  hevc_t make_sps_hevc(const AVCodecContext *ctx, const AVPacket *packet);
  /**
   * @brief Build an H.264 replacement SPS for a packet.
   *
   * @param ctx FFmpeg codec context that provides colorimetry and reference-frame metadata.
   * @param packet Encoded packet containing the original SPS.
   * @return Original and rewritten SPS bytes.
   */
  h264_t make_sps_h264(const AVCodecContext *ctx, const AVPacket *packet);
  /**
   * @brief Validates the Sequence Parameter Set (SPS) of a given packet.
   * @param packet The packet to validate.
   * @param codec_id The ID of the codec used (either AV_CODEC_ID_H264 or AV_CODEC_ID_H265).
   * @return True if the SPS->VUI is present in the active SPS of the packet, false otherwise.
   * @brief Check whether an encoded H.264 or HEVC packet contains active SPS VUI metadata.
   *
   * @param packet Encoded packet to parse with FFmpeg's coded bitstream reader.
   * @param codec_id FFmpeg codec identifier; expected to be AV_CODEC_ID_H264 or AV_CODEC_ID_H265.
   * @return `true` when the packet's active SPS advertises VUI parameters.
   */
  bool validate_sps(const AVPacket *packet, int codec_id);
}  // namespace cbs

@@ -41,15 +41,21 @@
namespace fs = std::filesystem;
using namespace std::literals;
constexpr auto CA_DIR = "credentials";
constexpr auto CA_DIR = "credentials";  ///< Subdirectory under app data that stores Sunshine credentials.
const std::string PRIVATE_KEY_FILE = std::string(CA_DIR) + "/cakey.pem";  ///< Relative path to the persisted private key PEM file.
const std::string CERTIFICATE_FILE = std::string(CA_DIR) + "/cacert.pem";  ///< Relative path to the persisted certificate PEM file.
const std::string APPS_JSON_PATH = platf::appdata().string() + "/apps.json";  ///< Default path to the applications JSON file.
const std::string PRIVATE_KEY_FILE = std::string(CA_DIR) + "/cakey.pem";
const std::string CERTIFICATE_FILE = std::string(CA_DIR) + "/cacert.pem";
const std::string APPS_JSON_PATH = platf::appdata().string() + "/apps.json";
namespace config {
  namespace nv {
    /**
     * @brief Parse the `nvenc_twopass` configuration value.
     *
     * @param preset Encoder preset value supplied by the configuration.
     * @return Parsed enum value, or the setting-specific default when the text is unknown.
     */
    nvenc::nvenc_two_pass twopass_from_view(const std::string_view &preset) {
      if (preset == "disabled") {
        return nvenc::nvenc_two_pass::disabled;
@@ -64,6 +70,12 @@
      return nvenc::nvenc_two_pass::quarter_resolution;
    }
    /**
     * @brief Parse the `nvenc_split_encode` configuration value.
     *
     * @param preset Encoder preset value supplied by the configuration.
     * @return Parsed enum value, or the setting-specific default when the text is unknown.
     */
    nvenc::nvenc_split_frame_encoding split_encode_from_view(const std::string_view &preset) {
      using enum nvenc::nvenc_split_frame_encoding;
      if (preset == "disabled") {
@@ -84,45 +96,45 @@
  namespace amd {
#if !defined(_WIN32) || defined(DOXYGEN)
    // values accurate as of 27/12/2022, but aren't strictly necessary for MacOS build
    constexpr int AMF_VIDEO_ENCODER_AV1_QUALITY_PRESET_SPEED = 100;  ///< Fallback AMF enum value for av1 quality preset speed.
    constexpr int AMF_VIDEO_ENCODER_AV1_QUALITY_PRESET_QUALITY = 30;  ///< Fallback AMF enum value for av1 quality preset quality.
    constexpr int AMF_VIDEO_ENCODER_AV1_QUALITY_PRESET_BALANCED = 70;  ///< Fallback AMF enum value for av1 quality preset balanced.
    constexpr int AMF_VIDEO_ENCODER_HEVC_QUALITY_PRESET_SPEED = 10;  ///< Fallback AMF enum value for hevc quality preset speed.
    constexpr int AMF_VIDEO_ENCODER_HEVC_QUALITY_PRESET_QUALITY = 0;  ///< Fallback AMF enum value for hevc quality preset quality.
    constexpr int AMF_VIDEO_ENCODER_HEVC_QUALITY_PRESET_BALANCED = 5;  ///< Fallback AMF enum value for hevc quality preset balanced.
    constexpr int AMF_VIDEO_ENCODER_AV1_QUALITY_PRESET_SPEED = 100;
    constexpr int AMF_VIDEO_ENCODER_AV1_QUALITY_PRESET_QUALITY = 30;
    constexpr int AMF_VIDEO_ENCODER_AV1_QUALITY_PRESET_BALANCED = 70;
    constexpr int AMF_VIDEO_ENCODER_HEVC_QUALITY_PRESET_SPEED = 10;
    constexpr int AMF_VIDEO_ENCODER_HEVC_QUALITY_PRESET_QUALITY = 0;
    constexpr int AMF_VIDEO_ENCODER_HEVC_QUALITY_PRESET_BALANCED = 5;
    constexpr int AMF_VIDEO_ENCODER_QUALITY_PRESET_SPEED = 1;  ///< Fallback AMF enum value for quality preset speed.
    constexpr int AMF_VIDEO_ENCODER_QUALITY_PRESET_QUALITY = 2;  ///< Fallback AMF enum value for quality preset quality.
    constexpr int AMF_VIDEO_ENCODER_QUALITY_PRESET_SPEED = 1;
    constexpr int AMF_VIDEO_ENCODER_QUALITY_PRESET_QUALITY = 2;
    constexpr int AMF_VIDEO_ENCODER_QUALITY_PRESET_BALANCED = 0;
    constexpr int AMF_VIDEO_ENCODER_AV1_RATE_CONTROL_METHOD_CONSTANT_QP = 0;
    constexpr int AMF_VIDEO_ENCODER_AV1_RATE_CONTROL_METHOD_CBR = 3;
    constexpr int AMF_VIDEO_ENCODER_AV1_RATE_CONTROL_METHOD_PEAK_CONSTRAINED_VBR = 2;
    constexpr int AMF_VIDEO_ENCODER_AV1_RATE_CONTROL_METHOD_LATENCY_CONSTRAINED_VBR = 1;
    constexpr int AMF_VIDEO_ENCODER_HEVC_RATE_CONTROL_METHOD_CONSTANT_QP = 0;
    constexpr int AMF_VIDEO_ENCODER_HEVC_RATE_CONTROL_METHOD_CBR = 3;
    constexpr int AMF_VIDEO_ENCODER_HEVC_RATE_CONTROL_METHOD_PEAK_CONSTRAINED_VBR = 2;
    constexpr int AMF_VIDEO_ENCODER_HEVC_RATE_CONTROL_METHOD_LATENCY_CONSTRAINED_VBR = 1;
    constexpr int AMF_VIDEO_ENCODER_RATE_CONTROL_METHOD_CONSTANT_QP = 0;
    constexpr int AMF_VIDEO_ENCODER_RATE_CONTROL_METHOD_CBR = 1;
    constexpr int AMF_VIDEO_ENCODER_RATE_CONTROL_METHOD_PEAK_CONSTRAINED_VBR = 2;
    constexpr int AMF_VIDEO_ENCODER_RATE_CONTROL_METHOD_LATENCY_CONSTRAINED_VBR = 3;
    constexpr int AMF_VIDEO_ENCODER_AV1_USAGE_TRANSCODING = 0;
    constexpr int AMF_VIDEO_ENCODER_AV1_USAGE_LOW_LATENCY = 1;
    constexpr int AMF_VIDEO_ENCODER_AV1_USAGE_ULTRA_LOW_LATENCY = 2;
    constexpr int AMF_VIDEO_ENCODER_AV1_USAGE_WEBCAM = 3;
    constexpr int AMF_VIDEO_ENCODER_AV1_USAGE_LOW_LATENCY_HIGH_QUALITY = 5;
    constexpr int AMF_VIDEO_ENCODER_HEVC_USAGE_TRANSCODING = 0;
    constexpr int AMF_VIDEO_ENCODER_HEVC_USAGE_ULTRA_LOW_LATENCY = 1;
    constexpr int AMF_VIDEO_ENCODER_HEVC_USAGE_LOW_LATENCY = 2;
    constexpr int AMF_VIDEO_ENCODER_HEVC_USAGE_WEBCAM = 3;
    constexpr int AMF_VIDEO_ENCODER_HEVC_USAGE_LOW_LATENCY_HIGH_QUALITY = 5;
    constexpr int AMF_VIDEO_ENCODER_USAGE_TRANSCODING = 0;
    constexpr int AMF_VIDEO_ENCODER_USAGE_ULTRA_LOW_LATENCY = 1;
    constexpr int AMF_VIDEO_ENCODER_USAGE_LOW_LATENCY = 2;
    constexpr int AMF_VIDEO_ENCODER_USAGE_WEBCAM = 3;
    constexpr int AMF_VIDEO_ENCODER_USAGE_LOW_LATENCY_HIGH_QUALITY = 5;
    constexpr int AMF_VIDEO_ENCODER_UNDEFINED = 0;
    constexpr int AMF_VIDEO_ENCODER_CABAC = 1;
    constexpr int AMF_VIDEO_ENCODER_CALV = 2;
    constexpr int AMF_VIDEO_ENCODER_QUALITY_PRESET_BALANCED = 0;  ///< Fallback AMF enum value for quality preset balanced.
    constexpr int AMF_VIDEO_ENCODER_AV1_RATE_CONTROL_METHOD_CONSTANT_QP = 0;  ///< Fallback AMF enum value for av1 rate control method constant qp.
    constexpr int AMF_VIDEO_ENCODER_AV1_RATE_CONTROL_METHOD_CBR = 3;  ///< Fallback AMF enum value for av1 rate control method cbr.
    constexpr int AMF_VIDEO_ENCODER_AV1_RATE_CONTROL_METHOD_PEAK_CONSTRAINED_VBR = 2;  ///< Fallback AMF enum value for av1 rate control method peak constrained vbr.
    constexpr int AMF_VIDEO_ENCODER_AV1_RATE_CONTROL_METHOD_LATENCY_CONSTRAINED_VBR = 1;  ///< Fallback AMF enum value for av1 rate control method latency constrained vbr.
    constexpr int AMF_VIDEO_ENCODER_HEVC_RATE_CONTROL_METHOD_CONSTANT_QP = 0;  ///< Fallback AMF enum value for hevc rate control method constant qp.
    constexpr int AMF_VIDEO_ENCODER_HEVC_RATE_CONTROL_METHOD_CBR = 3;  ///< Fallback AMF enum value for hevc rate control method cbr.
    constexpr int AMF_VIDEO_ENCODER_HEVC_RATE_CONTROL_METHOD_PEAK_CONSTRAINED_VBR = 2;  ///< Fallback AMF enum value for hevc rate control method peak constrained vbr.
    constexpr int AMF_VIDEO_ENCODER_HEVC_RATE_CONTROL_METHOD_LATENCY_CONSTRAINED_VBR = 1;  ///< Fallback AMF enum value for hevc rate control method latency constrained vbr.
    constexpr int AMF_VIDEO_ENCODER_RATE_CONTROL_METHOD_CONSTANT_QP = 0;  ///< Fallback AMF enum value for rate control method constant qp.
    constexpr int AMF_VIDEO_ENCODER_RATE_CONTROL_METHOD_CBR = 1;  ///< Fallback AMF enum value for rate control method cbr.
    constexpr int AMF_VIDEO_ENCODER_RATE_CONTROL_METHOD_PEAK_CONSTRAINED_VBR = 2;  ///< Fallback AMF enum value for rate control method peak constrained vbr.
    constexpr int AMF_VIDEO_ENCODER_RATE_CONTROL_METHOD_LATENCY_CONSTRAINED_VBR = 3;  ///< Fallback AMF enum value for rate control method latency constrained vbr.
    constexpr int AMF_VIDEO_ENCODER_AV1_USAGE_TRANSCODING = 0;  ///< Fallback AMF enum value for av1 usage transcoding.
    constexpr int AMF_VIDEO_ENCODER_AV1_USAGE_LOW_LATENCY = 1;  ///< Fallback AMF enum value for av1 usage low latency.
    constexpr int AMF_VIDEO_ENCODER_AV1_USAGE_ULTRA_LOW_LATENCY = 2;  ///< Fallback AMF enum value for av1 usage ultra low latency.
    constexpr int AMF_VIDEO_ENCODER_AV1_USAGE_WEBCAM = 3;  ///< Fallback AMF enum value for av1 usage webcam.
    constexpr int AMF_VIDEO_ENCODER_AV1_USAGE_LOW_LATENCY_HIGH_QUALITY = 5;  ///< Fallback AMF enum value for av1 usage low latency high quality.
    constexpr int AMF_VIDEO_ENCODER_HEVC_USAGE_TRANSCODING = 0;  ///< Fallback AMF enum value for hevc usage transcoding.
    constexpr int AMF_VIDEO_ENCODER_HEVC_USAGE_ULTRA_LOW_LATENCY = 1;  ///< Fallback AMF enum value for hevc usage ultra low latency.
    constexpr int AMF_VIDEO_ENCODER_HEVC_USAGE_LOW_LATENCY = 2;  ///< Fallback AMF enum value for hevc usage low latency.
    constexpr int AMF_VIDEO_ENCODER_HEVC_USAGE_WEBCAM = 3;  ///< Fallback AMF enum value for hevc usage webcam.
    constexpr int AMF_VIDEO_ENCODER_HEVC_USAGE_LOW_LATENCY_HIGH_QUALITY = 5;  ///< Fallback AMF enum value for hevc usage low latency high quality.
    constexpr int AMF_VIDEO_ENCODER_USAGE_TRANSCODING = 0;  ///< Fallback AMF enum value for usage transcoding.
    constexpr int AMF_VIDEO_ENCODER_USAGE_ULTRA_LOW_LATENCY = 1;  ///< Fallback AMF enum value for usage ultra low latency.
    constexpr int AMF_VIDEO_ENCODER_USAGE_LOW_LATENCY = 2;  ///< Fallback AMF enum value for usage low latency.
    constexpr int AMF_VIDEO_ENCODER_USAGE_WEBCAM = 3;  ///< Fallback AMF enum value for usage webcam.
    constexpr int AMF_VIDEO_ENCODER_USAGE_LOW_LATENCY_HIGH_QUALITY = 5;  ///< Fallback AMF enum value for usage low latency high quality.
    constexpr int AMF_VIDEO_ENCODER_UNDEFINED = 0;  ///< Fallback AMF enum value for undefined.
    constexpr int AMF_VIDEO_ENCODER_CABAC = 1;  ///< Fallback AMF enum value for cabac.
    constexpr int AMF_VIDEO_ENCODER_CALV = 2;  ///< Fallback AMF enum value for calv.
#else
  #ifdef _GLIBCXX_USE_C99_INTTYPES
    #undef _GLIBCXX_USE_C99_INTTYPES
@@ -132,24 +144,36 @@
  #include <AMF/components/VideoEncoderVCE.h>
#endif
    /**
     * @brief Enumerates supported quality AV1 options.
     */
    enum class quality_av1_e : int {
      speed = AMF_VIDEO_ENCODER_AV1_QUALITY_PRESET_SPEED,  ///< Speed preset
      quality = AMF_VIDEO_ENCODER_AV1_QUALITY_PRESET_QUALITY,  ///< Quality preset
      balanced = AMF_VIDEO_ENCODER_AV1_QUALITY_PRESET_BALANCED  ///< Balanced preset
    };
    /**
     * @brief Enumerates supported quality HEVC options.
     */
    enum class quality_hevc_e : int {
      speed = AMF_VIDEO_ENCODER_HEVC_QUALITY_PRESET_SPEED,  ///< Speed preset
      quality = AMF_VIDEO_ENCODER_HEVC_QUALITY_PRESET_QUALITY,  ///< Quality preset
      balanced = AMF_VIDEO_ENCODER_HEVC_QUALITY_PRESET_BALANCED  ///< Balanced preset
    };
    /**
     * @brief Enumerates supported quality h264 options.
     */
    enum class quality_h264_e : int {
      speed = AMF_VIDEO_ENCODER_QUALITY_PRESET_SPEED,  ///< Speed preset
      quality = AMF_VIDEO_ENCODER_QUALITY_PRESET_QUALITY,  ///< Quality preset
      balanced = AMF_VIDEO_ENCODER_QUALITY_PRESET_BALANCED  ///< Balanced preset
    };
    /**
     * @brief Enumerates supported rc AV1 options.
     */
    enum class rc_av1_e : int {
      cbr = AMF_VIDEO_ENCODER_AV1_RATE_CONTROL_METHOD_CBR,  ///< CBR
      cqp = AMF_VIDEO_ENCODER_AV1_RATE_CONTROL_METHOD_CONSTANT_QP,  ///< CQP
@@ -157,6 +181,9 @@
      vbr_peak = AMF_VIDEO_ENCODER_AV1_RATE_CONTROL_METHOD_PEAK_CONSTRAINED_VBR  ///< VBR with peak constraints
    };
    /**
     * @brief Enumerates supported rc HEVC options.
     */
    enum class rc_hevc_e : int {
      cbr = AMF_VIDEO_ENCODER_HEVC_RATE_CONTROL_METHOD_CBR,  ///< CBR
      cqp = AMF_VIDEO_ENCODER_HEVC_RATE_CONTROL_METHOD_CONSTANT_QP,  ///< CQP
@@ -164,6 +191,9 @@
      vbr_peak = AMF_VIDEO_ENCODER_HEVC_RATE_CONTROL_METHOD_PEAK_CONSTRAINED_VBR  ///< VBR with peak constraints
    };
    /**
     * @brief Enumerates supported rc h264 options.
     */
    enum class rc_h264_e : int {
      cbr = AMF_VIDEO_ENCODER_RATE_CONTROL_METHOD_CBR,  ///< CBR
      cqp = AMF_VIDEO_ENCODER_RATE_CONTROL_METHOD_CONSTANT_QP,  ///< CQP
@@ -171,6 +201,9 @@
      vbr_peak = AMF_VIDEO_ENCODER_RATE_CONTROL_METHOD_PEAK_CONSTRAINED_VBR  ///< VBR with peak constraints
    };
    /**
     * @brief Enumerates supported usage AV1 options.
     */
    enum class usage_av1_e : int {
      transcoding = AMF_VIDEO_ENCODER_AV1_USAGE_TRANSCODING,  ///< Transcoding preset
      webcam = AMF_VIDEO_ENCODER_AV1_USAGE_WEBCAM,  ///< Webcam preset
@@ -179,6 +212,9 @@
      ultralowlatency = AMF_VIDEO_ENCODER_AV1_USAGE_ULTRA_LOW_LATENCY  ///< Ultra low latency preset
    };
    /**
     * @brief Enumerates supported usage HEVC options.
     */
    enum class usage_hevc_e : int {
      transcoding = AMF_VIDEO_ENCODER_HEVC_USAGE_TRANSCODING,  ///< Transcoding preset
      webcam = AMF_VIDEO_ENCODER_HEVC_USAGE_WEBCAM,  ///< Webcam preset
@@ -187,6 +223,9 @@
      ultralowlatency = AMF_VIDEO_ENCODER_HEVC_USAGE_ULTRA_LOW_LATENCY  ///< Ultra low latency preset
    };
    /**
     * @brief Enumerates supported usage h264 options.
     */
    enum class usage_h264_e : int {
      transcoding = AMF_VIDEO_ENCODER_USAGE_TRANSCODING,  ///< Transcoding preset
      webcam = AMF_VIDEO_ENCODER_USAGE_WEBCAM,  ///< Webcam preset
@@ -195,17 +234,29 @@
      ultralowlatency = AMF_VIDEO_ENCODER_USAGE_ULTRA_LOW_LATENCY  ///< Ultra low latency preset
    };
    /**
     * @brief Enumerates supported coder options.
     */
    enum coder_e : int {
      _auto = AMF_VIDEO_ENCODER_UNDEFINED,  ///< Auto
      cabac = AMF_VIDEO_ENCODER_CABAC,  ///< CABAC
      cavlc = AMF_VIDEO_ENCODER_CALV  ///< CAVLC
    };
    /**
     * @brief Parse an AMD quality preset while preserving the current value on invalid input.
     *
     * @param quality_type Configuration text naming the AMD quality preset.
     * @param original Original text value used when reporting a parsing failure.
     * @return Parsed enum value, or the setting-specific default when the text is unknown.
     */
    template<class T>
    ::std::optional<int> quality_from_view(const ::std::string_view &quality_type, const ::std::optional<int>(&original)) {
#ifndef DOXYGEN
  #define _CONVERT_(x) \
    if (quality_type == #x##sv) \
    return (int) T::x
#define _CONVERT_(x) \
  if (quality_type == #x##sv) \
  return (int) T::x
#endif
      _CONVERT_(balanced);
      _CONVERT_(quality);
      _CONVERT_(speed);
@@ -213,11 +264,20 @@
      return original;
    }
    /**
     * @brief Parse an AMD rate-control mode while preserving the current value on invalid input.
     *
     * @param rc Rate-control mode selected in the configuration.
     * @param original Original text value used when reporting a parsing failure.
     * @return Parsed enum value, or the setting-specific default when the text is unknown.
     */
    template<class T>
    ::std::optional<int> rc_from_view(const ::std::string_view &rc, const ::std::optional<int>(&original)) {
#define _CONVERT_(x) \
#ifndef DOXYGEN
  #define _CONVERT_(x) \
    if (rc == #x##sv) \
    return (int) T::x
#endif
  if (rc == #x##sv) \
  return (int) T::x
      _CONVERT_(cbr);
      _CONVERT_(cqp);
      _CONVERT_(vbr_latency);
@@ -226,11 +286,20 @@
      return original;
    }
    /**
     * @brief Parse an AMD encoder usage mode while preserving the current value on invalid input.
     *
     * @param usage Encoder usage mode selected in the configuration.
     * @param original Original text value used when reporting a parsing failure.
     * @return Parsed enum value, or the setting-specific default when the text is unknown.
     */
    template<class T>
    ::std::optional<int> usage_from_view(const ::std::string_view &usage, const ::std::optional<int>(&original)) {
#ifndef DOXYGEN
  #define _CONVERT_(x) \
    if (usage == #x##sv) \
#define _CONVERT_(x) \
  if (usage == #x##sv) \
  return (int) T::x
    return (int) T::x
#endif
      _CONVERT_(lowlatency);
      _CONVERT_(lowlatency_high_quality);
      _CONVERT_(transcoding);
@@ -240,6 +309,12 @@
      return original;
    }
    /**
     * @brief Parse an entropy-coder mode from configuration text.
     *
     * @param coder Entropy-coder mode selected in the configuration.
     * @return Parsed enum value, or the setting-specific default when the text is unknown.
     */
    int coder_from_view(const ::std::string_view &coder) {
      if (coder == "auto"sv) {
        return _auto;
@@ -256,6 +331,9 @@
  }  // namespace amd
  namespace qsv {
    /**
     * @brief Enumerates supported preset options.
     */
    enum preset_e : int {
      veryslow = 1,  ///< veryslow preset
      slower = 2,  ///< slower preset
@@ -266,16 +344,27 @@
      veryfast = 7  ///< veryfast preset
    };
    /**
     * @brief Enumerates supported cavlc options.
     */
    enum cavlc_e : int {
      _auto = false,  ///< Auto
      enabled = true,  ///< Enabled
      disabled = false  ///< Disabled
    };
    /**
     * @brief Parse a QSV encoder preset from configuration text.
     *
     * @param preset Encoder preset value supplied by the configuration.
     * @return Parsed enum value, or the setting-specific default when the text is unknown.
     */
    std::optional<int> preset_from_view(const std::string_view &preset) {
#define _CONVERT_(x) \
  if (preset == #x##sv) \
  return x
#ifndef DOXYGEN
  #define _CONVERT_(x) \
    if (preset == #x##sv) \
    return x
#endif
      _CONVERT_(veryslow);
      _CONVERT_(slower);
      _CONVERT_(slow);
@@ -287,6 +376,12 @@
      return std::nullopt;
    }
    /**
     * @brief Parse an entropy-coder mode from configuration text.
     *
     * @param coder Entropy-coder mode selected in the configuration.
     * @return Parsed enum value, or the setting-specific default when the text is unknown.
     */
    std::optional<int> coder_from_view(const std::string_view &coder) {
      if (coder == "auto"sv) {
        return _auto;
@@ -304,12 +399,21 @@
  namespace vt {
    /**
     * @brief Enumerates supported coder options.
     */
    enum coder_e : int {
      _auto = 0,  ///< Auto
      cabac,  ///< CABAC
      cavlc  ///< CAVLC
    };
    /**
     * @brief Parse an entropy-coder mode from configuration text.
     *
     * @param coder Entropy-coder mode selected in the configuration.
     * @return Parsed enum value, or the setting-specific default when the text is unknown.
     */
    int coder_from_view(const std::string_view &coder) {
      if (coder == "auto"sv) {
        return _auto;
@@ -324,6 +428,12 @@
      return -1;
    }
    /**
     * @brief Parse whether VideoToolbox software encoding is allowed.
     *
     * @param software Whether the software encoder path is being configured.
     * @return Parsed enum value, or the setting-specific default when the text is unknown.
     */
    int allow_software_from_view(const std::string_view &software) {
      if (software == "allowed"sv || software == "forced") {
        return 1;
@@ -332,6 +442,12 @@
      return 0;
    }
    /**
     * @brief Parse whether VideoToolbox software encoding is forced.
     *
     * @param software Whether the software encoder path is being configured.
     * @return Parsed enum value, or the setting-specific default when the text is unknown.
     */
    int force_software_from_view(const std::string_view &software) {
      if (software == "forced") {
        return 1;
@@ -340,6 +456,12 @@
      return 0;
    }
    /**
     * @brief Parse the VideoToolbox realtime encoder flag.
     *
     * @param rt Real-time encoder usage selector.
     * @return Parsed enum value, or the setting-specific default when the text is unknown.
     */
    int rt_from_view(const std::string_view &rt) {
      if (rt == "disabled" || rt == "off" || rt == "0") {
        return 0;
@@ -351,10 +473,18 @@
  }  // namespace vt
  namespace sw {
    /**
     * @brief Parse an SVT-AV1 speed preset from configuration text.
     *
     * @param preset Encoder preset value supplied by the configuration.
     * @return Parsed enum value, or the setting-specific default when the text is unknown.
     */
    int svtav1_preset_from_view(const std::string_view &preset) {
#ifndef DOXYGEN
  #define _CONVERT_(x, y) \
    if (preset == #x##sv) \
    return y
#endif
#define _CONVERT_(x, y) \
  if (preset == #x##sv) \
  return y
      _CONVERT_(veryslow, 1);
      _CONVERT_(slower, 2);
      _CONVERT_(slow, 4);
@@ -370,10 +500,18 @@
  }  // namespace sw
  namespace dd {
    /**
     * @brief Parse display-device preparation mode from configuration text.
     *
     * @param value Configuration text from the display-device preparation setting.
     * @return Parsed enum value, or the setting-specific default when the text is unknown.
     */
    video_t::dd_t::config_option_e config_option_from_view(const std::string_view value) {
#define _CONVERT_(x) \
  if (value == #x##sv) \
  return video_t::dd_t::config_option_e::x
#ifndef DOXYGEN
  #define _CONVERT_(x) \
    if (value == #x##sv) \
    return video_t::dd_t::config_option_e::x
#endif
      _CONVERT_(disabled);
      _CONVERT_(verify_only);
      _CONVERT_(ensure_active);
@@ -383,11 +521,19 @@
      return video_t::dd_t::config_option_e::disabled;  // Default to this if value is invalid
    }
    /**
     * @brief Parse display-device resolution mode from configuration text.
     *
     * @param value Configuration text from the display-device resolution setting.
     * @return Parsed enum value, or the setting-specific default when the text is unknown.
     */
    video_t::dd_t::resolution_option_e resolution_option_from_view(const std::string_view value) {
#define _CONVERT_2_ARG_(str, val) \
  if (value == #str##sv) \
  return video_t::dd_t::resolution_option_e::val
#define _CONVERT_(x) _CONVERT_2_ARG_(x, x)
#ifndef DOXYGEN
  #define _CONVERT_2_ARG_(str, val) \
    if (value == #str##sv) \
    return video_t::dd_t::resolution_option_e::val
  #define _CONVERT_(x) _CONVERT_2_ARG_(x, x)
#endif
      _CONVERT_(disabled);
      _CONVERT_2_ARG_(auto, automatic);
      _CONVERT_(manual);
@@ -396,11 +542,19 @@
      return video_t::dd_t::resolution_option_e::disabled;  // Default to this if value is invalid
    }
    /**
     * @brief Parse display-device refresh-rate mode from configuration text.
     *
     * @param value Configuration text from the display-device refresh-rate setting.
     * @return Parsed enum value, or the setting-specific default when the text is unknown.
     */
    video_t::dd_t::refresh_rate_option_e refresh_rate_option_from_view(const std::string_view value) {
#define _CONVERT_2_ARG_(str, val) \
  if (value == #str##sv) \
#ifndef DOXYGEN
  #define _CONVERT_2_ARG_(str, val) \
    if (value == #str##sv) \
    return video_t::dd_t::refresh_rate_option_e::val
  #define _CONVERT_(x) _CONVERT_2_ARG_(x, x)
  return video_t::dd_t::refresh_rate_option_e::val
#define _CONVERT_(x) _CONVERT_2_ARG_(x, x)
#endif
      _CONVERT_(disabled);
      _CONVERT_2_ARG_(auto, automatic);
      _CONVERT_(manual);
@@ -409,11 +563,19 @@
      return video_t::dd_t::refresh_rate_option_e::disabled;  // Default to this if value is invalid
    }
    /**
     * @brief Parse display-device HDR mode from configuration text.
     *
     * @param value Configuration text from the display-device HDR setting.
     * @return Parsed enum value, or the setting-specific default when the text is unknown.
     */
    video_t::dd_t::hdr_option_e hdr_option_from_view(const std::string_view value) {
#ifndef DOXYGEN
  #define _CONVERT_2_ARG_(str, val) \
    if (value == #str##sv) \
#define _CONVERT_2_ARG_(str, val) \
  if (value == #str##sv) \
    return video_t::dd_t::hdr_option_e::val
  #define _CONVERT_(x) _CONVERT_2_ARG_(x, x)
#endif
  return video_t::dd_t::hdr_option_e::val
#define _CONVERT_(x) _CONVERT_2_ARG_(x, x)
      _CONVERT_(disabled);
      _CONVERT_2_ARG_(auto, automatic);
#undef _CONVERT_
@@ -421,6 +583,12 @@
      return video_t::dd_t::hdr_option_e::disabled;  // Default to this if value is invalid
    }
    /**
     * @brief Parse display-mode remapping rules from JSON configuration text.
     *
     * @param value JSON array text from the display-device mode-remapping setting.
     * @return Parsed enum value, or the setting-specific default when the text is unknown.
     */
    video_t::dd_t::mode_remapping_t mode_remapping_from_view(const std::string_view value) {
      const auto parse_entry_list {[](const auto &entry_list, auto &output_field) {
        for (auto &[_, entry] : entry_list) {
@@ -449,5 +617,8 @@
    }
  }  // namespace dd
  /**
   * @brief Default video configuration values used before file and CLI overrides.
   */
  video_t video {
    28,  // qp
@@ -528,6 +699,9 @@
    0  // minimum_fps_target (0 = framerate)
  };
  /**
   * @brief Default audio configuration values used before file and CLI overrides.
   */
  audio_t audio {
    {},  // audio_sink
    {},  // virtual_sink
@@ -535,5 +709,8 @@
    true,  // install_steam_drivers
  };
  /**
   * @brief Default stream configuration values used before file and CLI overrides.
   */
  stream_t stream {
    10s,  // ping_timeout
@@ -547,5 +724,8 @@
    0,  // packetsize
  };
  /**
   * @brief Default NVHTTP server configuration values used before file and CLI overrides.
   */
  nvhttp_t nvhttp {
    "lan",  // origin web manager
@@ -558,6 +738,9 @@
    {},  // external_ip
  };
  /**
   * @brief Default input configuration values used before file and CLI overrides.
   */
  input_t input {
    {
      {0x10, 0xA0},
@@ -585,6 +768,9 @@
    true,  // native pen/touch support
  };
  /**
   * @brief Default top-level Sunshine configuration values used before file and CLI overrides.
   */
  sunshine_t sunshine {
    "en",  // locale
    2,  // min_log_level
@@ -604,17 +790,42 @@
    {},  // prep commands
  };
  /**
   * @brief Return whether a character terminates a configuration line.
   *
   * @param ch Character currently being classified by the parser.
   * @return True when the tested parser condition is met.
   */
  bool endline(char ch) {
    return ch == '\r' || ch == '\n';
  }
  /**
   * @brief Return whether a character is horizontal parser whitespace.
   *
   * @param ch Character currently being classified by the parser.
   * @return True when the tested parser condition is met.
   */
  bool space_tab(char ch) {
    return ch == ' ' || ch == '\t';
  }
  /**
   * @brief Return whether a character should be treated as parser whitespace.
   *
   * @param ch Character currently being classified by the parser.
   * @return True when the tested parser condition is met.
   */
  bool whitespace(char ch) {
    return space_tab(ch) || endline(ch);
  }
  /**
   * @brief Copy a configuration text range while stripping inline comments.
   *
   * @param begin Iterator or pointer marking the start of the input range.
   * @param end Iterator or pointer marking the end of the input range.
   * @return Value converted to string.
   */
  std::string to_string(const char *begin, const char *end) {
    std::string result;
@@ -631,6 +842,13 @@
    return result;
  }
  /**
   * @brief Advance over a bracketed list while honoring nested brackets.
   *
   * @param skipper Function used to skip characters while parsing.
   * @param end Iterator or pointer marking the end of the input range.
   * @return Iterator positioned after the matching closing bracket or at the end.
   */
  template<class It>
  It skip_list(It skipper, It end) {
    int stack = 1;
@@ -651,6 +869,13 @@
  std::pair<
    std::string_view::const_iterator,
    std::optional<std::pair<std::string, std::string>>>
    /**
     * @brief Parse one `name = value` configuration entry.
     *
     * @param begin Iterator or pointer marking the start of the input range.
     * @param end Iterator or pointer marking the end of the input range.
     * @return Iterator for the next line and the parsed key-value pair when one was found.
     */
    parse_option(std::string_view::const_iterator begin, std::string_view::const_iterator end) {
    begin = std::find_if_not(begin, end, whitespace);
    auto endl = std::find_if(begin, end, endline);
@@ -689,5 +914,8 @@
    );
  }
  /**
   * @brief Parse Sunshine configuration text into key-value entries.
   */
  std::unordered_map<std::string, std::string> parse_config(const std::string_view &file_content) {
    std::unordered_map<std::string, std::string> vars;
@@ -714,6 +942,13 @@
    return vars;
  }
  /**
   * @brief Consume a string setting from the parsed configuration map.
   *
   * @param vars Parsed configuration entries; consumed keys are erased.
   * @param name Configuration key to consume.
   * @param input Destination field updated when the setting exists and parses successfully.
   */
  void string_f(std::unordered_map<std::string, std::string> &vars, const std::string &name, std::string &input) {
    auto it = vars.find(name);
    if (it == std::end(vars)) {
@@ -725,6 +960,14 @@
    vars.erase(it);
  }
  /**
   * @brief Consume a setting and convert it with a caller-provided parser.
   *
   * @param vars Parsed configuration entries; consumed keys are erased.
   * @param name Configuration key to consume.
   * @param input Destination field updated when the setting exists and parses successfully.
   * @param f Converter applied to the raw configuration string.
   */
  template<typename T, typename F>
  void generic_f(std::unordered_map<std::string, std::string> &vars, const std::string &name, T &input, F &&f) {
    std::string tmp;
@@ -734,6 +977,14 @@
    }
  }
  /**
   * @brief Consume a string setting only when it matches an allowed value.
   *
   * @param vars Parsed configuration entries; consumed keys are erased.
   * @param name Configuration key to consume.
   * @param input Destination field updated when the setting exists and parses successfully.
   * @param allowed_vals Accepted string values for this setting.
   */
  void string_restricted_f(std::unordered_map<std::string, std::string> &vars, const std::string &name, std::string &input, const std::vector<std::string_view> &allowed_vals) {
    std::string temp;
    string_f(vars, name, temp);
@@ -746,6 +997,13 @@
    }
  }
  /**
   * @brief Parse a comma-separated string setting into a list.
   *
   * @param vars Configuration key-value map.
   * @param name Setting name.
   * @param output Parsed string list.
   */
  void string_list_f(std::unordered_map<std::string, std::string> &vars, const std::string &name, std::vector<std::string> &output) {  // NOSONAR(cpp:S6045) - transparent hasher not available for unordered_map in this codebase
    std::string temp;
    string_f(vars, name, temp);
@@ -767,6 +1025,13 @@
    }
  }
  /**
   * @brief Consume a path setting and normalize it under the app data directory when relative.
   *
   * @param vars Parsed configuration entries; consumed keys are erased.
   * @param name Configuration key to consume.
   * @param input Destination field updated when the setting exists and parses successfully.
   */
  void path_f(std::unordered_map<std::string, std::string> &vars, const std::string &name, fs::path &input) {
    // appdata needs to be retrieved once only
    static auto appdata = platf::appdata();
@@ -791,5 +1056,12 @@
    }
  }
  /**
   * @brief Consume a path setting and normalize it under the app data directory when relative.
   *
   * @param vars Parsed configuration entries; consumed keys are erased.
   * @param name Configuration key to consume.
   * @param input Destination field updated when the setting exists and parses successfully.
   */
  void path_f(std::unordered_map<std::string, std::string> &vars, const std::string &name, std::string &input) {
    fs::path temp = input;
@@ -799,5 +1071,12 @@
    input = temp.string();
  }
  /**
   * @brief Consume an integer setting from decimal or hexadecimal configuration text.
   *
   * @param vars Parsed configuration entries; consumed keys are erased.
   * @param name Configuration key to consume.
   * @param input Destination field updated when the setting exists and parses successfully.
   */
  void int_f(std::unordered_map<std::string, std::string> &vars, const std::string &name, int &input) {
    auto it = vars.find(name);
@@ -823,5 +1102,12 @@
    vars.erase(it);
  }
  /**
   * @brief Consume an integer setting from decimal or hexadecimal configuration text.
   *
   * @param vars Parsed configuration entries; consumed keys are erased.
   * @param name Configuration key to consume.
   * @param input Destination field updated when the setting exists and parses successfully.
   */
  void int_f(std::unordered_map<std::string, std::string> &vars, const std::string &name, std::optional<int> &input) {
    auto it = vars.find(name);
@@ -847,6 +1133,14 @@
    vars.erase(it);
  }
  /**
   * @brief Consume an integer setting from decimal or hexadecimal configuration text.
   *
   * @param vars Parsed configuration entries; consumed keys are erased.
   * @param name Configuration key to consume.
   * @param input Destination field updated when the setting exists and parses successfully.
   * @param f Converter applied to the raw configuration string.
   */
  template<class F>
  void int_f(std::unordered_map<std::string, std::string> &vars, const std::string &name, int &input, F &&f) {
    std::string tmp;
@@ -856,6 +1150,14 @@
    }
  }
  /**
   * @brief Consume an integer setting from decimal or hexadecimal configuration text.
   *
   * @param vars Parsed configuration entries; consumed keys are erased.
   * @param name Configuration key to consume.
   * @param input Destination field updated when the setting exists and parses successfully.
   * @param f Converter applied to the raw configuration string.
   */
  template<class F>
  void int_f(std::unordered_map<std::string, std::string> &vars, const std::string &name, std::optional<int> &input, F &&f) {
    std::string tmp;
@@ -865,5 +1167,13 @@
    }
  }
  /**
   * @brief Consume an integer setting only when it falls inside an inclusive range.
   *
   * @param vars Parsed configuration entries; consumed keys are erased.
   * @param name Configuration key to consume.
   * @param input Destination field updated when the setting exists and parses successfully.
   * @param range Inclusive range accepted for the parsed value.
   */
  void int_between_f(std::unordered_map<std::string, std::string> &vars, const std::string &name, int &input, const std::pair<int, int> &range) {
    int temp = input;
@@ -876,6 +1186,12 @@
    }
  }
  /**
   * @brief Convert common textual boolean forms to a boolean value.
   *
   * @param boolean Configuration string to classify as enabled or disabled.
   * @return True when the tested parser condition is met.
   */
  bool to_bool(std::string &boolean) {
    std::for_each(std::begin(boolean), std::end(boolean), [](char ch) {
      return (char) std::tolower(ch);
@@ -889,6 +1205,13 @@
           (std::find(std::begin(boolean), std::end(boolean), '1') != std::end(boolean));
  }
  /**
   * @brief Consume a boolean setting from the parsed configuration map.
   *
   * @param vars Parsed configuration entries; consumed keys are erased.
   * @param name Configuration key to consume.
   * @param input Destination field updated when the setting exists and parses successfully.
   */
  void bool_f(std::unordered_map<std::string, std::string> &vars, const std::string &name, bool &input) {
    std::string tmp;
    string_f(vars, name, tmp);
@@ -900,6 +1223,13 @@
    input = to_bool(tmp);
  }
  /**
   * @brief Consume a floating-point setting from the parsed configuration map.
   *
   * @param vars Parsed configuration entries; consumed keys are erased.
   * @param name Configuration key to consume.
   * @param input Destination field updated when the setting exists and parses successfully.
   */
  void double_f(std::unordered_map<std::string, std::string> &vars, const std::string &name, double &input) {
    std::string tmp;
    string_f(vars, name, tmp);
@@ -918,5 +1248,13 @@
    input = val;
  }
  /**
   * @brief Consume a floating-point setting only when it falls inside an inclusive range.
   *
   * @param vars Parsed configuration entries; consumed keys are erased.
   * @param name Configuration key to consume.
   * @param input Destination field updated when the setting exists and parses successfully.
   * @param range Inclusive range accepted for the parsed value.
   */
  void double_between_f(std::unordered_map<std::string, std::string> &vars, const std::string &name, double &input, const std::pair<double, double> &range) {
    double temp = input;
@@ -929,6 +1267,13 @@
    }
  }
  /**
   * @brief Consume a comma-separated or bracketed string list setting.
   *
   * @param vars Parsed configuration entries; consumed keys are erased.
   * @param name Configuration key to consume.
   * @param input Destination field updated when the setting exists and parses successfully.
   */
  void list_string_f(std::unordered_map<std::string, std::string> &vars, const std::string &name, std::vector<std::string> &input) {
    std::string string;
    string_f(vars, name, string);
@@ -968,6 +1313,13 @@
    }
  }
  /**
   * @brief Consume the JSON preparation-command list setting.
   *
   * @param vars Parsed configuration entries; consumed keys are erased.
   * @param name Configuration key to consume.
   * @param input Destination field updated when the setting exists and parses successfully.
   */
  void list_prep_cmd_f(std::unordered_map<std::string, std::string> &vars, const std::string &name, std::vector<prep_cmd_t> &input) {
    std::string string;
    string_f(vars, name, string);
@@ -994,6 +1346,13 @@
    }
  }
  /**
   * @brief Consume an integer list setting from decimal or hexadecimal configuration text.
   *
   * @param vars Parsed configuration entries; consumed keys are erased.
   * @param name Configuration key to consume.
   * @param input Destination field updated when the setting exists and parses successfully.
   */
  void list_int_f(std::unordered_map<std::string, std::string> &vars, const std::string &name, std::vector<int> &input) {
    std::vector<std::string> list;
    list_string_f(vars, name, list);
@@ -1027,6 +1386,13 @@
    }
  }
  /**
   * @brief Consume an integer-pair list into a mapping table.
   *
   * @param vars Parsed configuration entries; consumed keys are erased.
   * @param name Configuration key to consume.
   * @param input Destination field updated when the setting exists and parses successfully.
   */
  void map_int_int_f(std::unordered_map<std::string, std::string> &vars, const std::string &name, std::unordered_map<int, int> &input) {
    std::vector<int> list;
    list_int_f(vars, name, list);
@@ -1046,6 +1412,12 @@
    }
  }
  /**
   * @brief Apply single-character command-line flags to the global Sunshine flags bitset.
   *
   * @param line Configuration line being parsed.
   * @return 0 when all flags are recognized; -1 when at least one flag is unknown.
   */
  int apply_flags(const char *line) {
    int ret = 0;
    while (*line != '\0') {
@@ -1073,6 +1445,11 @@
    return ret;
  }
  /**
   * @brief Get supported gamepad options.
   *
   * @return Platform-supported gamepad backend names accepted by configuration.
   */
  std::vector<std::string_view> &get_supported_gamepad_options() {
    const auto options = platf::supported_gamepads(nullptr);
    static std::vector<std::string_view> opts {};
@@ -1083,6 +1460,9 @@
    return opts;
  }
  /**
   * @brief Log parsed configuration entries and optionally record them as modified.
   */
  void log_config_settings(const std::unordered_map<std::string, std::string> &vars, bool save) {
    for (auto &[name, val] : vars) {
      bool is_redacted = std::ranges::find(config::redacted_config, name) != config::redacted_config.end();
@@ -1095,5 +1475,10 @@
    }
  }
  /**
   * @brief Apply parsed configuration entries to the global runtime configuration.
   *
   * @param vars Parsed configuration entries; consumed keys are erased.
   */
  void apply_config(std::unordered_map<std::string, std::string> &&vars) {
    log_config_settings(vars, true);
@@ -1406,6 +1791,9 @@
    }
  }
  /**
   * @brief Parse serialized text into the corresponding runtime representation.
   */
  int parse(int argc, char *argv[]) {
    std::unordered_map<std::string, std::string> cmd_vars;
#ifdef _WIN32

@@ -17,40 +17,55 @@
namespace config {
  // Valid range for the packetsize limit
  constexpr int PACKETSIZE_MIN = 200;
  constexpr int PACKETSIZE_MIN = 200;  ///< Lowest accepted configured packet size in bytes.
  constexpr int PACKETSIZE_MAX = 65535;  ///< Highest accepted configured packet size in bytes.
  constexpr int PACKETSIZE_SMALL = 500;  ///< Conservative packet size used for low-MTU links.
  constexpr int PACKETSIZE_LARGE = 1456;  ///< Default large packet size that avoids common MTU fragmentation.
  constexpr int PACKETSIZE_MAX = 65535;
  constexpr int PACKETSIZE_SMALL = 500;
  constexpr int PACKETSIZE_LARGE = 1456;
  // track modified config options
  inline std::unordered_map<std::string, std::string> modified_config_settings;  ///< Configuration keys changed during the current parse or UI update.
  inline std::unordered_map<std::string, std::string> modified_config_settings;
  // sensitive values that should be redacted from logging
  /**
   * @brief Configuration keys whose values must be hidden in logs.
   */
  inline constexpr std::array redacted_config = {
    "csrf_allowed_origins"
  };
  /**
   * @brief Log configuration entries and optionally mark them for persistence.
   *
   * @param vars Parsed configuration entries to log.
   * @param save Whether modified configuration values should be written back to disk.
   */
  void log_config_settings(const std::unordered_map<std::string, std::string> &vars, bool save);
  /**
   * @brief Video encoder, capture, and color settings loaded from configuration.
   */
  struct video_t {
    // ffmpeg params
    /**
     * @brief Quantization parameter used by encoders where higher values trade quality for compression.
     */
    int qp;  // higher == more compression and less quality
    int hevc_mode;  ///< HEVC support mode advertised to clients.
    int hevc_mode;
    int av1_mode;
    int av1_mode;  ///< AV1 support mode advertised to clients.
    int min_threads;  // Minimum number of threads/slices for CPU encoding
    int min_threads;  ///< Minimum number of threads or slices for CPU encoding.
    struct {
      std::string sw_preset;
      std::string sw_tune;
      std::optional<int> svtav1_preset;
    } sw;
    } sw;  ///< Software encoder options.
    nvenc::nvenc_config nv;
    bool nv_realtime_hags;
    nvenc::nvenc_config nv;  ///< NVIDIA NVENC encoder settings.
    bool nv_realtime_hags;  ///< Enable the NVIDIA realtime HAGS workaround.
    bool nv_opengl_vulkan_on_dxgi;  ///< Prefer NVIDIA OpenGL/Vulkan-on-DXGI interop.
    bool nv_sunshine_high_power_mode;  ///< Request NVIDIA high-power mode for Sunshine.
    bool nv_opengl_vulkan_on_dxgi;
    bool nv_sunshine_high_power_mode;
    struct {
      int preset;
@@ -58,13 +73,13 @@
      int h264_coder;
      int aq;
      int vbv_percentage_increase;
    } nv_legacy;
    } nv_legacy;  ///< Legacy NVIDIA encoder options kept for config compatibility.
    struct {
      std::optional<int> qsv_preset;
      std::optional<int> qsv_cavlc;
      bool qsv_slow_hevc;
    } qsv;
    } qsv;  ///< Intel Quick Sync encoder options.
    struct {
      std::optional<int> amd_usage_h264;
@@ -80,34 +95,43 @@
      std::optional<int> amd_preanalysis;
      std::optional<int> amd_vbaq;
      int amd_coder;
    } amd;
    } amd;  ///< AMD AMF encoder options.
    struct {
      int vt_allow_sw;
      int vt_require_sw;
      int vt_realtime;
      int vt_coder;
    } vt;
    } vt;  ///< VideoToolbox encoder options.
    struct {
      bool strict_rc_buffer;
    } vaapi;
    } vaapi;  ///< VA-API encoder options.
    struct {
      int tune;  // 0=default, 1=hq, 2=ll, 3=ull, 4=lossless
      int rc_mode;  // 0=driver, 1=cqp, 2=cbr, 4=vbr
    } vk;
    } vk;  ///< Vulkan encoder options.
    std::string capture;  ///< Capture backend name selected by configuration.
    std::string encoder;  ///< Encoder backend name selected by configuration.
    std::string adapter_name;  ///< Display adapter name selected in configuration.
    std::string capture;
    std::string encoder;
    std::string adapter_name;
    std::string output_name;  ///< Display output name selected in configuration.
    std::string output_name;
    /**
     * @brief Display-device integration settings.
     */
    struct dd_t {
      /**
       * @brief Compatibility workarounds for display-device control.
       */
      struct workarounds_t {
        std::chrono::milliseconds hdr_toggle_delay;  ///< Specify whether to apply HDR high-contrast color workaround and what delay to use.
      };
      /**
       * @brief Selects how Sunshine prepares the active display before streaming.
       */
      enum class config_option_e {
        disabled,  ///< Disable the configuration for the device.
        verify_only,  ///< @seealso{display_device::SingleDisplayConfiguration::DevicePreparation}
@@ -116,52 +140,70 @@
        ensure_only_display  ///< @seealso{display_device::SingleDisplayConfiguration::DevicePreparation}
      };
      /**
       * @brief Selects how Sunshine chooses the stream display resolution.
       */
      enum class resolution_option_e {
        disabled,  ///< Do not change resolution.
        automatic,  ///< Change resolution and use the one received from Moonlight.
        manual  ///< Change resolution and use the manually provided one.
      };
      /**
       * @brief Selects how Sunshine chooses the stream display refresh rate.
       */
      enum class refresh_rate_option_e {
        disabled,  ///< Do not change refresh rate.
        automatic,  ///< Change refresh rate and use the one received from Moonlight.
        manual  ///< Change refresh rate and use the manually provided one.
      };
      /**
       * @brief Selects how Sunshine handles HDR state for the stream display.
       */
      enum class hdr_option_e {
        disabled,  ///< Do not change HDR settings.
        automatic  ///< Change HDR settings and use the state requested by Moonlight.
      };
      /**
       * @brief Single display mode remapping rule from configuration.
       */
      struct mode_remapping_entry_t {
        std::string requested_resolution;
        std::string requested_fps;
        std::string final_resolution;
        std::string final_refresh_rate;
        std::string requested_resolution;  ///< Resolution string requested by the client.
        std::string requested_fps;  ///< Refresh-rate string requested by the client.
        std::string final_resolution;  ///< Resolution string to apply after remapping.
        std::string final_refresh_rate;  ///< Refresh-rate string to apply after remapping.
      };
      /**
       * @brief Collection of display mode remapping rules.
       */
      struct mode_remapping_t {
        std::vector<mode_remapping_entry_t> mixed;  ///< To be used when `resolution_option` and `refresh_rate_option` is set to `automatic`.
        std::vector<mode_remapping_entry_t> resolution_only;  ///< To be use when only `resolution_option` is set to `automatic`.
        std::vector<mode_remapping_entry_t> refresh_rate_only;  ///< To be use when only `refresh_rate_option` is set to `automatic`.
      };
      config_option_e configuration_option;  ///< Display-preparation mode selected by configuration.
      config_option_e configuration_option;
      resolution_option_e resolution_option;
      resolution_option_e resolution_option;  ///< Resolution-selection mode selected by configuration.
      std::string manual_resolution;  ///< Manual resolution in case `resolution_option == resolution_option_e::manual`.
      refresh_rate_option_e refresh_rate_option;
      refresh_rate_option_e refresh_rate_option;  ///< Refresh-rate selection mode selected by configuration.
      std::string manual_refresh_rate;  ///< Manual refresh rate in case `refresh_rate_option == refresh_rate_option_e::manual`.
      hdr_option_e hdr_option;
      hdr_option_e hdr_option;  ///< HDR-selection mode selected by configuration.
      std::chrono::milliseconds config_revert_delay;  ///< Time to wait until settings are reverted (after stream ends/app exists).
      bool config_revert_on_disconnect;  ///< Specify whether to revert display configuration on client disconnect.
      mode_remapping_t mode_remapping;  ///< Display mode remapping rules grouped by automatic selection mode.
      mode_remapping_t mode_remapping;
      workarounds_t wa;
    } dd;
      workarounds_t wa;  ///< Display-device compatibility workarounds.
    } dd;  ///< Display-device integration settings.
    int max_bitrate;  // Maximum bitrate, sets ceiling in kbps for bitrate requested from client
    int max_bitrate;  ///< Maximum bitrate ceiling in kbps for bitrate requested from the client.
    double minimum_fps_target;  ///< Lowest framerate that will be used when streaming. Range 0-1000, 0 = half of client's requested framerate.
  };
  /**
   * @brief Audio capture and encoder settings loaded from configuration.
   */
  struct audio_t {
    std::string sink;  ///< Audio output device/sink to use for audio capture
    std::string virtual_sink;  ///< Virtual audio sink for audio routing
@@ -169,65 +211,86 @@
    bool install_steam_drivers;  ///< Install Steam audio drivers for enhanced compatibility
  };
  /**
   * @brief Encryption policy that always sends unencrypted video.
   */
  constexpr int ENCRYPTION_MODE_NEVER = 0;  // Never use video encryption, even if the client supports it
  /**
   * @brief Encryption policy that uses encrypted video only when the client supports it.
   */
  constexpr int ENCRYPTION_MODE_OPPORTUNISTIC = 1;  // Use video encryption if available, but stream without it if not supported
  /**
   * @brief Encryption policy that rejects clients without video encryption support.
   */
  constexpr int ENCRYPTION_MODE_MANDATORY = 2;  // Always use video encryption and refuse clients that can't encrypt
  /**
   * @brief Network stream settings shared by audio, video, and control channels.
   */
  struct stream_t {
    std::chrono::milliseconds ping_timeout;
    std::chrono::milliseconds ping_timeout;  ///< Timeout used when waiting for client ping responses.
    std::string file_apps;
    std::string file_apps;  ///< Path to the configured applications file.
    int fec_percentage;
    int fec_percentage;  ///< Percentage of forward-error-correction packets to add to the stream.
    // Video encryption settings for LAN and WAN streams
    int lan_encryption_mode;
    int wan_encryption_mode;
    int lan_encryption_mode;  ///< Video encryption policy for LAN clients.
    int wan_encryption_mode;  ///< Video encryption policy for WAN clients.
    // Limit the packetsize to avoid fragmentation on a low MTU link
    int packetsize;
    int packetsize;  ///< Maximum payload size for network packets.
  };
  /**
   * @brief HTTP and HTTPS settings used by the GameStream pairing server.
   */
  struct nvhttp_t {
    // Could be any of the following values:
    // pc|lan|wan
    std::string origin_web_ui_allowed;  ///< Origin policy used for Web UI access checks.
    std::string origin_web_ui_allowed;
    std::string pkey;
    std::string pkey;  ///< Private key PEM string or path.
    std::string cert;  ///< Certificate PEM string or path.
    std::string cert;
    std::string sunshine_name;
    std::string sunshine_name;  ///< Host name advertised to Moonlight clients.
    std::string file_state;
    std::string file_state;  ///< Path to the persisted Sunshine state file.
    std::string external_ip;
    std::string external_ip;  ///< External address advertised to clients when configured.
  };
  /**
   * @brief Input emulation settings loaded from configuration.
   */
  struct input_t {
    std::unordered_map<int, int> keybindings;  ///< Client keycode to platform keycode bindings.
    std::unordered_map<int, int> keybindings;
    std::chrono::milliseconds back_button_timeout;  ///< Hold duration that turns a controller Back button into a special action.
    std::chrono::milliseconds back_button_timeout;
    std::chrono::milliseconds key_repeat_delay;
    std::chrono::milliseconds key_repeat_delay;  ///< Delay before repeating a held keyboard key.
    std::chrono::duration<double> key_repeat_period;  ///< Interval between repeated keyboard key events.
    std::chrono::duration<double> key_repeat_period;
    std::string gamepad;
    bool ds4_back_as_touchpad_click;
    bool motion_as_ds4;
    bool touchpad_as_ds4;
    bool ds5_inputtino_randomize_mac;
    std::string gamepad;  ///< Virtual controller backend selected by configuration.
    bool ds4_back_as_touchpad_click;  ///< Map the DS4 Back button to a touchpad click.
    bool motion_as_ds4;  ///< Expose motion controls through the DS4 protocol.
    bool touchpad_as_ds4;  ///< Expose touchpad input through the DS4 protocol.
    bool ds5_inputtino_randomize_mac;  ///< Randomize the inputtino DualSense MAC address.
    bool keyboard;  ///< Enable keyboard input from clients.
    bool key_rightalt_to_key_win;  ///< Map the client Right Alt key to the Windows key.
    bool keyboard;
    bool key_rightalt_to_key_win;
    bool mouse;  ///< Enable mouse input from clients.
    bool controller;  ///< Enable controller input from clients.
    bool mouse;
    bool controller;
    bool always_send_scancodes;
    bool always_send_scancodes;  ///< Always send keyboard scancodes when available.
    bool high_resolution_scrolling;
    bool native_pen_touch;
    bool high_resolution_scrolling;  ///< Enable high-resolution mouse-wheel events.
    bool native_pen_touch;  ///< Enable native pen and touch injection.
  };
  namespace flag {
    /**
     * @brief Enumerates supported flag options.
     */
    enum flag_e : std::size_t {
      PIN_STDIN = 0,  ///< Read PIN from stdin instead of http
      FRESH_STATE,  ///< Do not load or save state
@@ -238,53 +301,75 @@
    };
  }  // namespace flag
  /**
   * @brief External preparation command plus its privilege requirement.
   */
  struct prep_cmd_t {
    /**
     * @brief Build a preparation command entry from parsed configuration data.
     *
     * @param do_cmd Command to run before the application starts.
     * @param undo_cmd Command to run after the application exits.
     * @param elevated Whether the command should run with elevated privileges.
     */
    prep_cmd_t(std::string &&do_cmd, std::string &&undo_cmd, bool &&elevated):
        do_cmd(std::move(do_cmd)),
        undo_cmd(std::move(undo_cmd)),
        elevated(std::move(elevated)) {
    }
    /**
     * @brief Build a preparation command entry from parsed configuration data.
     *
     * @param do_cmd Command to run before the application starts.
     * @param elevated Whether the command should run with elevated privileges.
     */
    explicit prep_cmd_t(std::string &&do_cmd, bool &&elevated):
        do_cmd(std::move(do_cmd)),
        elevated(std::move(elevated)) {
    }
    std::string do_cmd;  ///< Command to run before the application starts.
    std::string undo_cmd;  ///< Command to run after the application exits.
    bool elevated;  ///< Whether the process should be launched elevated.
    std::string do_cmd;
    std::string undo_cmd;
    bool elevated;
  };
  /**
   * @brief Top-level Sunshine configuration and credential state.
   */
  struct sunshine_t {
    std::string locale;
    int min_log_level;
    std::bitset<flag::FLAG_SIZE> flags;
    std::string credentials_file;
    std::string locale;  ///< Locale selected for Sunshine UI and log messages.
    int min_log_level;  ///< Minimum severity level written to the configured log sink.
    std::bitset<flag::FLAG_SIZE> flags;  ///< Runtime flags parsed from command-line options.
    std::string credentials_file;  ///< Path to the stored pairing credentials file.
    std::string username;  ///< Username for the local Web UI account.
    std::string password;  ///< Password hash or secret for the local Web UI account.
    std::string salt;  ///< Salt used when hashing the Web UI password.
    std::string username;
    std::string password;
    std::string salt;
    std::string config_file;  ///< Path to the active Sunshine configuration file.
    std::string config_file;
    /**
     * @brief Command-line options parsed before configuration loading.
     */
    struct cmd_t {
      std::string name;  ///< Executable name from the command line.
      int argc;  ///< Number of command-line arguments.
      char **argv;  ///< Command-line argument vector.
    } cmd;  ///< Command line used to launch the application.
      std::string name;
      int argc;
      char **argv;
    } cmd;
    std::uint16_t port;  ///< TCP port used by Sunshine services.
    std::uint16_t port;
    std::string address_family;
    std::string address_family;  ///< Address family requested for listening sockets.
    std::string bind_address;  ///< Local address Sunshine should bind to.
    std::string bind_address;
    std::string log_file;
    bool notify_pre_releases;
    bool system_tray;
    std::string log_file;  ///< Path to the configured log file.
    bool notify_pre_releases;  ///< Notify users about pre-release updates.
    bool system_tray;  ///< Enable the system tray integration.
    std::vector<prep_cmd_t> prep_cmds;  ///< Preparation commands executed around application launch.
    std::vector<prep_cmd_t> prep_cmds;
    // List of allowed origins for CSRF protection (e.g., "https://example.com,https://app.example.com")
    // Comma-separated list of additional origins. Default includes localhost variants and web UI port.
    std::vector<std::string> csrf_allowed_origins;
    std::vector<std::string> csrf_allowed_origins;  ///< Additional origins allowed by CSRF validation.
  };
  extern video_t video;
@@ -294,6 +379,19 @@
  extern input_t input;
  extern sunshine_t sunshine;
  /**
   * @brief Parse serialized text into the corresponding runtime representation.
   *
   * @param argc Number of command-line arguments.
   * @param argv Command-line argument vector.
   * @return 0 on success; nonzero when command-line or configuration parsing fails.
   */
  int parse(int argc, char *argv[]);
  /**
   * @brief Parse Sunshine configuration text into key-value entries.
   *
   * @param file_content Raw configuration file contents to parse.
   * @return Parsed configuration key-value entries.
   */
  std::unordered_map<std::string, std::string> parse_config(const std::string_view &file_content);
}  // namespace config