User Guide

1. App Overview

WakeUp 2day is organized into 5 main tabs at the bottom of the screen:

• Clock — Beautiful animated clock with weather and alarm countdown
• Alarms — Create and manage your alarms
• Timer — Timer and stopwatch tools
• Sleep — Sleep tracking, history, and insights
• Settings — Configure all app features

Tap any tab to switch between sections. The app remembers your last used tab when you reopen it.

2. Clock Display & Weather

The Clock tab is your main screen — a beautiful, animated clock face.

Clock Modes

Tap the clock face to toggle between analog (traditional clock hands) and digital (large number display with seconds). Both modes show the same information around the clock.

Animated Background

The background features a sunrise gradient that changes based on how close you are to your next alarm. As your alarm approaches, the sky gradually brightens. Floating particles and a breathing orb animation create a calming visual experience.

Weather Display

When weather is enabled (Settings > Weather), the clock shows:

• Current temperature and weather condition icon
• High and low temperatures for the day
• AI-powered weather tip (when Intelligence is enabled)

Alarm Countdown

Below the clock, you'll see a countdown showing how long until your next alarm fires (e.g., "Alarm in 7h 23m").

3. Alarms

Creating an Alarm

1. Go to the Alarms tab
2. Tap the + button
3. Set the time using the time picker
4. Choose a label (e.g., "Work", "Gym", "Weekend")
5. Select an alarm sound from 19 options
6. Set a repeat schedule (specific days of the week, or leave it as one-time)
7. Configure snooze (on/off, duration)
8. Optionally set up Smart Volume Ramp
9. Optionally configure Light Automation and Climate Automation
10. Tap Save

Alarm Sounds

19 unique sounds organized by intensity:

• Gentle: Morning Birds, Ocean Waves, Gentle Chimes, Soft Piano, Rain Drops, Rooster
• Moderate: Classic Beep, Door Knocking, Wake Up Yell, Emergency
• Urgent: Police Siren, Ambulance, Air Raid Siren, Explosion, Car Crash, Plane Crash, Paranormal, Baby Crying, Tornado Storm

Tap any sound to preview it before selecting.

Smart Volume Ramp

When enabled, your alarm starts at a low volume and gradually increases to full volume over a duration you choose (5-30 minutes). This is much gentler than a sudden loud alarm.

• Ramp Duration: How long it takes to go from quiet to full volume (5-30 minutes, default 10)
• Start Volume: How quiet the alarm starts (adjustable from 5% to 100%, default 5%)

Managing Alarms

• Toggle on/off: Tap the switch next to any alarm to enable or disable it
• Edit: Tap an alarm to modify its settings
• Delete: Swipe left on an alarm and tap Delete

When an Alarm Fires

A full-screen alarm view appears with a sunrise animation. You have two options:

• Snooze: Tap the snooze button to delay the alarm by your configured snooze duration
• Dismiss: Drag the dismiss slider across the screen to stop the alarm

One-time alarms automatically disable after being dismissed. Recurring alarms stay active for their next scheduled time.

4. Persistent Wakeup

This feature makes sure you actually get out of bed after dismissing an alarm.

How It Works

1. Your alarm fires and you dismiss it
2. The app starts monitoring your phone's accelerometer for motion
3. If you pick up your phone and move within the monitoring window, the app considers you awake
4. If no significant motion is detected, follow-up alarms fire automatically

Configuration

Go to Settings > Persistent Wakeup:

• Enable/Disable: Toggle the feature on or off
• Monitoring Window: How long the app waits for motion (30-120 seconds)
• Re-alarm Delays: When follow-up alarms fire if no motion is detected (e.g., +5 minutes, +10 minutes)

5. Smart Home Automation

Connect your smart home devices to create automated morning routines triggered by your alarms.

Setting Up Philips Hue

1. Go to Settings > Smart Light Control
2. Select Philips Hue
3. The app will search for Hue bridges on your local network
4. When your bridge is found, press the physical button on your Hue bridge
5. The app will pair and discover all your lights
6. You can now assign Hue light actions to any alarm

Setting Up Home Assistant

1. Go to Settings > Smart Light Control, Climate Control, or Smart Locks
2. Select Home Assistant
3. Enter your Home Assistant local URL (e.g., http://homeassistant.local:8123)
4. Enter your Long-Lived Access Token (generate one in Home Assistant > Profile > Security)
5. The app will discover your light, climate, and lock entities

Home Assistant credentials are shared across all smart home sections — connecting in one section automatically enables it for the others.

Setting Up Homey

1. Open the Homey mobile app
2. Go to Settings > System > Port Forwarding and enable it
3. Go to tools.developer.homey.app and generate an API key
4. In WakeUp, go to Smart Lights, Climate Control, or Smart Locks and select Homey as the system
5. Enter your Homey IP address (with port) and paste the API key
6. Tap Connect — your Homey devices will be discovered automatically

Homey credentials are shared across all smart home sections — connecting in one section automatically enables it for lights, climate, and locks.

Setting Up Nuki Smart Lock

1. Go to Settings > Smart Locks
2. Select Nuki as the lock system
3. Get your API token from the Nuki Web portal (web.nuki.io > API)
4. Enter the token and tap Connect
5. Your Nuki smart locks will appear — select the ones you want to control

The app displays battery levels for each Nuki device, so you'll always know when a battery replacement is needed.

Setting Up Apple Home (Locks)

1. Go to Settings > Smart Locks
2. Select Apple Home
3. Tap Connect to Apple Home and grant HomeKit access
4. Select a home and the app will discover your lock accessories

Configuring Alarm Automations

When editing an alarm, scroll down to find:

• Light Automation: Turn lights on/off, set brightness, choose a color (RGB), or trigger a flash effect when the alarm fires
• Climate Automation: Turn your thermostat on/off or set a specific temperature when the alarm fires
• Lock Automation: Lock or unlock your doors when the alarm fires — select specific devices from Nuki, Home Assistant, or Apple Home

Each alarm can have its own unique automation settings. For example, your weekday alarm can turn on bright lights at 6 AM, while your weekend alarm can set a gentle warm glow at 9 AM.

Sleep & Wake Events

In each smart home section (Lights, Climate, Locks), you can configure actions for three events:

• Fall Asleep: Triggered when the sleep tracker detects you've fallen asleep
• Wake Up: Triggered when any alarm fires (as a global fallback if no per-alarm action is set)
• Timer: Triggered after a set number of minutes (15, 30, 45, or 60)

Schedules

Each smart home feature has its own schedule system — independent of alarms:

• Light Schedules: Turn lights on/off, set brightness, or change colors at specific times
• Climate Schedules: Turn climate on/off or set a target temperature at specific times
• Lock Schedules: Lock or unlock doors at specific times

Schedules support repeat days (daily, weekdays, weekends, or custom days). Find schedules at the bottom of each smart home settings section.

6. Sleep Tracking

WakeUp 2day provides comprehensive sleep tracking using your iPhone's microphone and motion sensors.

Starting a Sleep Session

1. Go to the Sleep tab
2. Tap Start Tracking
3. Place your phone on your nightstand (face down is fine, microphone should be unobstructed)
4. Optionally start a sleep sound to help you fall asleep
5. Go to sleep — the app tracks everything automatically
6. When you wake up, tap Stop Tracking to end the session

What Gets Tracked

The app detects 9 types of sleep events using on-device machine learning:

• Snoring — Detected and counted throughout the night
• Coughing — Individual coughs detected and timestamped
• Sleep Talking — Detected when speech is recognized during sleep
• Sneezing — Detected and logged
• Loud Sounds — Any unexpectedly loud noise
• Crying — Useful if you have a baby nearby
• Knocking — Door knocks or similar sounds
• Sirens — Emergency vehicle sirens passing by
• Movement/Wake-up — Detected via motion sensors

Sleep Phases

WakeUp tracks three sleep phases and displays them in a timeline graph:

• Deep Sleep — The most restorative phase. Your body repairs itself
• Light Sleep — Transitional sleep between deep and REM
• REM Sleep — When you dream. Important for memory and learning

Sleep Score

After each session, you receive a sleep score from 0 to 100 based on:

• Total sleep duration
• Number and severity of interruptions
• Types and frequency of events detected
• Time spent in each sleep phase

Sleep Report

After stopping a session, the Sleep Report shows:

• Your sleep score with a visual rating
• Sleep phase graph showing your night's phases
• Heart rate chart (if Apple Watch data is available)
• Event timeline showing when each event occurred
• Event counts (how many snores, coughs, etc.)
• Total sleep duration and bed time vs. wake time

Audio Playback

The app records the entire night's audio. You can:

• Play back the full recording
• Jump to specific events (tap on an event in the timeline to hear it)
• Delete recordings to free up storage

Sleep History & Calendar

• History: View recent sleep sessions in a list with scores and durations
• Calendar: See your sleep sessions on a calendar view — tap any date to view that night's details
• Weekly Summary: Charts showing averages, trends, and patterns over the past 7 days

Snoring Analysis

WakeUp tracks snoring events with configurable sensitivity:

• Sensitivity Levels: Low, Medium, or High — adjust in Settings to match your environment
• Per-Night Counts: See how many snoring events were detected and their durations
• Confidence Scores: Each detection includes a confidence level for accuracy

Sleep Debt

WakeUp calculates your accumulated sleep debt over the past 7 days based on a customizable daily target (default 8 hours). The sleep debt snapshot helps you understand if you're getting enough rest over time.

AI Sleep Calibration

The app's AI sleep algorithm calibrates over multiple nights to better detect your personal sleep patterns. The calibration progress is shown in Settings and improves with each tracked session. Sleep stages can be sourced from Apple Health, your device with heart rate data, or device sensors only.

CO2 Monitoring During Sleep

If you have a CO2 sensor connected via Home Assistant or Apple Home, WakeUp tracks indoor CO2 levels throughout the night:

• Good: Below 800 ppm
• Fair: 800-1200 ppm
• Poor: Above 1200 ppm

CO2 readings are shown in a graph alongside your sleep data.

AI Sleep Chat

A floating AI assistant button gives you instant access to sleep insights. Ask questions about your sleep in natural language. The AI analyzes your tracked data and provides personalized insights powered by Apple Intelligence. Examples:

• "How was my sleep this week?"
• "Am I snoring more than usual?"
• "What time do I sleep best?"
• "How can I improve my deep sleep?"

Enable AI features in Settings > Intelligence. AI processing runs entirely on your device.

7. Sleep Sounds

28 ambient sounds across 5 categories to help you fall asleep.

Sound Categories

• Nature (11): Rain, Ocean Waves, Wind, Creek, Campfire, Thunderstorm, Forest Birds, Crickets, Waterfall, Underwater, Tornado Storm
• Mechanical (9): Airplane Cabin, Busy City, Truck Driving, Train Ride, Fan, Vacuum, Hair Dryer, Washing Machine, Shower
• Ambience (2): Coffee Shop, Keyboard Typing
• Body & Animal (3): Heartbeat, Cat Purring, Snoring
• Noise (3): White Noise, Brown Noise, Pink Noise — these are synthesized in real-time (no audio file needed)

Stop Mode Options

• Fade out when asleep: The app monitors your motion and gradually fades out the sound when sleep is detected (30-second fade)
• Timer (1h, 2h, 3h): Set a fixed duration and the sound fades out when the timer ends

Using Sleep Sounds

You can start sleep sounds from:

• The Sleep tab when starting sleep tracking
• Nightstand Mode controls

Volume is adjustable with a dedicated slider. Sounds continue playing in the background.

8. Nightstand Mode

Turn your iPhone into a beautiful bedside clock that stays on all night.

Entering Nightstand Mode

From the Sleep tab, tap the Nightstand button (or find it in Sleep settings). The screen dims and shows a beautiful clock display.

7 Design Styles

• Classic: Glowing orb with particle effects
• Minimal: Ultralight typography on pure black
• Nature: Forest aesthetic with green particles
• Retro: Flip clock design with amber LED effect and scanlines
• Aurora: Animated flowing gradient background
• Tron Legacy: Perspective grid with cyan accents
• Candy: Pastel pink bubbles with rounded typography

Features

• Clock Style: Toggle between analog and digital display per design
• Brightness Modes: Auto, Power Save, or Manual brightness for comfortable nighttime viewing
• Alarm Countdown: Shows time remaining until your next alarm
• Sleep Sound Controls: Start/stop sleep sounds and adjust volume
• Breathing Orb: Calming animated orb available in all designs
• Seconds Display: Toggle seconds on or off

Exiting

Double-tap anywhere on the screen to exit nightstand mode.

9. Timer & Stopwatch

Timer

• Go to the Timer tab
• Set your desired duration (hours, minutes, seconds) and optionally add a custom label
• Tap Start — a circular progress ring shows the countdown
• Run up to 4 timers simultaneously — each with its own label and duration
• You can pause and resume each timer independently
• Choose a custom timer completion sound
• When the timer completes, a notification appears with haptic feedback
• Timers work in the background — you'll get a notification even if the app is minimized
• Active timers show in Dynamic Island on supported iPhones

Stopwatch

• Switch to the Stopwatch tab (within Timer)
• Tap Start to begin timing
• Tap Lap to record split times
• The fastest lap is highlighted in green, the slowest in red
• Tap Stop to pause, and Reset to clear
• Millisecond precision for accurate timing

10. Themes & Personalization

WakeUp 2day comes with 12 beautifully crafted themes that change the entire look of the app, plus 6 matching app icons and support for 8 languages.

Available Themes

• Midnight — Deep blue background with warm orange accents. Cozy and warm
• Ocean — Dark teal background with cyan/turquoise glow. Cool and calming
• Sunset — Purple background with coral-pink highlights. Vibrant and romantic
• Forest — Dark green background with lime green accents. Natural and fresh
• Aurora — Indigo background with magenta glow. Mystical and modern
• Daylight — Clean, bright light mode. Perfect for daytime use
• Rose — Dark rose background with warm salmon accents. Elegant and soft
• Volcanic — Dark brown background with fiery orange accents. Bold and intense
• Arctic — Light, cool blue-white background with teal accents. Clean and frosty
• Lavender — Deep purple background with soft violet accents. Relaxing and dreamy
• Tron Legacy — Near-black background with electric cyan accents. Futuristic and sharp
• Candy — Light pastel pink with hot pink accents. Playful and sweet

Changing Themes

Go to Settings and tap on a theme to apply it. The entire app updates instantly — backgrounds, accents, surfaces, text colors, animations, and widgets all change to match.

App Icons

6 matching app icons to choose from: Sunrise (default), Sunset, Ocean, Midnight, Gold, and Mono. Find the icon picker in Settings below the theme selection.

Languages

WakeUp 2day supports 8 languages: English, Spanish, Italian, French, Japanese, Chinese (Simplified), Romanian, and Serbian. Change the language in Settings. AI responses are automatically translated to your selected language.

11. Weather & AI Intelligence

Weather Setup

1. Go to Settings > Weather
2. Choose your weather provider: Apple Weather (native), Open-Meteo (free API), or wttr.in
3. Grant location permission when prompted ("While Using App")
4. Select your preferred temperature unit (Celsius or Fahrenheit) and wind speed unit (km/h, mph, m/s, knots)
5. Weather will appear on the clock face, nightstand, and widgets

Weather data refreshes automatically and is cached for 1 hour. Includes current conditions, high/low temperature, hourly forecast, wind speed and direction, humidity, precipitation probability, and weather alerts with severity levels. Your location is used solely for weather and is never stored or transmitted.

AI Intelligence

Go to Settings > Intelligence to enable AI features (requires Apple Intelligence-capable device):

• AI Weather Tips: Smart, context-aware tips appear on the clock face based on current weather conditions
• AI Sleep Insights: Personalized wellness recommendations generated on-device after sleep sessions
• AI Sleep Chat: Floating AI assistant button — tap to ask questions about your sleep data and get insights. The button is draggable and remembers its position

All AI processing runs entirely on your device using Apple Intelligence — no data is ever sent to external servers.

12. Apple Health Integration

Setup

1. Go to Settings > Health
2. Tap to enable HealthKit integration
3. Grant the requested permissions in the Health app popup

What It Does

• Heart Rate: Reads average and per-event heart rate data during sleep sessions
• Heart Rate Variability (HRV): Reads SDNN heart rate variability for recovery tracking
• Blood Oxygen (SpO2): Reads oxygen saturation levels during sleep
• Wrist Temperature: Reads temperature trends during sleep
• Previous Day Activity: Steps, active minutes, and calories from the day before your sleep
• Sleep Stage Priority: Uses Apple Health sleep stages first when available, then falls back to WakeUp's algorithm
• Writes sleep data: Your sleep sessions (duration, phases, quality) are exported to Apple Health
• Auto-sync: Enable auto-sync with configurable interval to export and import data automatically

All Health data stays within Apple's secure HealthKit framework and is never accessed by anyone but you.

Compatible Devices

WakeUp 2day reads health data through Apple Health — it doesn't connect to wearables directly. Any smart device that syncs heart rate, HRV, SpO2, or sleep data to Apple Health is automatically compatible:

• Apple Watch — All models with health sensors
• Garmin — Via Garmin Connect syncing to Apple Health
• Withings — ScanWatch, Steel HR, and other Withings devices via Health Mate
• Oura Ring — Via Oura app syncing to Apple Health
• Ultrahuman Ring — Via Ultrahuman app syncing to Apple Health
• Huawei — Via Huawei Health syncing to Apple Health
• Zepp / Amazfit — Via Zepp app syncing to Apple Health
• Any other device — If it writes health data to Apple Health, WakeUp can read it

13. iCloud Backup

Backing Up

1. Go to Settings > iCloud Backup
2. Tap Back Up Now
3. Wait for the backup to complete (a confirmation alert will appear)

Backups include: all alarms, sleep sessions, sleep data, audio recordings, and app settings.

Restoring

1. Install WakeUp 2day on your new or restored device
2. Sign in with the same Apple ID
3. Go to Settings > iCloud Backup
4. Tap Restore

14. Widgets & Dynamic Island

Home Screen Widgets

Add WakeUp widgets to your home screen:

1. Long-press your home screen
2. Tap the + button in the top corner
3. Search for WakeUp
4. Choose from available widget sizes

17+ available widgets:

• Analog Clock — Traditional clock face
• Digital Clock — Large number display
• Weather Clock — Clock with current weather
• Weather Intelligence — AI weather tips
• Alarm — Next upcoming alarm with countdown
• Timer — Active timer countdown
• Stopwatch — Running stopwatch
• Sleep Metrics — Configurable: score, sleep time, snores, coughs, sneezes, wake-ups, or heart rate
• Sleep Summary — Overview of last night's sleep
• Sleep Calendar — Monthly calendar with sleep indicators
• AI Chat — Quick access to AI sleep assistant
• AI Tip — Latest AI insight (lock screen)
• Quick Action — Fast access to common features
• Automation — Smart home automation status
• Smart Lock — Lock/unlock status
• CO2 — Indoor air quality level
• SpO2 — Blood oxygen reading

All widgets automatically update to match your selected theme.

Lock Screen Widgets

Add compact widgets to your lock screen showing alarm countdown, AI tips, sleep tracking status, or weather info.

Dynamic Island & Live Activities

On supported iPhones (iPhone 14 Pro and later), live activities appear in the Dynamic Island for:

• Alarm countdown — Time until your next alarm fires
• Timer countdown — Active timer with remaining time
• Stopwatch — Running stopwatch with elapsed time

Tap to expand for details. Activities recover automatically if the app relaunches.

15. Apple TV Support

Turn any Apple TV or AirPlay-compatible display into a beautiful room clock.

Setup

1. Go to Settings > Apple TV
2. Enable Apple TV support
3. Connect to your Apple TV or AirPlay display from the AirPlay button on the clock or sleep screen
4. The nightstand clock automatically appears on the external display

TV Display Options

• Nightstand Design: Choose from all 7 designs (Classic, Minimal, Nature, Retro, Aurora, Tron Legacy, Candy)
• Clock Style: Toggle between analog and digital on the TV display
• Weather Animations: Enable or disable weather particle effects on the TV
• Breathing Orb: Toggle the calming orb animation
• Particles: Enable or disable floating particle effects
• Sleep Sounds: Play sleep sounds through the TV speakers

15. Permissions Explained

WakeUp 2day requests several permissions. Here's why each is needed:

Microphone

Used for: Sleep tracking — detecting sleep events and recording audio. Only active during sleep tracking sessions. Never used otherwise.

Motion & Activity

Used for: Persistent Wakeup (detecting if you got out of bed) and sleep movement tracking. Processed in real-time, not stored long-term.

Location (When In Use)

Used for: Fetching weather data for the clock display. Only accessed when the app is open and weather is enabled. Not stored or tracked.

Local Network

Used for: Discovering and communicating with Philips Hue bridges, Home Assistant, and HomeKit accessories on your Wi-Fi network. Only used when you set up smart home devices.

Notifications

Used for: Alarm alerts and timer notifications when the app is in the background.

HealthKit

Used for: Reading heart rate data (for sleep charts) and writing sleep data to Apple Health. Fully optional.

HomeKit

Used for: Controlling Apple Home lights, thermostats, locks, and CO2 sensors. Only active when you set up Apple Home integration.

Critical Alerts

Used for: Ensuring alarm notifications can play even when Do Not Disturb is enabled. This special permission allows alarm sounds to override silent mode.