Raspberry Pi
====================

Please use Raspberry Pi OS Bookworm.  Bullseye should also work.  Older OSes are not tested.

Option 1: Binary wheel
----------------------

We have published binary wheels compiled for 64-bit Raspberry OS Bullseye in X11 mode.

::

    python -m pip install --break-system-packages raylib

If it doesn't work, or you're not on Bullseye, or you're 32 bit, or if you want to use Raylib in ``PLATFORM_DRM`` mode, you will need to compile your own raylib.  See below.
For full instructions on this, see https://github.com/raysan5/raylib/wiki/Working-on-Raspberry-Pi .  If you need help with this ask Raylib.

Option 2: Compile Raylib from source X11 mode
---------------------------------------------

This should work for everyone.

::

    sudo apt update
    sudo python3-pip cmake libegl1-mesa-dev libgbm-dev libgles2-mesa-dev libdrm-dev libglfw3-dev
    git clone https://github.com/raysan5/raylib.git --branch 5.0 --single-branch
    cd raylib
    mkdir build
    rm -rf build/*
    cd build
    cmake -DPLATFORM="Desktop" -DOPENGL_VERSION=2.1 -DBUILD_EXAMPLES=OFF -DCUSTOMIZE_BUILD=ON -DSUPPORT_FILEFORMAT_JPG=ON -DSUPPORT_FILEFORMAT_FLAC=ON -DWITH_PIC=ON -DCMAKE_BUILD_TYPE=Release ..
    make
    sudo make install
    sudo cp -r ../src/external/glfw/include/GLFW /usr/local/include/

Then have pip compile and install the wheel:

::

    python -m pip install --break-system-packages setuptools
    python -m pip install --no-cache-dir --no-binary raylib --upgrade --force-reinstall --break-system-packages raylib==5.0.0.3

Option 3: Compile Raylib from source DRM mode
---------------------------------------------

This seems to work on Raspberry Pi 4.  Note you must not be running X11 when you run your programs.

::

    sudo apt update
    sudo python3-pip cmake libegl1-mesa-dev libgbm-dev libgles2-mesa-dev libdrm-dev libglfw3-dev
    git clone https://github.com/raysan5/raylib.git --branch 5.0 --single-branch
    cd raylib
    mkdir build
    rm rf build/*
    cd build
    cmake -DPLATFORM="DRM" -DBUILD_EXAMPLES=OFF -DCUSTOMIZE_BUILD=ON -DSUPPORT_FILEFORMAT_JPG=ON -DSUPPORT_FILEFORMAT_FLAC=ON -DWITH_PIC=ON -DCMAKE_BUILD_TYPE=Release ..
    make
    sudo make install
    sudo cp -r ../src/external/glfw/include/GLFW /usr/local/include/
    
Then have pip compile and install the wheel with some extra linker flags:

::

    python -m pip install --break-system-packages setuptools
    LDFLAGS="-lgbm -ldrm -lEGL" pip3 install --no-cache-dir --no-binary raylib --upgrade --force-reinstall --break-system-packages raylib==5.0.0.3




.. attention::

    If you intend to use the Broadcom proprietary Open GL ES 2.0 drivers (the ones installed by Raspbian into ``/opt/vc`` and compiled in Raylib
    with ``PLATFORM_RPI``) be aware they not work with Bullseye and have not been tested with the bindings.  They will probably
    require additional linker arguments to be added to ``build.py``.  Suggest you try ``PLATFORM_DRM`` instead.