Skip to content

A launcher and updater for running Moonlight-qt on LibreELEC.

License

Notifications You must be signed in to change notification settings

alpex8/plugin.program.moonlight-qt

 
 

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

68 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

LibreELEC (Matrix) 10.0 Moonlight launcher for the Raspberry Pi 4 and Generic x86_64 systems

A launcher and updater for running Moonlight on LibreELEC Raspberry Pi 4 systems and Generic x86_64 systems.

Background:

This Kodi addon-on was developed to enable Moonlight game streaming on LibreELEC systems. Since LibreELEC is a "just enough" distribution dependencies for Moonlight are missing, requiring some extra steps to get things running. A simple add-on lets you install and launch Moonlight from within Kodi and stream games from your PC to your LibreELEC device.

More info on Moonlight for the Raspberry Pi 4 specific can be found here: https://github.com/moonlight-stream/moonlight-docs/wiki/Installing-Moonlight-Qt-on-Raspberry-Pi-4

And for more general info about Moonlight: https://github.com/moonlight-stream/moonlight-qt

At the time of writing the only platform that support's Moonlight on a Raspberry Pi 4 without a running X-server seems to be Moonlight-qt.

Prerequisites:

  • Raspberry Pi 4 or a Generic x86_64 device with LibreELEC (Matrix) 10.0 installed, connected to local network via ethernet (preferred) or Wi-Fi
  • Gaming PC with Steam and Nvidia GeForce Experience installed, connected to local network via ethernet (preferred) or Wi-Fi
  • Enough temporary storage space on your LibreELEC device to install Moonlight (about 500 MB is needed)

Instructions:

1. Install this plugin.

  • Download plugin.program.moonlight-qt.zip and store it on your Kodi device.
  • In Kodi install Docker from the LibreELEC repository: Add-ons / Install from repository / LibreELEC Add-ons / Services / Docker
  • Reboot LibreELEC to ensure Docker works
  • Go to Add-ons / Install from zip file
  • Select plugin.program.moonlight-qt.zip

2. Start Moonlight

  • Navigate to Games -> Moonlight.
  • Start Moonlight from the Games menu.
  • The plugin will ask you to install Moonlight, choose yes and wait a few minutes.
  • When the plugin has finished installing, Moonlight wil launch it
  • Moonlight should start and scan for PC's with Gamestream enabled

3. Enable Nvidia Gamestream on your gaming PC

GeForce Experience/Settings/Shield/Gamestream (move slider to right)

Gamestream host pop-up

If your PC is not recognised you can try to turn it off and on again on your gaming PC.

4. Pair your gaming PC

Once your PC is recognised by Moonlight, you will be asked to enter a 4-digit code into Gamestream to pair Moonlight with Gamestream. When the pairing is finished you can use Moonlight to adjust settings for streaming and launch games. Exit Moonlight and you will be returned to Kodi.

5. Launch games from Kodi

Because Moonlight saves its configuration and image-cache to Kodi's storage you can now browse and start your games using the Games menu in Kodi by entering the "Moonlight" menu item. Remember that all games are displayed from local cache, so they are only updated when Moonlight connects to your gaming PC.

5. Updating

When you want to update Moonlight you can use the update menu in the add-on settings and press "Update Moonlight to the latest version". The plugin will update Moonlight and will notify you when it's finished.

What magic is happening in the background when installing and updating?

Raspberry 4

Essentially the plugin uses Docker to download Debian Buster and install Moonlight by automating the command's given on this page:
https://github.com/moonlight-stream/moonlight-docs/wiki/Installing-Moonlight-Qt-on-Raspberry-Pi-4
When that installation procedure has finished the plugin copies the needed executables and libraries from the Docker container and then destroys the container. The plugin can use the copied files to launch Moonlight from Kodi without the extra overhead from Docker.

Generic x86_64

Somewhat the same as the Pi 4 build but based on an AppImage Moonlight build. Extra libraries are injected into the AppImage.

Help, it doesn't work

You can always open an issue if Moonlight doesn't launch/update on a Raspberry Pi 4 or the game menu doesn't work. All configuration and streaming problems are probably related to Moonlight self, you can report that on their own GitHub page: https://github.com/moonlight-stream/moonlight-qt/issues

Thanks

Thanks to clarkemw and peetie2k for inspiration.
Thanks to Janne Hakonen for the Generic x86_64 work, great job!

TODO:

  • Maybe other platforms/distributions

About

A launcher and updater for running Moonlight-qt on LibreELEC.

Resources

License

Stars

Watchers

Forks

Packages

No packages published

Languages

  • Python 62.6%
  • Shell 27.9%
  • Dockerfile 9.5%