🥧
pi dashboard
My blog post: Listening to Satellites with my Raspberry Pi
This is the monorepo for my Raspberry Pi dashboard!
It includes: a module system allows different features to be toggled on and off so you don't need my exact hardware setup. It also allows multiple Pis to use the same server.
-
🏠 a Windows 98 themed dashboard. -
📡 view the list of visible GPS satellites from a GPS hardware device. -
🖨️ receive printer messages to a POS58 compatible printer. -
🌡️ live temperature/humidity collected from an AMxx compatible sensor.
Run
Server
Toggle server modules in server/config.py.
-
Create a Heroku project.
-
Add a PostgreSQL database via the GUI.
-
Add a config var of
PWvia GUI. -
Deploy from this GitHub repository.
That's it. No migrations or other setup required.
For local development:
pip install -r requirements.txt
export FLASK_APP=wsgi:app ;python3.9 -m flask run
A SQLite database is automatically created and used instead of PostgreSQL. If no PW environment variable is provided, no password is required for client requests.
Client
The client is written with a Raspberry Pi in mind and has been tested with the latest Raspbian (v10) and the bundled Python 3 that comes with it.
Depending on what modules you've enabled in client/clientconfig.py you may need hardware connected and setup e.g. to use the sky module, your GPS device must be communicating with gpsd.
cd client/
pip install -r requirements.txt
sudo python3 poller.py https://your-url.herokuapp.com password_here
I run that last command on boot via /etc/rc.local.
Note: in the client config, I use sleep_at_night to put my Pi to sleep so it can sit on the Heroku free tier without using up all the monthly hours.
Tests
End to end tests that make sure the server + all mods are working correctly.
pip install -r requirements.txt
python -m pytest
License
Licensed MIT
68 Oct 14, 2022
15 Oct 8, 2022
59 Oct 24, 2022
52 Oct 16, 2022
10 Dec 23, 2022
51 Nov 21, 2022
2.8k Dec 30, 2022
29 Nov 30, 2022
238 Jan 8, 2023
3 Aug 02, 2022
111 Dec 31, 2022
4 Oct 19, 2022
33 Dec 28, 2022
436 Jan 01, 2023
645 Dec 25, 2022
2 Jan 11, 2022
3 Dec 16, 2022
1 Jan 24, 2022
4 Oct 18, 2022
1.2k Jan 04, 2023
16 Oct 22, 2022
1 Nov 09, 2021
6.7k Jan 07, 2023
1 Jan 30, 2022
1 Nov 14, 2021
20 Dec 31, 2022
105 Jan 07, 2023
7 Dec 15, 2022
671 Jan 05, 2023