Differences

This shows you the differences between two versions of the page.

--- systems:moonlight [2022/03/24 19:09] – Update to config section noting options can be applied via Advanced System Options from v34 electrickaibutsu
+++ systems:moonlight [2026/03/12 15:45] (current) – Reorg paragraphs to get 43 instructions earlier lbrpdx
@@ Line 1: / Line 1: @@
 <WRAP group>
 <WRAP round box twothirds column>
-{{ https://raw.githubusercontent.com/fabricecaruso/es-theme-carbon/master/art/logos/moonlight.svg?nolink&300 }}
+{{ https://raw.githubusercontent.com/fabricecaruso/es-theme-carbon/master/art/logos/moonlight.svg?nolink&400 }}
 ====== Moonlight Embedded ======
-[[https://moonlight-stream.org|Moonlight]] is an open source implementation of NVIDIAs GameStream protocol that lets you stream games from a PC with a NVIDIA graphics card to your Batocera box. It's a game streaming software similar to [[https://en.wikipedia.org/wiki/Steam_Link|Steam Link]], a piece of hardware that was discontinued in 2018 and that now lives as an Android/iPhone app.
+[[https://moonlight-stream.org|Moonlight]] is an open source game streaming host that lets you stream games from a PC with an supported GPU to your Batocera box. It's a game streaming software similar to [[https://en.wikipedia.org/wiki/Steam_Link|Steam Link]], a piece of hardware that was discontinued in 2018 and that now lives as an Android/iPhone app.
-Batocera uses [[https://github.com/irtimmer/moonlight-embedded|Moonlight Embedded]] which also works on embedded ARM devices like the Raspberry Pi.
+Up to Batocera 42, we used [[https://github.com/irtimmer/moonlight-embedded|Moonlight Embedded]] which also works on x86_64 & embedded ARM devices like the Raspberry Pi.
+Starting with Batocera 43, we switched to [[https://github.com/moonlight-stream/moonlight-qt|Moonlight-QT]].
 <WRAP center round important>
-If you run a current version of NVidia GeForce Experience, you need Batocera 32 to run Moonlight. The Moonlight protocol changes regularly, and you need to have a client version compatible with the GeForce Experience server.
+The Moonlight protocol changes regularly, and you need to have a client version compatible with the Sushine Streaming Server [[https://app.lizardbyte.dev/Sunshine/?lng=en#Download]].
 </WRAP>
@@ Line 35: / Line 37: @@
 These are the PC side prerequisites to enable Moonlight to fetch and stream your games:
-  * NVIDIA GeForce GTX/RTX 600+ series GPU
+  * AMD: VCE 1.0 or higher, see [[https://github.com/obsproject/obs-amd-encoder/wiki/Hardware-Support]]
-  * NVIDIA GeForce Experience (GFE) 2.1.1 or higher installed (Windows Desktop Only)
+  * Intel: VAAPI-compatible, see [[https://www.intel.com/content/www/us/en/developer/articles/technical/linuxmedia-vaapi.html]]
-  * 720p or higher display (or headless display dongle) connected to the GeForce GPU.
+  * Nvidia: NVENC enabled cards, see [[https://developer.nvidia.com/video-encode-and-decode-gpu-support-matrix-new]]
+  * AMD: Ryzen 3 or Intel: Core i3 or higher
+  * 4GB or more
+  * See [[https://docs.lizardbyte.dev/projects/sunshine/en/latest/about/overview.html#system-requirements]] for further details.
-If you are facing any issue, please take a look at the first topics inside [[https://github.com/moonlight-stream/moonlight-docs/wiki/Setup-Guide|Setup Guide]] at Moonlight wiki. They are focused on the installation at the PC site of this setup.
+It is recommended you get acquainted with the Sunshine User manual for the best experience - [[https://docs.lizardbyte.dev/projects/sunshine/en/latest/]]
-==== Initial pairing ====
+If you are facing any issue, also take a look at the first topics inside [[https://github.com/moonlight-stream/moonlight-docs/wiki/Setup-Guide|Setup Guide]] at Moonlight wiki. They are focused on the installation at the PC site of this setup.
+==== Install Sunshine on the PC side ====
+You need to install the Sunshine server on your gaming PC. This is the PC that will render the game assets and do all the heavy lifting. It will also compress the resulting video of the game played into a low-latency H.264 or HEVC video stream that will be sent to the Batocera Moonlight client. The Batocera Moonlight client only displays this content on the screen, and intercepts the controller actions to send them back to the Sunshine server.
+  - Download the Sunshine server corresponding to your gaming PC (they have Windows versions, both installer and portable, but also Linux packages for popular desktop Linux distributions, as well as Flatpak and Appimage versions).
+  - Launch Sunshine. Once the server is launched, you will see a message asking you to connect to a local URL to finish the configuration. Typically a URL like https://localhost:47990 -- don't forget to enable a security extension on your web browser if requested.
+  - choose a username (by default ''sunshine'') and a password. This will be required to login into the UI.
+==== Instructions for Batocera v43 and later ====
+=== Onto your Batocera machine: enable moonlight-qt and configure from the UI ===
+Moonlight requires a bit of manual configuration. In order to do that, you need to [[:access_the_batocera_via_ssh|connect to your Batocera with SSH.]]
+First, create a file ''Moonlight.moonlight'' in the ''moonlight'' rom directory.
+<code>
+# touch /userdata/roms/moonlight/Moonlight.moonlight
+</code>
+Reload your games in ES (from the UI: "Game Settings" -> "Update Gamelists") and then you can start "Moonlight" from the Moonlight system.
+On first launch, the Moonlight client will search for the Sunshine server(s) available on your network and present them. When a new server is found, it will present you with a code to enter in the Sunshine server to pair them together:
+{{ :systems:moonlight-qt.png?600 |}}
+==== Instructions for Batocera up to v42: initial pairing ====
+=== Onto your Batocera machine: initial pairing ===
 Moonlight requires a bit of manual configuration. In order to do that, you need to [[:access_the_batocera_via_ssh|connect to your Batocera with SSH.]]
-First, make sure your PC is up and running and on the same local network as your Batocera.
+First, make sure your PC with Sunshine is up and running and on the same local network as your Batocera machine.
 On Batocera box run:
@@ Line 57: / Line 91: @@
 </code>
-This command correctly discovered my PC running NVIDIA GeForce Experience with its IP address 10.0.0.72, but tells me I need to pair with it. Let's do it:
+This command correctly discovered my PC running Sunshine with its IP address 10.0.0.72, but tells me I need to pair with it.
+If you don't get an IP address, check you're on the same LAN or VLAN as the streaming server or you have inter-VLAN routing enabled.
+Although WAN connections are possible, it is not recommended.
+Now let's pair with it:
 <code>
@@ Line 65: / Line 103: @@
 </code>
-The PIN ''1234'' is an example, you'll get a different PIN in your setup. You have to enter this PIN in the GeForce Experience pop-up window of your PC running where it asks a PIN to connect a "SHIELD" device.
+The PIN ''1234'' is an example, you'll get a different PIN in your setup. You have to enter this PIN in the Sunshine Server PIN menu option of your server PC, once you are logged into the Sunshine configuration webpage.
 Once the PIN is entered on you PC you should see ''Succesfully paired'' on your Batocera terminal.
@@ Line 71: / Line 109: @@
 You can check that the connection is successful by typing ''moonlight list'' again in your Batocera terminal, you should now see the list of games installed on your PC.
-==== Moonlight initial configuration ====
+=== Moonlight initial configuration ===
 We now need to build the list of games we want to reference. In order to do so, enter the command:
@@ Line 92: / Line 130: @@
 You can also relaunch a new game scraping with the command ''batocera-moonlight scrape''.
 ==== Moonlight Configuration ====