Alarms, Developers, Services, General, UX, Devices update

Author: rl885

Gemfile.lock

@@ -89,6 +89,8 @@ GEM
     rexml (3.2.6)
     rouge (4.4.0)
     safe_yaml (1.0.5)
+    sass-embedded (1.80.3-x64-mingw-ucrt)
+      google-protobuf (~> 4.28)
     sass-embedded (1.80.3-x64-mingw32)
       google-protobuf (~> 4.28)
     sass-embedded (1.80.3-x86_64-linux-gnu)
@@ -106,9 +108,11 @@ GEM
     tzinfo-data (1.2023.4)
       tzinfo (>= 1.0.0)
     unicode-display_width (2.6.0)
+    wdm (0.1.1)
     webrick (1.8.1)
 
 PLATFORMS
+  x64-mingw-ucrt
   x64-mingw32
   x86_64-linux
 
@@ -127,6 +131,7 @@ DEPENDENCIES
   slim (~> 3.0.7)
   thread_safe (~> 0.3.5)
   tzinfo-data
+  wdm (~> 0.1.0)
   webrick (~> 1.7)
 
 BUNDLED WITH

assets/icons/trophy.svg

@@ -8,56 +8,48 @@ tags:
 - backup
 ---
 
+**The Backup Alarm is a fail-safe feature that triggers a loud, maximum-volume alarm if you ignore your primary alarm.**
 
-**Starts ringing loudly at maximum volume if you ignore your normal alarm.**
+This ensures that even if you are an exceptionally heavy sleeper or accidentally sleep through your regular ringtone, you won't miss your wake-up call.
 
-Backup alarm will start after [Alarm timeout](#alarm-timeout).
-
-_Settings -> Alarms -> Backup alarm_
+**Menu Path:** `Settings` → `Alarms` → `Backup alarm`
 
 ---
 
+## Core Options
 
+### Backup Alarm Duration
+Sets how long the backup alarm will ring. Once this duration expires, the alarm will automatically snooze for your default *Snooze Time* (but never less than 10 minutes).
 
+### Ringtone
+Choose the sound for your backup alarm.
 
-## Backup alarm duration
-
-Set how long the backup alarm will ring (it will then snooze for your default _Snooze Time_, but never less than 10 minutes).
-
-
-## Ringtone
-
-Backup alarm ringtone.
-
-
-### How to disable backup alarm <a id="backup_disable"></a>
-1. Go to _Settings -> Alarm default settings -> Back up -> Sound_.
-1. Set the ringtone to _Silent_.
-> **Note:** Silent ringtone for backup alarm won't disable vibrations. The backup alarm is the last thing to let you know that the alarm is still going off, so you can react and not fall asleep.
-
+> [!NOTE]
+> **How to disable the backup alarm:** <a id="backup_disable"></a>
+> 1. Go to `Settings` → `Alarms` → `Backup alarm` → `Sound`.
+> 2. Set the ringtone to **Silent**.
+>
+> *Note:* Selecting a silent ringtone for the backup alarm will **not** disable vibrations. The backup alarm is designed as a last resort to ensure you wake up.
 
-## Alarm timeout <a id="alarm-timeout"></a>
+### Alarm Timeout <a id="alarm-timeout"></a>
+Defines the period of inactivity (ignoring the normal alarm) after which the backup alarm will trigger.
 
-Time after which the backup alarm will ring if you ignore your normal alarm.
+### Repeat
+Sets the maximum number of times the backup alarm can repeat its cycle. After this limit is reached, no further alarms will sound for that session.
 
+---
 
-## Repeat
-
-Maximum number of times the alarm can be repeated. After that, no alarm will ring.
-
-
-[EXAMPLE]
-
-#### Alarm time: 7:00
-
-Backup alarm duration: 2 minutes
-Alarm timeout: 10 minutes
-This is what happens if you don't interact with the alarm:
-
-- 7:00 – alarm starts
-- 7:10 – backup alarm starts (full volume, duration 2 minutes)
-- 7:12 – automatically snoozes (for 10 minutes, as your default snooze time is 10 minutes)
-- 7:22 – backup alarm starts again
-
-…and so on, based on the number of repetitions.
-====
+## How it Works (Example)
+
+> **Example:**
+> *   **Primary Alarm Time:** 7:00 AM
+> *   **Backup Alarm Duration:** 2 minutes
+> *   **Alarm Timeout:** 10 minutes
+>
+> **Timeline of events (if no interaction):**
+> 1.  **7:00 AM:** Primary alarm starts ringing.
+> 2.  **7:10 AM:** Primary alarm times out; the **Backup Alarm** starts (full volume).
+> 3.  **7:12 AM:** Backup alarm finishes its 2-minute duration and automatically snoozes for 10 minutes.
+> 4.  **7:22 AM:** Backup alarm starts again.
+>
+> This cycle continues until you dismiss the alarm or reach the maximum number of repeats.

hugo/content/alarms/alarm_settings.md

@@ -8,70 +8,107 @@ redirect_from:
 - /sleep/bedtime_notification.html
 ---
 
+Maintaining a consistent sleep schedule is one of the most effective ways to feel rested and eliminate sleep debt. **Bedtime Notifications** send you a friendly *"Time to go to bed!"* reminder so you have enough time to wind down and get ready for sleep.
 
-**Sends you a "Time to go to bed!" notification before bedtime.**
 
-Bedtime notification is an effective way to maintain optimal sleep duration or to combat sleep deficit. You can set the alert to go off anywhere from 5 minutes to 2 hours before bedtime, so you'll have plenty of time to get ready for bed.
+## How to Access Bedtime Notification Settings
+* **Global Default Settings:** Go to `Settings` ➔ `Alarms` ➔ `Bedtime notification`.
+* **Per-Alarm Settings:** Open any individual alarm ➔ `Alarm settings` ➔ `Bedtime notification`.
 
-_Settings -> Alarms -> Bedtime notification_
-_per-alarm settings -> Bedtime notification_
-> **Note:** The time of your bedtime is calculated as follows:
-`bedtime = next alarm time – daily sleep duration goal`
-[EXAMPLE]
-You have set your [Daily sleep duration goal](#duration_goal) to 7 hours, and an alarm for 6 AM.
-Your bedtime would be 11 PM.
+## How Bedtime is Calculated
 
+By default, your recommended bedtime is determined using a simple formula:
 
----
+{{< katex display=true >}}
+\text{Bedtime} = \text{Next Alarm Time} - \text{Daily Sleep Duration Goal}
+{{< /katex >}}
+
+> [!NOTE]
+> **Example:** If your alarm is set for **6:00 AM** and your **Sleep Duration Goal** is **7 hours**, your calculated bedtime is **11:00 PM**. If you set your notification to trigger **30 minutes before bedtime**, you will receive a reminder at **10:30 PM**.
 
 
+## Core Options & Configuration
 
+| Option | Description |
+| :--- | :--- |
+| **Bedtime Notification** | Enables or disables the reminder and sets how long *before* bedtime you want to be alerted (from 5 minutes up to 2 hours in advance). |
+| **Sleep Duration Goal** | Your ideal target sleep duration per night. This value directly impacts bedtime calculations and sleep deficit statistics. |
+| **Repeat** | Sets how often the reminder alerts you. For example, selecting *10 Minutes Repeat* alerts you at the scheduled time and repeats every 10 minutes until you start sleep tracking or dismiss the notification. |
+| **Smart Bedtime** | Automatically fine-tunes your notification time based on recent sleep debt, smart wake-up windows, and initial tracking delays. |
+| **Per-Alarm Bedtime Notification** | Overrides your default settings for specific alarms or polyphasic sleep schedules (e.g., individual naps). |
 
-## Bedtime notification
 
-Enable bedtime notification and set how long before bedtime you want to receive them.
+## Sleep Duration Goals by Age
 
+The ideal amount of daily sleep varies by age group. Recommended targets based on Mayo Clinic guidelines include:
 
-## Sleep duration goal <a id="duration_goal"></a>
+* **General / Healthy Adults:** 7 – 9 hours
+* **Elderly:** 6 – 9 hours
+* **Young Adults:** 7 – 9 hours
+* **Teenagers:** 8 – 10 hours
+* **School-Age Children:** 9 – 11 hours
 
-Daily sleep duration goal is your target sleep duration - how much time would you ideally want to sleep each night.
+> [!TIP]
+> If you provide your age under `Settings` ➔ `Stats`, the app automatically adjusts your target ideal sleep score calculations accordingly.
 
-Daily sleep duration is influenced by:
 
-- [bedtime notification](/alarms/bedtime_notification)
-- counting of your [sleep deficit](/sleep/charts#deficit)
+## Smart Bedtime
 
+When **Smart Bedtime** is enabled, the app dynamically adjusts your bedtime reminder using your recent sleep history.
 
-The ideal daily amount of sleep for healthy adults is 7-9 hours, according to link:[Mayo Clinic](https://www.mayoclinic.org/healthy-lifestyle/adult-health/expert-answers/how-many-hours-of-sleep-are-enough/faq-20057898).
+It takes into account:
+1. **Sleep Deficit:** Extra sleep debt accumulated over the past 5 days.
+2. **Smart Wake Window:** Average length of your Smart Wake-Up period.
+3. **Tracking Delay:** The default pause/delay before sleep tracking begins.
 
-In the app the sleep score uses your age (if provided in  _Settings -> Stats_) to adjust the ideal sleep times for the [Sleep score](/sleep/sleepscore) stats.
-- **General**: 6.5 - 9 hours
-- **School age**: 9 - 11 hours
-- **Teenager**: 8 - 10 hours
-- **Young**: 7 - 9 hours
-- **Elderly**: 6 - 9 hours
-> **Note:** For biphasic and polyphasic sleep goals of individual naps, see the [Polyphasic sleeping schedule](/alarms/polyphasic) chapter.
+### The Smart Bedtime Formula
+{{< katex display=true >}}
+\text{Smart Bedtime} = \text{Next Alarm} - \text{Sleep Goal} - \text{Smart Period} - \text{Delayed Tracking} - \text{Deficit Adjustment}
+{{< /katex >}}
 
+*(If your 5-day average sleep deficit exceeds 10 minutes, the app automatically gives you up to a 45-minute head start on bedtime!)*
 
-## Repeat
+## Polyphasic Sleep & Per-Alarm Overrides
 
-How often to repeat the notification.
+If you follow a biphasic or polyphasic sleep schedule, a single daily sleep goal isn't enough.
 
-[EXAMPLE]
-10 Minutes Repeat will notify you once at notification time and then every 10 minutes until you dismiss the notification away or start sleep tracking.
+You can set custom bedtime notifications for individual naps:
+1. Open the specific alarm.
+2. Tap the **Bedtime notification** section and uncheck **Application settings**.
+3. Set a specific **sleep duration goal** for that nap (from 20 minutes to 13.5 hours).
+4. Adjust the notification timing and tap **Save**.
 
+For more details on Polyphasic sleep schedule support, please visit the [Polyphasic sleeping chapter](/alarms/polyphasic).
 
-## Smart bedtime
+## ❓ FAQs & Troubleshooting
 
+<details>
+<summary><strong>Why did my bedtime notification appear at a strange or unexpected time?</strong></summary>
 
-When enabled, Smart Bedtime adjusts the notification time based on your sleep loss over the past 5 days, the average length of the Smart Wake period, and the default pause time at the start of sleep tracking. The exact formula is
+* **Smart Bedtime Deficit Adjustment:** If **Smart Bedtime** is enabled, the app calculates your 5-day average sleep deficit. If you have accumulated sleep debt (over 10 minutes on average), it will schedule your bedtime up to **45 minutes earlier** to help you catch up.
+* **Smart Wake & Tracking Delays:** Smart Bedtime also subtracts your Smart Wake-Up window and configured tracking start delay from the bedtime calculation.
+* **Fix:** If you prefer fixed notifications, disable **Smart Bedtime** under `Settings` ➔ `Alarms` ➔ `Bedtime notification`.
+</details>
 
-[EXAMPLE]
-smart time to bed = next alarm – daily sleep duration goal – smart period – delayed tracking – in(5 days average sleep deficit > 10 min, 45 min)
+<details>
+<summary><strong>Why didn't my bedtime notification appear at all?</strong></summary>
 
+* **Sleep Surplus Detected:** If Smart Bedtime is active and you have a sleep surplus (no sleep debt accumulated), the notification may trigger later or not at all if you already met your target duration.
+* **Tracking Already Started:** If you manually start sleep tracking before the bedtime notification is scheduled to ring, the app automatically suppresses the alert.
+* **System Notification Settings:** Android may be blocking app notifications. Verify that alerts are turned on under your device's `System Settings` ➔ `Apps` ➔ `Sleep` ➔ `Notifications` ➔ `Bedtime notification`.
+* **Battery & System Optimizations:** Third-party battery savers or system task killers can suppress background notifications. Make sure Sleep as Android is excluded from aggressive battery optimization on your device.
+</details>
 
+<details>
+<summary><strong>How do I test if my bedtime notifications are working?</strong></summary>
 
-## Per-alarm bedtime notification
+To perform a verification:
+1. Temporarily set your Bedtime Notification to **5 minutes before bedtime**.
+2. Set a test alarm time to equal your **Sleep Goal + 8 minutes**.
+3. Wait **3 minutes** for the notification to trigger.
+4. If it fails to appear, send us an application log via `Left ≡ Menu` ➔ `Support` ➔ `Report a bug`.
+</details>
 
-A special case of bedtime notifications for polyphasic sleeping schedules (see [Polyphasic sleeping schedule](/alarms/polyphasic)).
+---
 
+*For further assistance or bug reports, open the app menu ☰ ➔ **Support** ➔ **Report a bug**.