2018-01-04 23:16:22 +01:00
[](https://opensource.org/licenses/mit-license.php)
[](https://snyk.io/test/github/sexybiggetje/pixdisp?targetFile=package.json)
2018-01-04 23:37:36 +01:00
[](https://codeclimate.com/github/sexybiggetje/pixdisp/maintainability)
2018-01-05 19:54:21 +01:00
[](https://codeclimate.com/github/sexybiggetje/pixdisp/test_coverage)
2018-01-05 19:37:25 +01:00
[](https://travis-ci.org/sexybiggetje/pixdisp)
2018-01-04 23:16:22 +01:00
2018-01-04 23:25:51 +01:00
A small application to drive LED matrix displays, such as the [Pimoroni Unicorn ](https://shop.pimoroni.com/?q=unicorn%20hat ), from nodejs. My intention is to create a digital graffiti/guestbook system and a general animation system. This is a project for fun, so if you have a feature just request it! Or add it and I'll review it. Social coding ftw.
2017-12-12 20:41:32 +01:00
2018-01-04 23:25:51 +01:00
Make sure you are on a recent nodejs version. Raspbian has an old version. Use [Nodesource ](https://github.com/nodesource/distributions ) ;).
2017-12-18 20:39:51 +01:00
2018-01-04 23:16:22 +01:00
Also, use a decent modern browser. I wrote recent syntax, so probably works best in Chrome 62+. Firefox is known to have some issues, Edge works, Safari is a PITA. Just wait for your browser to play catch up then with recent standards. If you dislike Chrome, you can put this trough Babel. But you're on your own there.
2018-01-04 01:59:19 +01:00
Copy config.example.json to config.json and pick a driver + display size.
2017-12-25 21:05:14 +01:00
2018-01-04 01:59:19 +01:00
execute:
2017-12-12 20:41:32 +01:00
2018-01-04 01:59:19 +01:00
npm install
nodejs pixdisp.js
2017-12-12 20:41:32 +01:00
2018-01-04 01:59:19 +01:00
Navigate to http://localhost:8080/
2017-12-12 20:41:32 +01:00
2017-12-28 10:29:50 +01:00
Matrix driver & Unicorn Hat HD driver inspired by https://github.com/vesteraas/node-unicornhathd
2018-01-05 18:25:27 +01:00
### Unit tests
This application has some unit tests, making use of [Jest ](http://facebook.github.io/jest/ ). Jest is configured as a dev dependency.
execute:
npm test
2018-01-07 09:48:51 +01:00
Some code linting practices and security tests can be executed by running the lint task:
npm run lint
2017-12-28 10:29:50 +01:00
### Drawing
2017-12-28 10:41:31 +01:00
2018-01-10 19:58:48 +01:00
Simple clicking on the canvas in the responsive webinterface makes things light up, when you press submit it will get sent to the device.
2017-12-28 10:29:50 +01:00
### Camera
2017-12-28 10:41:31 +01:00
The webinterface allows you to capture your camera and submit images from there.
### Webinterface
2018-01-04 01:59:19 +01:00
A simple web interface is included for drawing on the device. Defaults to port 8080.
2018-01-10 19:58:48 +01:00
### Coding
2018-01-10 20:10:01 +01:00
[](http://www.youtube.com/watch?v=4mPzOF_h1kQ) (Click for youtube)
2018-01-10 19:58:48 +01:00
With an advanced editor you can write simple animations in the browser using a secure sandboxed javascript. Documentation will follow here once the API is final.
