Installation instructions

This page explains how to setup Ludo as a program on various supported operating systems.

On Windows (64 bit)

Installing Ludo on Windows should be easy.

1. Download the latest stable release from our web site https://ludo.libretro.com/ or from Github https://github.com/libretro/ludo/releases

2. Unzip the archive somewhere on your hard drive

3. Create a shortcut for ludo.exe if needed

4. Launch ludo.exe

On first launch, Windows will ask you if you really want to launch an executable you downloaded from Internet. Just click Open Anyway.

Portable mode on USB drives is not supported. Ludo will create files on under your main user directory in Windows.

Updating Ludo requires redoing all the steps above.

On Mac OS X (64 bit)

Installing Ludo on Mac OS X is also easy.

1. Download the latest stable release from our web site https://ludo.libretro.com/ or from Github https://github.com/libretro/ludo/releases

2. Open the .dmg file

3. Drag Ludo.app in your Applications folder

4. Find Ludo in your Applications and launch it

On first launch, OSX will ask you if you really want to open an app from internet, just click Open Anyway.

Updating Ludo require redoing all the steps above.

On Linux for 64bit PC

There are many ways to install Ludo on Linux, depending on the Linux distribution and the preferred method.

From the tarballs

1. Download the latest stable release from our web site https://ludo.libretro.com/ or from Github https://github.com/libretro/ludo/releases
2. Uncompress the .tar.gz somewhere

3. Double click on ludo

If Ludo doesn't launch, you might need to install the OpenAL library on your Linux.

Updating Ludo requires redoing all the steps above.

Using distribution package managers

Third party contributors maintain packages of Ludo for the major Linux distributions. These package managers will install all the required dependencies for you and take care of updates.

On Arch Linux or derivatives, use the AUR packages:

• https://aur.archlinux.org/packages/ludo-bin
• https://aur.archlinux.org/packages/ludo/

On Debian, Raspbian or Ubuntu, use the .deb packages from the latest Github release:

• https://github.com/libretro/ludo/releases

Using snap

You can use the snap package here https://snapcraft.io/ludo

Using flatpak

There is a flatpak repository here, but the package doesn't seem published yet https://github.com/pdureau/flatpak-manifests

On Raspberry Pi

This section assume you are using Raspbian.

1. Enable the experimental VC4 OpenGL support (Full KMS) in raspi-config.

2. Reboot

3. Download the latest stable release from our web site https://ludo.libretro.com/ or from Github https://github.com/libretro/ludo/releases
4. Uncompress the .tar.gz somewhere

5. Double click on ludo

If Ludo doesn't launch, you might need to install the OpenAL library on your Linux.

Updating Ludo requires redoing all the steps above.