dashboard/README.md

87 lines
1.7 KiB
Markdown
Raw Normal View History

2021-08-23 18:39:09 +00:00
dashboard
=========
My dashboard, for my house. Display RSS feeds and other custom bits of info via
2021-12-18 23:25:03 +00:00
direct SDL2 calls.
2021-08-23 18:39:09 +00:00
Features/TODO
=============
2021-12-23 02:59:12 +00:00
- (DONE) Write straight to framebuffer (sdl2)
- (DONE) Display Weather ~~rss~~ json feed
- (DONE) Display Wifi qrcode
2021-08-23 18:39:09 +00:00
- Display plex currently playing
2021-12-23 02:59:12 +00:00
- Display camera feed
2021-08-23 18:39:09 +00:00
Depends on
==========
- sdl2
- stdlib
optional dependencies
---------------------
2021-10-02 18:14:58 +00:00
- Weather/RSS
- rapidxml
- libcurl
2021-08-23 18:39:09 +00:00
Building sdl2 on rpi
--------------------
2021-12-18 23:25:03 +00:00
2021-08-23 18:39:09 +00:00
Run in this order
```
sudo apt-get install libdrm-dev libgdm-dev
```
Next downlad the SDL source tarball
```
cd sdl-src
./configure --enable-video-kmsdrm
make -j4
sudo make install
```
compile the test.cpp file provided in ./tests . There should be output on the
screen as flashing. Feel free to change the desired graphics driver in the
raspberry pi config
2021-09-17 02:01:40 +00:00
Developing your own pannels
===========================
Refer to the
[development]
(DEVELOPMENT.md)
documentation
2021-08-23 18:39:09 +00:00
Usage
=====
To compile:
`make all`
To install:
`make install`
To uninstall:
`make uninstall`
Wifi
----
The makefile by default will call a script that will generate a wifi qr code
for you. You can add your SSID and password by editing the `WIFI_SSID` and
`WIFI_PASS` variables in the make file, or by calling the script yourself in
`./scripts`. You can cleanup the wifi image at any time by calling
`make clean-wifi`. Next time the executable is built it will regenerate the
image.
The qr code generation relies on the program `qrencode`. It can be installed on
2021-12-21 23:10:27 +00:00
any debian system using `sudo apt install qrencode`. By default the image has a
transparent background. If you would like a different background, you will need
to adjust wifi.cpp to adjust where it is located to your preference.