mirror of
https://github.com/LizardByte/Sunshine.git
synced 2025-01-29 18:32:38 +00:00
0b70d46bef
Some checks are pending
CI / GitHub Env Debug (push) Waiting to run
CI / Setup Release (push) Waiting to run
CI / Setup Flatpak Matrix (push) Waiting to run
CI / Linux Flatpak (push) Blocked by required conditions
CI / Linux ${{ matrix.type }} (-DSUNSHINE_BUILD_APPIMAGE=ON, 22.04, AppImage) (push) Blocked by required conditions
CI / Homebrew (${{ matrix.os_name }}-${{ matrix.os_version }}${{ matrix.release == true && ' (Release)' || '' }}) (macos, 12) (push) Blocked by required conditions
CI / Homebrew (${{ matrix.os_name }}-${{ matrix.os_version }}${{ matrix.release == true && ' (Release)' || '' }}) (macos, 13) (push) Blocked by required conditions
CI / Homebrew (${{ matrix.os_name }}-${{ matrix.os_version }}${{ matrix.release == true && ' (Release)' || '' }}) (macos, 14) (push) Blocked by required conditions
CI / Homebrew (${{ matrix.os_name }}-${{ matrix.os_version }}${{ matrix.release == true && ' (Release)' || '' }}) (ubuntu, latest) (push) Blocked by required conditions
CI / Homebrew (${{ matrix.os_name }}-${{ matrix.os_version }}${{ matrix.release == true && ' (Release)' || '' }}) (ubuntu, latest, true) (push) Blocked by required conditions
CI / Macports (macOS-${{ matrix.os_version }}) (12, true) (push) Blocked by required conditions
CI / Macports (macOS-${{ matrix.os_version }}) (13) (push) Blocked by required conditions
CI / Macports (macOS-${{ matrix.os_version }}) (14) (push) Blocked by required conditions
CI / Windows (push) Blocked by required conditions
CI Docker / Check Dockerfiles (push) Waiting to run
CI Docker / Setup Release (push) Blocked by required conditions
CI Docker / Lint Dockerfile${{ matrix.tag }} (push) Blocked by required conditions
CI Docker / Docker${{ matrix.tag }} (push) Blocked by required conditions
CodeQL / Get language matrix (push) Waiting to run
CodeQL / Analyze (${{ matrix.name }}) (push) Blocked by required conditions
Build GH-Pages / update_pages (push) Waiting to run
Co-authored-by: ReenigneArcher <42013603+ReenigneArcher@users.noreply.github.com>
77 lines
2.8 KiB
ReStructuredText
77 lines
2.8 KiB
ReStructuredText
Linux
|
|
=====
|
|
|
|
Hardware Encoding fails
|
|
-----------------------
|
|
Due to legal concerns, Mesa has disabled hardware decoding and encoding by default.
|
|
|
|
.. code-block:: text
|
|
|
|
Error: Could not open codec [h264_vaapi]: Function not implemented
|
|
|
|
If you see the above error in the Sunshine logs, compiling `Mesa`
|
|
manually, may be required. See the official Mesa3D `Compiling and Installing <https://docs.mesa3d.org/install.html>`__
|
|
documentation for instructions.
|
|
|
|
.. important:: You must re-enable the disabled encoders. You can do so, by passing the following argument to the build
|
|
system. You may also want to enable decoders, however that is not required for Sunshine and is not covered here.
|
|
|
|
.. code-block:: bash
|
|
|
|
-Dvideo-codecs=h264enc,h265enc
|
|
|
|
.. note:: Other build options are listed in the
|
|
`meson options <https://gitlab.freedesktop.org/mesa/mesa/-/blob/main/meson_options.txt>`__ file.
|
|
|
|
KMS Streaming fails
|
|
-------------------
|
|
If screencasting fails with KMS, you may need to run the following to force unprivileged screencasting.
|
|
|
|
.. code-block:: bash
|
|
|
|
sudo setcap -r $(readlink -f $(which sunshine))
|
|
|
|
.. note:: The above command will not work with the AppImage or Flatpak packages.
|
|
Please refer to the :ref:`Setup guide <about/setup:Install>` for more
|
|
specific instructions.
|
|
|
|
KMS streaming fails on Nvidia GPUs
|
|
----------------------------------
|
|
If KMS screen capture results in a black screen being streamed, you may need to
|
|
set the parameter ``modeset=1`` for Nvidia's kernel module. This can be done by
|
|
adding the following directive to the kernel command line:
|
|
|
|
.. code-block::
|
|
|
|
nvidia_drm.modeset=1
|
|
|
|
Consult your distribution's documentation for details on how to do this. (Most
|
|
often grub is used to load the kernel and set its command line.)
|
|
|
|
AMD encoding latency issues
|
|
---------------------------
|
|
If you notice unexpectedly high encoding latencies (e.g. in Moonlight's
|
|
performance overlay) or strong fluctuations thereof, this is due to
|
|
`missing support <https://gitlab.freedesktop.org/drm/amd/-/issues/3336>`_
|
|
in Mesa/libva for AMD's low latency encoder mode. This is particularly
|
|
problematic at higher resolutions (4K).
|
|
|
|
Only the most recent development versions of mesa include support for this
|
|
low-latency mode. It will be included in Mesa-24.2.
|
|
|
|
In order to enable it, Sunshine has to be started with a special environment
|
|
variable:
|
|
|
|
.. code-block:: bash
|
|
|
|
AMD_DEBUG=lowlatencyenc sunshine
|
|
|
|
To check whether low-latency mode is being used, one can watch the ``VCLK`` and
|
|
``DCLK`` frequencies in ``amdgpu_top``. Without this encoder tuning both clock
|
|
frequencies will fluctuate strongly, whereas with active low-latency encoding
|
|
they will stay high as long as the encoder is used.
|
|
|
|
Gamescope compatibility
|
|
-----------------------
|
|
Some users have reported stuttering issues when streaming games running within Gamescope.
|