diff options
author | MFAshby <MFAshby@users.noreply.github.com> | 2018-05-22 09:59:48 +0100 |
---|---|---|
committer | GitHub <noreply@github.com> | 2018-05-22 09:59:48 +0100 |
commit | b1901053b8fe1391e5b92b060a3e263ff799a745 (patch) | |
tree | a9a2f936b512773ff147ae35e38bbbc2b12557d0 | |
parent | e0f421115d4319de7585726bac7973e52a34aa67 (diff) | |
download | unicornpaint-b1901053b8fe1391e5b92b060a3e263ff799a745.tar.gz unicornpaint-b1901053b8fe1391e5b92b060a3e263ff799a745.tar.bz2 unicornpaint-b1901053b8fe1391e5b92b060a3e263ff799a745.tar.xz unicornpaint-b1901053b8fe1391e5b92b060a3e263ff799a745.zip |
Update README.md
-rw-r--r-- | README.md | 30 |
1 files changed, 27 insertions, 3 deletions
@@ -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") |