ZPUI health tracker app

This is a health tracker app for ZPUI, for tracking periodically-occuring events that might need to occur on a schedule. Simple example - brushing your teeth, washing your hair, or having a migraine. The UI is Fallout PipBoy-style. Try it out and see!

Features:

• Works on 320x240 and 400x240 screens, monochrome and color
• Skipping events and retroactive event marking
• Critical/warning alerts using Beepy/Blepis RGB LED (other alert sources to come)
• Event types ("spots") read from YAML config file, easy to manually edit
• Interactive time threshold setting in the UI
• Detailed logs in JSON with versioning, allowing history to be recreated completely from log files
• Soon, also interactive spot creation on the fly in the UI

How-to

git clone https://github.com/ZeroPhone/zpui-healthtracker
cd zpui-healthtracker
sudo python install.py # don't need to use sudo for emulator!

• To change the app, edit src/zpui_healthtracker/app.py; add other Python files etc. as needed.
• To install the app, run sudo python install.py. Omit sudo if you're installing the app into an emulator, for local development or otherwise.
• To load the app, run sudo systemctl restart zpui.service or use Restart ZPUI main menu entry. If you're using the emulator, just rerun python main.py.
• To update the app, just run git pull inside of this folder.
• To debug the app, run sudo journalctl -fu zpui.service, or see the output of python main.py if you're running the emulator.

Disclaimer: currently, ZPUI apps will run as root, unless you're running an emulator. Specifically, apps will be loaded as modules into the ZPUI systemd service, which is ran as root. Historically, this allows to make system management apps without permission roadblocks, but it might not be ideal for apps that don't require privileges, and it isn't great for debugging. As such, this model will change later on for security reasons, and you'll be notified when it does.

Report issues here!

Development/debugging

• Try and use ZPUI docs if anything's unclear - though please forgive me, because quite a few parts of those are yet to be updated
• If you're facing problems, feel free to reach out!

License

This work is dual-licensed under BSD and GPL 3.0 (or any later version). You can choose between one of them if you use this work.

SPDX-License-Identifier: Apache-2.0 OR GPL-3.0-or-later