How to compile Reicast on Linux

How to compile Reicast on Linux


1. Install dependencies (debian-like)

$ sudo apt-get install build-essential libasound2 libasound2-dev libegl1-mesa-dev libgles2-mesa-dev git


2. Download the source files:

$ git clone


3. Compile and install:

$ cd reicast-emulator/shell/linux/
$ make
$ sudo make install

It’s installed! The documentation can be read using the command: man reicast

4. Open the terminal and run the command:

$ reicast

The program will open and close quickly returning errors due to lack of Bios/Flash. This is just for the Reicast create the configuration files and paths automatically.

5. Download the bios/flash in:

The dc_bios.bin and dc_flash.bin files should be copied to: ~/.local/share/reicast/data/

6. The configuration of the joystick is with the command: reicast-joyconfig.

But before connecting your joystick run:

$ sudo apt-get install python-pip python-dev
$ sudo pip install evdev

Now connect your joystick and run:

$ mkdir -p ~/.config/reicast/mappings/
$ reicast-joyconfig -f ~/.config/reicast/mappings/controller_ps3.cfg

Enter the device ID when prompted.

fm4lloc@debian:~$ reicast-joyconfig
17: Sony PLAYSTATION(R)3 Controller (/dev/input/event17, usb-0000:00:13.0-1/input0)
Please enter the device id: 17

In my case, the control of Playstation3 was 17, yours may present another.
Keep responding if you want to use a particular joystick button (Y – yes or N – no). I said no to: digital pad 2, buttons C, D and Z when asked.

After mapping the joystick open the file ~/.config/reicast/emu.cfg and add the newly created configuration path and joystick ID.

evdev_device_id_1 = 17
evdev_mapping_1 = /home/your_user/.config/reicast/mappings/controller_ps3.cfg


7. Now start your games!

Compatibility list is available here -> Reicast_Compatibility_List – The list is not exhaustive, a lot of games have not been added, case of Shenmue I.

Currently reicast supports images in .CDI and .GDI format. The command to run the game is:

$ reicast /game_path/game.gdi


To start fullscreen use the -config option x11: fullscreen = 1

$ reicast -config x11:fullscreen=1 /game_path/jogo.gdi


You can also edit the emu.cfg file and assign the value 1 (one) to fullscreen. The resolution is also changed in emu.cfg

fullscreen = 1
height = 480
width = 640

Images of the emulator running.