Compiling on the Raspberry Pi (Raspbian Jessie)

Andrew Mickelson edited this page Nov 11, 2016 · 13 revisions

Steps to install Attract-Mode on Raspbian Jessie:

  • Create a build environment

    cd ~
    mkdir develop
  • Install "sfml-pi" and Attract-Mode dependencies

    sudo apt-get install cmake libflac-dev libogg-dev libvorbis-dev libopenal-dev libjpeg62-turbo-dev libfreetype6-dev  libudev-dev libfontconfig1-dev 
  • Download and build sfml-pi

    cd ~/develop
    git clone --depth 1 sfml-pi
    mkdir sfml-pi/build;cd sfml-pi/build
    cmake .. -DSFML_RPI=1 -DEGL_INCLUDE_DIR=/opt/vc/include -DEGL_LIBRARY=/opt/vc/lib/ -DGLES_INCLUDE_DIR=/opt/vc/include -DGLES_LIBRARY=/opt/vc/lib/
    sudo make install
    sudo ldconfig
  • Install (or download and build) FFmpeg

    • Method 1 (easiest): use provided packages (software video decoding only)
    sudo apt-get install libavutil-dev libavcodec-dev libavformat-dev libavfilter-dev libswscale-dev libavresample-dev 
    • Method 2: build FFmpeg with mmal support (hardware accelerated video decoding)
    cd ~/develop
    git clone --depth 1 git://
    cd ffmpeg
    ./configure --enable-mmal --disable-debug --enable-memalign-hack --enable-shared
    sudo make install
    sudo ldconfig
  • Download and build Attract-Mode

    cd ~/develop
    git clone --depth 1 attract
    cd attract
    make USE_GLES=1
    sudo make install

If all those steps worked, then it should be ready to go!

Additional Notes

  • Add the parameter "-j4" when you run make on a pi2 or pi3 to speed the build significantly
  • If you get image display corruption, try adding framebuffer_depth=32 to the config file in the /boot folder.

Forum Thread 1 Forum Thread 2

Alternative Attract-Mode version (X required)

While the above version is what is recommended, an alternative version of Attract-Mode that requires running the X environment can be created instead. In addition to the dependencies installed in the instructions above, you would also need to install the following:

sudo apt-get install libx11-dev libx11-xcb-dev libxcb-randr0-dev libxcb-image0-dev libxcb-util0-dev libxcb-ewmh-dev libxcb-keysyms1-dev libxcb-icccm4-dev libxrandr2 libxrandr-dev libgles2-mesa-dev

An instead of downloading and building "sfml-pi" above, follow these instructions instead:

cd ~/develop
it clone -b rpi sfml
mkdir sfml/build;cd sfml/build
cmake -DEGL_INCLUDE_DIR=/opt/vc/include -DEGL_LIBRARY=/opt/vc/lib/ -DFREETYPE_INCLUDE_DIR_freetype2=/usr/include -DFREETYPE_INCLUDE_DIR_ft2build=/usr/include/freetype2 -DGLES_INCLUDE_DIR=/opt/vc/include -DGLES_LIBRARY=/opt/vc/lib/ -DSFML_BCMHOST=1 -DSFML_OPENGL_ES=1 ..
sudo make install
sudo ldconfig

(Its possible you may need to patch some sfml libraries first from here )

Notes for RetroPie

If you don't use the sfml-pi version of SFML, then Attract mode will need an X environment to run (which RetroPie does not ship with)

to get it to work you can do

sudo apt-get install xinit

then to start attract mode you type xinit attract in the terminal