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. **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** ### **Core Features**
#### **1. Real-Time CRS Calculation** #### **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. * 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. * All heavy computations (like trend chart) are run only on-demand.
---
### **Sensor/Hardware Adaptation** ### **Sensor/Hardware Adaptation**
* If the **heart rate sensor** is unavailable or disabled, the app uses step/activity stability only. * 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. * 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. * The app is robust to missing or partial data.
---
### **User Experience** ### **User Experience**
* **Always-on Clock:** Appears as the default watch face, with tap, button, or swipe to access stats and menu. * **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. * **Vivid, readable interface** with color themes and a clean, minimal design.
* **Alerts** for hydration and sleep transitions are gentle and non-intrusive. * **Alerts** for hydration and sleep transitions are gentle and non-intrusive.
---
### **Intended Users** ### **Intended Users**
@ -91,8 +84,6 @@
* Shift workers, travelers, or students seeking to track and align their biological clocks. * 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. * Users who want more than a step counter—actionable, science-based feedback on internal time.
---
### **How It Works** ### **How It Works**
1. **Collects step and (optionally) heart rate data** in real-time. 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. 4. **Presents key circadian health metrics** on the main watch face.
5. **Offers friendly reminders** and data export for deeper analysis. 5. **Offers friendly reminders** and data export for deeper analysis.
---
### **Technical Details** ### **Technical Details**
* **Code:** JavaScript (Espruino), optimized for Bangle.js 2 * **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. * **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. * **No dependencies:** Runs entirely on the watch—no phone, no cloud required.
---
## Author ## Author
Jakub Tencl, Ph.D. 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. Use of the patented method may be subject to licensing or permission.
For inquiries, contact the author. For inquiries, contact the author.
---
### **Summary** ### **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. 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.