HOW TO Ludobox

Create your own Ludobox on a Raspberry Pi

What we will do

1. Setup a Raspberry Pi with WIFI
2. Install the Ludobox software
3. Start your Ludobox
4. Download Games
5. Make a custom Case

1. Prepare the Raspberry Pi

What you need

• 1 Raspberry Pi
• 1 Internet connection
• 1 SD Card
• 1 Linux computer with Internet and a SD card reader

Install the OS

Download the Raspbian Linux image

Copy the image to a SD card using the dd command

​​​​sudo dd bs=4M if=2017-01-11-raspbian-jessie-lite.img of=/dev/mmcblk0
​​​​sync

Enable SSH on your Raspberry Pi (add an ssh file to the /boot disk )

​​​​sudo touch /media/MY_CARD_ID/boot/ssh

MY_CARD_ID should be replaced by the partition ID of your card.

Configure a Wifi network

Read also the WIFI instructions from Raspberry Pi's official documentation

You need to edit a WIFI config file called wpa_supplicant.conf to add the password and name of your WIFI network.

​​​​sudo nano /media/MY_CARD_ID/etc/wpa_supplicant/wpa_supplicant.conf

hint: MY_CARD_ID should be replaced by the ID generated by the system when you mounted the SD card.

Add your WIFI network info to wpa_supplicant.conf

​​​​network={
​​​​ssid="My WIFI"
​​​​psk="mypassword"
​​​​key_mgmt=WPA-PSK
​​​​}

Test your wifi connection

​​​​ping ludobox.net

hint You can setup multiple networks - see this thread

OK we got the WIFI now

Connect to your Pi

There is two main ways to connect and input commands into a machine like Raspberry Pi :

• using screen and keyboard
• using your own machine via SSH connection

SSH Connection

Read also the SSH instructions from Raspberry Pi's official documentation

Find the Raspberry Pi's local IP on your router (sth like 192.169.1.XX)

Connect to your pi

​​​​ssh [e-mail] # your IP

The default password is raspberry

Update the system

Update everything

​​​​sudo apt-get update && sudo apt-get upgrade

Install Python, git and some softwares used to build dependencies

​​​​sudo apt-get install build-essential git python-pip python-dev

Configure your pi properly

Read also the raspi-config instructions from Raspberry Pi's official documentation

​​​​raspi-config

Hint You can expand the size of your filesystem to occupt the whole space of your card.

Fix language issue

​​​​export LANGUAGE=en_GB.UTF-8
​​​​export LANG=en_GB.UTF-8
​​​​export LC_ALL=en_GB.UTF-8
​​​​locale-gen en_GB.UTF-8
​​​​dpkg-reconfigure locales

Congrats ! Your Pi is now ready

2. Install the software

What you need

• 1 Raspberry Pi with Raspbian and WIFI connected
• 1 Internet connection

Setup your environment

Install Python virtualenv (why?)

​​​​sudo apt-get install python-virtualenv

Create a folder where you will install everything

​​​​mkdir MY_LOVELY_LUDOBOX_FOLDER

hint replace MY_LOVELY_LUDOBOX_FOLDER by your own folder name

Enter the new folder

​​​​cd MY_LOVELY_LUDOBOX_FOLDER

Create your virtual environment (called venv)

​​​​virtualenv venv

Get the code and install the software

Activate your virtual environment

​​​​source ./venv/bin/activate

Download the code using git

​​​​git clone https://github.com/ludobox/ludobox

Install the software

​​​​cd ludobox
​​​​./bin/install

Yay ! You have now installed your Ludobox properly

3. Start your Ludobox

What you need

• 1 Raspberry Pi with Ludobox installed

Just go into the folder where you did the install.

​​​​cd MY_LOVELY_LUDOBOX_FOLDER

Activate your virtual environment

​​​​source ./venv/bin/activate

Go into the code folder

​​​​cd ludobox

Start your box

​​​​ludobox start

You can access your box by using the local IP address displayed on the screen.

WARNING! You have to be connected to the same WIFI network as the box to be able to access it via this IP address.

Enjoy !

4. Download Games

What you need

• 1 running Ludobox
• 1 Internet connection

Click on the Download button in the Navbar. You can now see a list of all games available in the Ludobox database on box.ludobox.net.

To download the game you like into your own box, just click on the Download link.

Once the game has been downloaded to your box, it will be shown in yellow.

You can now start making your own copy or fork

4. Make a custom Case

What you need

• 1 Laser Cutter
• Scissors, paper, painting, etc

Download the blueprints to laser cut the box.

Customize as you wish !