# HOW TO Ludobox **Create your own [Ludobox](http://ludobox.net) on a Raspberry Pi** ![](https://i.imgur.com/T2QAkxX.jpg) ### 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](https://www.raspberrypi.org/downloads/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](https://www.raspberrypi.org/documentation/remote-access/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](https://www.raspberrypi.org/documentation/configuration/wireless/wireless-cli.md) 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](https://raspberrypi.stackexchange.com/questions/11631/how-to-setup-multiple-wifi-networks) OK we got the WIFI now :+1: ### 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](https://www.raspberrypi.org/documentation/remote-access/ssh/) 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 root@192.169.1.XX # your IP The default password is `raspberry` ### Update the system Update everything sudo apt-get update && sudo apt-get upgrade Install [Python](https://en.wikipedia.org/wiki/Python_(programming_language)), [git](https://en.wikipedia.org/wiki/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](https://www.raspberrypi.org/documentation/configuration/raspi-config.md) 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 :sunglasses: # 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?](http://python-guide-pt-br.readthedocs.io/en/latest/dev/virtualenvs/)) 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 :tada: # 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. ![](https://i.imgur.com/sqQ8OYW.png) **WARNING! You have to be connected to the same WIFI network as the box to be able to access it via this IP address.** ![](https://i.imgur.com/XFRNbri.png) Enjoy ! :joy: # 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](http://box.ludobox.net). ![](https://i.imgur.com/KrLA4hf.png) To download the game you like into your own box, just click on the *Download* link. ![](https://i.imgur.com/4AKgG1R.png) 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 :tropical_drink: :scissors: # 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 ! :art: