From b1901053b8fe1391e5b92b060a3e263ff799a745 Mon Sep 17 00:00:00 2001 From: MFAshby Date: Tue, 22 May 2018 09:59:48 +0100 Subject: Update README.md --- README.md | 30 +++++++++++++++++++++++++++--- 1 file changed, 27 insertions(+), 3 deletions(-) diff --git a/README.md b/README.md index 661588d..0c73710 100644 --- a/README.md +++ b/README.md @@ -1,11 +1,35 @@ -A pretty basic painting app for the Raspberry Pi Unicorn HD hat. -Allows multiple people to paint at once & updates in real time. +A painting webapp, controlling a [16x16 LED matrix](https://shop.pimoroni.com/products/unicorn-hat-hd). It allows multiple people to paint at once & updates in real time. + +This project includes the following components: +A [Go library](https://github.com/MFAshby/unicornpaint/tree/master/unicorn) for controlling the physical device +A [Go web server](https://github.com/MFAshby/unicornpaint/blob/master/Server.go) utilising websocket communication +A [React JS client application](https://github.com/MFAshby/unicornpaint/tree/master/src) +Distribution & deployment with [Docker](https://github.com/MFAshby/unicornpaint/blob/master/Dockerfile) + +Live example hosted at: +https://unicorn.mfashby.net + +Ensure SPI is enabled on your raspberry pi: +``` +sudo raspi-config nonint do_spi 0 +sudo reboot +``` Run with docker: ``` docker pull mfashby/unicornpaint docker run --device /dev/spidev0.0:/dev/spidev0.0 --publish 3001:3001 mfashby/unicornpaint ``` -Or clone the repository and use the example docker-compose.yml file to build & run + +Or download the [docker-compose](https://raw.githubusercontent.com/MFAshby/unicornpaint/master/docker-compose.yml) file and run with +``` +docker-compose up -d +``` + +Or install Go and run directly with +``` +go get github.com/ecc1/spi github.com/gorilla/websocket github.com/MFAshby/unicornpaint/unicorn +go run Server.go +``` ![alt text](https://github.com/MFAshby/unicornpaint/raw/master/Screenshot.png "Screenshot") -- cgit v1.2.3-ZIG