User Guide

• Tap + on the dashboard to create a new alarm.
• Set the time and select which days it should repeat.
• Add an optional label — it displays on the alarm screen when it fires, so you know why it’s going off.
• Toggle alarms on/off directly from the dashboard.
• View alarm history from the dashboard to see when alarms fired and which videos played.
• Track your alarm streak, weekly count, snooze rate, and average snoozes on the stats card.

Skip Dates

Mark specific dates to skip — holidays, days off, or one-time exceptions. The alarm silently skips those dates and fires normally on all other scheduled days. Open the alarm editor and tap "Skip Dates" to add dates with the date picker.

Interval Scheduling Pro

Not everything follows a weekly routine. Tap the "Every X days" chip to switch from day-of-week to interval mode:

• Enter how many days between each alarm (e.g. every 3 days, every 14 days).
• Pick a start date using the date picker.
• The app calculates the next occurrence automatically and shows it on the dashboard.

Interval mode and day-of-week mode are mutually exclusive — selecting one clears the other.

If you downgrade from Pro, extra alarms are greyed out — you can still delete them but not edit or toggle them.

These defaults apply to all alarms unless overridden. You'll find them in the Settings screen.

Channel	The YouTube channel to pull Shorts from (required)
Max Duration	How long each video plays before moving on (10–610s, or unlimited). Default: 180s
Player Volume	Playback volume percentage, in 5% increments (0–100%). Default: 100%
Max Replays	How many times a video replays if shorter than the duration (0–50). Default: 50
Videos per Alarm	How many Shorts play in sequence before auto-dismiss (1–10). Default: 1. Pro for more than 1.
Vibration	Whether the phone vibrates when the alarm fires. Default: on
Rising Volume	Starts quiet and ramps to full volume over 30 seconds. Default: off. Pro
Swipe Gestures	Enable left-swipe to snooze and down-swipe to dismiss on the alarm screen. Default: off
Max Snoozes	How many times you can snooze per alarm (0–5, 0 = unlimited). Default: 3. Pro
Snooze Duration	How long the first snooze lasts in minutes (1–30). Default: 10 min. Pro
Progressive Snooze	Each snooze becomes shorter by a configurable percentage, nudging you awake faster. Default: on. Pro
Snooze Reduction	Percentage each snooze shortens from the previous one (10–90%). Default: 30%. Pro

Each alarm has a "Playback Overrides" section in the alarm editor. This is the key to making each alarm unique.

How it works

• Every setting has a "Default" checkbox next to it.
• When Default is checked (the default state): the alarm uses the global setting from Settings. The slider/toggle is greyed out and shows the current global value for reference.
• When Default is unchecked: the slider/toggle becomes active and you can set a custom value just for this alarm.

What you can override per alarm

• Channel — play from a different channel than the global default
• Specific video URL — always play a particular Short
• Max Duration, Player Volume, Max Replays
• Videos per Alarm, Vibration, Rising Volume

The header shows "Playback Overrides (customized)" when any setting is overridden. The override section automatically expands when editing an alarm that has custom overrides.

Smart Snooze progressively shortens your snooze duration each time you hit snooze, nudging you awake faster instead of letting you snooze indefinitely.

How it works

Each snooze is shorter than the last by a configurable percentage. For example, with 10 minutes initial and 30% reduction:

1st snooze	10 min
2nd snooze	7 min
3rd snooze	5 min

Settings you can configure

• Snooze Duration — how long the first snooze lasts (1–30 minutes)
• Progressive Snooze — toggle the progressive reduction on or off
• Snooze Reduction — percentage each snooze shortens (10–90%)
• Max Snoozes — limit how many times you can snooze (0 = unlimited)

When progressive snooze is off, every snooze uses the full initial duration. The snooze button shows the exact time remaining and disables when you've reached the limit.

The dashboard shows a stats card that tracks your alarm habits over the past week.

Streak	Consecutive days you dismissed an alarm without snoozing.
This Week	Total non-snoozed alarms in the last 7 days.
Snoozed	Snooze rate as a percentage over the last 7 days.
Avg Snoozes	Average number of snoozes before each dismiss this week.

Stats update automatically based on your alarm history. Tap the history icon to see the full log of when alarms fired and which videos played.

Create or join friend groups to share your alarm performance in real time. Hold each other accountable by seeing who woke up, who snoozed, and who slept through.

Create a group	Generate a short invite code and share it with friends via any messaging app.
Join a group	Enter an invite code or tap a shared link to join instantly.
Shared metrics	Each member's alarm status (awake, snoozed, missed, slept through), current streak, longest streak, snooze rate, average wake time, and 7-day activity.
Privacy	Nothing is stored until you create or join a group. Leaving a group permanently removes your data from it.

Tap a friend's row to see their detailed stats and 7-day activity chart. Sign in with Google to get started — your display name is the only personal info shared.

The app requests only the permissions it needs to work reliably as an alarm clock.

Exact Alarms	Required for alarms to fire at the exact time you set.
Display Over Other Apps	Needed to show alarms over the lock screen.
Do Not Disturb Override	Ensures alarms sound even in DND mode.
Notifications	Shows an ongoing notification when an alarm is firing.
Internet	Fetches the latest Short from YouTube when the alarm fires.

No internet when the alarm fires

The app falls back to your device's default alarm tone within 15 seconds. Your alarm always goes off.

Alarm doesn't fire after reboot

All alarms are automatically rescheduled after a restart. Make sure the app has the Exact Alarms permission enabled.

Video is blocked or unavailable

The app automatically skips to the next newest Short from the channel. Pro users benefit from a backup playlist for seamless playback.

Alarm doesn't show over lock screen

Make sure "Display Over Other Apps" permission is granted in Settings → Permissions.

Alarm is silent in DND mode

Grant the "Do Not Disturb Override" permission in Settings → Permissions.