bryan
/
BangleApps
0
0
Fork 0
Code Issues Pull Requests Packages Projects Releases Wiki Activity

Update README.md

master
spycat111 2025-06-11 22:10:33 +02:00 committed by GitHub
parent 8d7fb2f99f
commit 01fb8a931b
No known key found for this signature in database
GPG Key ID: B5690EEEBB952194
1 changed files with 0 additions and 15 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

15
apps/crsclock/README.md
View File

@ -4,8 +4,6 @@
**Circadian Rhythm Clock** is an advanced wellness clock for Bangle.js 2 that estimates and visualizes your body’s internal circadian time and alignment. It calculates a personalized **Circadian Rhythm Score (CRS)** using your recent sleep timing, physical activity patterns, and (optionally) heart rate data. The app helps users monitor their biological rhythms, optimize their sleep, and maintain healthy light/activity habits—even on a device with limited sensors.
---
### **Core Features**
#### **1. Real-Time CRS Calculation**
@ -67,23 +65,18 @@
* Aggressively trims stored history to a set maximum (e.g., 200 entries) to ensure stability and prevent memory overflows.
* All heavy computations (like trend chart) are run only on-demand.
---
### **Sensor/Hardware Adaptation**
* If the **heart rate sensor** is unavailable or disabled, the app uses step/activity stability only.
* If **no light sensor** is present (default for Bangle.js 2), the app estimates “light exposure” as the number of hours the user is active during daytime, outside their sleep window.
* The app is robust to missing or partial data.
---
### **User Experience**
* **Always-on Clock:** Appears as the default watch face, with tap, button, or swipe to access stats and menu.
* **Vivid, readable interface** with color themes and a clean, minimal design.
* **Alerts** for hydration and sleep transitions are gentle and non-intrusive.
---
### **Intended Users**
@ -91,8 +84,6 @@
* Shift workers, travelers, or students seeking to track and align their biological clocks.
* Users who want more than a step counter—actionable, science-based feedback on internal time.
---
### **How It Works**
1. **Collects step and (optionally) heart rate data** in real-time.
@ -101,8 +92,6 @@
4. **Presents key circadian health metrics** on the main watch face.
5. **Offers friendly reminders** and data export for deeper analysis.
---
### **Technical Details**
* **Code:** JavaScript (Espruino), optimized for Bangle.js 2
@ -110,8 +99,6 @@
* **User interface:** Button/touch/swipe navigation, E.showMenu/E.showAlert for dialogs, custom clock face rendering.
* **No dependencies:** Runs entirely on the watch—no phone, no cloud required.
---
## Author
Jakub Tencl, Ph.D.
@ -126,8 +113,6 @@ Unless otherwise stated, this project is released under the MIT license.
Use of the patented method may be subject to licensing or permission.
For inquiries, contact the author.
---
### **Summary**
The Circadian Rhythm Clock transforms the Bangle.js 2 into a **bio-aware, personalized circadian dashboard**, guiding users toward better alignment with their biological clock and modern life.