box

Give life to your old monitors with a Raspbery Pi!

Setup

• Flash Raspberry Pi OS Lite using Raspberry Pi Imager on your micro SD card.

• Boot up the Raspberry Pi and connect using SSH or Keyboard

• Install git and clone the repository:

  $ sudo apt-get update
  $ sudo apt-get install git
  $ git clone https://github.com/ish-u/box.git

• Install raylib with native mode (no X11)

  $ sudo apt install libdrm-dev libegl1-mesa-dev libgles2-mesa-dev libgbm-dev
  $ git clone https://github.com/raysan5/raylib.git
  $ cd raylib/src
  $ make PLATFORM=PLATFORM_DRM
  $ sudo make install
  $ sudo ldconfig

• Install libjpeg - required for Pillow to install

  $ sudo apt install libjpeg-dev

• Install uv

  $ curl -LsSf https://astral.sh/uv/install.sh | sh
  $ source "$HOME/.local/bin/env"

• Run!

  $ cd box
  $ chmod +x run.sh
  $ ./run.sh

• You can access the dashboard on http://HOSTNAME.local:1618 on any other device in your local network to switch skecthes

• Run on boot (optionally)

  • Create a box.service and paste the example service (replace USERNAME with your actual username)

    $ sudo nano /etc/systemd/system/box.service
    

    [Unit]
    Description=Box
    After=network.target
    
    [Service]
    Type=simple
    User=USERNAME
    WorkingDirectory=/home/USERNAME/box
    Environment="PATH=/home/USERNAME/.local/bin:/usr/local/bin:/usr/bin:/bin"
    ExecStart=/home/USERNAME/box/run.sh
    Restart=always
    RestartSec=10
    
    [Install]
    WantedBy=multi-user.target
    

  • Enable to boot

    $ sudo systemctl enable box.service

  • Start

    $ sudo systemctl start box.service

  • Stop

    $ sudo systemctl stop box.service

  • Check status

    $ sudo systemctl status box.service