REICAST(1)

NAME
reicast - The Sega Dreamcast Emulator.

SYNOPSIS
reicast [OPTIONS]... [IMAGE FILE]

DESCRIPTION
reicast is a multi-platform emulator for the Sega Dreamcast.

EXAMPLE COMMANDLINE

No command line options will start reicast and load all values from the config file.
    reicast

Override the image specified in the config file to load a specific image.
    reicast /path/to/your/image.gdi

Start reicast on X11 in full screen.
    reicast -config x11:fullscreen=1

CONFIG FILE

The config file for reicast can be found at:

    ~/.config/reicast/emu.cfg

VMU SAVE FILE

The VMU save files can be found at ~/.local/share/reicast/, by default reicast will create two VMU files for the first controller:

    ~/.local/share/reicast/vmu_save_A1.bin
    ~/.local/share/reicast/vmu_save_A2.bin

BIOS AND FLASH ROMS

reicast currently needs BIOS/Flash ROMs of the original Dreamcast. For copyright reasons it is not possible to distribute them bundled with reicast, so you have to dump them from your own Dreamcast. reicast will look for these files in:

    ~/.local/share/reicast/data/dc_boot.bin
    ~/.local/share/reicast/data/dc_flash.bin

If you do not supply these files, reicast will fall back to reios, an experimental replacement for the original Dreamcast BIOS. However, your experience might not be as stable and some feature might be missing (e.g. booting to the Dreamcast menu will NOT work).

CONTROLS

reicast uses the kernel event devices for capturing input. You can define the evdev device id in the config file:

    [input]
    evdev_device_id_1 = X
    evdev_mapping_1 = my_mapping.cfg

You can create your own mappings with the reicast-joyconfig tool. You should either put them into the "mappings" folder inside the reicast config directory. As an alternative, you can specify an absolute path (which has to begin with a leading slash "/"):

    [input]
    evdev_device_id_1 = X
    evdev_mapping_1 = /path/to/my_mapping.cfg

If you don't specify a mapping file, reicast will use one of the pre-defined mapping files (e.g. for Xbox 360 controllers). If the evdev input works for you, it's probably best to deactivate the legacy joystick API input:

    [input]
    joystick_device_id =-1

If your version of reicast is compiled against X11, you might want to disable the built-in X11 keyboard support:

    [input]
    enable_x11_keyboard = -1

GENERAL OPTIONS

-config section:option=value
    Temporarily override a value of the config file.

[IMAGE FILE]
    Load a specific image file. Although Reicast supports images in GDI, CHDv4 and CDI format, you should avoid CDI images since they often have issues. If no image is given on the command line, reicast will use the value of the "image" option in the "config" section of the config file.

AUTHOR

reicast is developed by a number of people. A list of contributors can be obtained at:
    https://github.com/reicast/reicast-emulator/graphs/contributors

Head over to reicast's git repository if you want to contibute:
    https://github.com/reicast/reicast-emulator

This is free software; you can redistribute it and/or modify it under the terms of the GNU Public License (Version 2).

SEE ALSO
reicast-joyconfig(1)