A lightweight background service that detects when your CPAP mask is removed during sleep and alerts you immediately via Pushover. Runs on macOS, Windows, Linux, or a Raspberry Pi Zero 2W.

This tool is not a medical device. It is not intended to diagnose, treat, cure, or monitor any medical condition.

Use of this software is entirely at your own risk. The authors and contributors accept no liability whatsoever for any harm, injury, loss of sleep quality, missed alerts, false alerts, or any other outcome — direct or indirect — arising from the use or misuse of this software.

• Do not rely on this tool as your sole method of CPAP compliance monitoring
• Always consult your physician or sleep specialist regarding your CPAP therapy
• This tool is a personal convenience project shared freely with the community
• By using this software, you agree that you are solely responsible for any consequences

Severe obstructive sleep apnea (OSA) requires consistent CPAP therapy throughout the night. However, many users — especially those with high pressure requirements — tend to unconsciously remove their mask during REM or deep sleep when discomfort peaks. When this happens, therapy stops completely, OSA events return, and sleep quality suffers — often without the user even remembering it happened.

ResMed's MyAir app shows a morning summary, but by then the damage is done. There was no way to get a real-time alert the moment the mask came off.

This project solves that.

A smart plug with energy monitoring sits between your CPAP machine and the wall socket. The monitor polls the plug every 2 minutes (configurable) and reads the current power consumption in watts:

• Mask on, therapy running: varies by machine and pressure setting
• Mask off, machine idle/stopped: low standby wattage

When the monitor detects a sustained low watt reading across multiple consecutive readings, it starts a timer. If the mask stays off long enough, it fires a Pushover push notification to your phone — with priority 2 (emergency), which bypasses Silent mode and Do Not Disturb.

CPAP Machine → Smart Plug → Local WiFi → Monitor (Mac/PC/Pi) → Pushover → Phone/Watch

• CPAP machine — tested with ResMed AirSense 10 and AirSense 11. Should work with any CPAP/APAP/BiPAP machine.
• Smart plug with energy monitoring — see Supported Devices
• A device to run the monitor — Mac, Windows PC, Linux machine, or Raspberry Pi Zero 2W (or any Pi)

• Python 3.10 or later (3.11+ recommended)
• Pushover account — one-time $5 purchase per platform (iOS or Android). Free 30-day trial available.
• Smart plug account (Tapo, Kasa, or Tuya)

• Monitor device and smart plug must be on the same local WiFi network
• Internet connection required for Pushover alerts

git clone https://github.com/discocracker02/cpap-mask-monitor.git
cd cpap-mask-monitor
bash install.sh

The installer will:

1. Check Python version
2. Install required libraries
3. Create config.json from the example and open it for you to fill in
4. Register a background service that starts automatically on boot
5. Start the monitor

git clone https://github.com/discocracker02/cpap-mask-monitor.git
cd cpap-mask-monitor
pip install tapo requests
copy config.example.json config.json

Edit config.json with your credentials, then run:

python cpap_monitor.py

To run automatically on startup, add a shortcut to cpap_monitor.py in your Windows Startup folder (Win + R → shell:startup).

1. Clone the repo:

git clone https://github.com/discocracker02/cpap-mask-monitor.git
cd cpap-mask-monitor

2. Install dependencies:

pip3 install tapo requests

3. Create config:

cp config.example.json config.json   # Mac/Linux
copy config.example.json config.json  # Windows

Edit config.json with your credentials (see Configuration).

4. Test it works:

python3 cpap_monitor.py

You should see power readings appearing every 2 minutes.

Running the monitor on a Pi Zero 2W is the best long-term setup. It runs silently 24/7, uses almost no power (~0.5W), and doesn't tie up your laptop or Mac. Any Raspberry Pi model will work.

• Raspberry Pi Zero 2W (or any Pi model)
• MicroSD card (16GB or larger)
• Micro USB power adapter (Pi Zero 2W) or USB-C (Pi 4/5)
• Micro USB OTG adapter (for Pi Zero 2W, to connect peripherals)
• A computer to set it up from

1. Download and install Raspberry Pi Imager
2. Insert your microSD card
3. Open Raspberry Pi Imager
4. Choose Raspberry Pi Zero 2W as the device
5. Choose Raspberry Pi OS Lite (64-bit) — no desktop needed
6. Click the settings gear icon and configure:
   • Set hostname: snoozesense (or any name you like)
   • Enable SSH
   • Set username: pi (or your preferred name)
   • Set password
   • Configure WiFi with your network name and password
7. Flash the card and insert it into the Pi

Power on the Pi. Wait 2 minutes, then SSH in from your computer:

ssh pi@snoozesense.local

If that doesn't work, find the Pi's IP in your router's connected devices list and use:

ssh pi@192.168.x.x

Open your router admin page and find the DHCP reservation section. Reserve a fixed IP for your Pi using its MAC address. This ensures the Pi always gets the same IP address so nothing breaks after a reboot.

sudo apt update && sudo apt upgrade -y
sudo apt install -y python3-pip python3-venv git

Create a virtual environment:

cd ~
python3 -m venv cpap-env
source cpap-env/bin/activate

Clone the repo and install:

git clone https://github.com/discocracker02/cpap-mask-monitor.git
cd cpap-mask-monitor
pip install tapo requests

cp config.example.json config.json
nano config.json

Fill in your Tapo credentials, plug IP, and Pushover keys. See Configuration for all options.

Save with Ctrl+X → Y → Enter.

python3 cpap_monitor.py

You should see power readings every 2 minutes. Press Ctrl+C to stop.

Create the service file:

sudo nano /etc/systemd/system/cpap-monitor.service

Paste this (replace pi with your username if different):

[Unit]
Description=CPAP Mask Monitor
After=network.target

[Service]
Type=simple
User=pi
WorkingDirectory=/home/pi/cpap-mask-monitor
ExecStart=/home/pi/cpap-env/bin/python3 /home/pi/cpap-mask-monitor/cpap_monitor.py
Restart=always
RestartSec=30

[Install]
WantedBy=multi-user.target

Save with Ctrl+X → Y → Enter.

Enable and start:

sudo systemctl enable cpap-monitor
sudo systemctl start cpap-monitor
sudo systemctl status cpap-monitor

You should see Active: active (running). The monitor will now start automatically every time the Pi boots.

Check the log:

cat ~/cpap-mask-monitor/cpap_monitor.log

You should see timestamped power readings. You're done — the Pi will run silently overnight, every night.

# Check service status
sudo systemctl status cpap-monitor

# View live log
tail -f ~/cpap-mask-monitor/cpap_monitor.log

# Restart service
sudo systemctl restart cpap-monitor

# Safely shut down Pi before unplugging
sudo shutdown now

Copy config.example.json to config.json and fill in your details:

{
  "plug_type": "tapo",
  "tapo": {
    "email": "your_tapo_account_email@example.com",
    "password": "your_tapo_account_password",
    "ip": "192.168.x.x"
  },
  "pushover": {
    "user_key": "your_pushover_user_key",
    "app_token": "your_pushover_app_token"
  },
  "monitor": {
    "poll_seconds": 120,
    "idle_minutes": 15,
    "watt_threshold": 3,
    "confirm_count": 5,
    "sleep_start_hour": 22,
    "sleep_end_hour": 9,
    "timezone_offset_hours": 5.5
  }
}

Important: The recommended values above (watt_threshold: 3, confirm_count: 5) are based on testing with a ResMed AirSense 11 AutoSet. Your machine may draw different power levels depending on the model, pressure settings, and humidifier use. Always calibrate for your own machine.

How to calibrate:

1. Run python3 cpap_monitor.py and watch the log
2. Note the watts while wearing the mask with therapy running — this is your active range
3. Note the watts when the machine is on standby (mask off, machine idle) — this is your idle value
4. Set watt_threshold to a value between idle and the lowest active reading
5. Set confirm_count higher if you get false alerts — this requires more consecutive low readings before confirming mask-off

Example — ResMed AirSense 11 AutoSet:

• Active therapy: 3–7W (varies with pressure)
• Standby / idle: 2W
• Recommended threshold: 3W
• Recommended confirm_count: 5 (10 minutes of polling before confirming)

Example — ResMed AirSense 10 AutoSet:

• Active therapy: 6–15W
• Standby / idle: 2–3W
• Recommended threshold: 5W
• Recommended confirm_count: 2–3

Tip: Use your smart plug's own app (Tapo app, Kasa app etc.) to watch live power readings for 10–15 minutes while using your CPAP. This gives you a clear picture of your machine's power profile before setting any thresholds.

Open the Tapo app → tap your plug → tap the settings icon → Device Info → IP Address.

Tip: Reserve a static IP for your plug in your router's DHCP settings so the IP never changes.

Pushover is the notification service that sends alerts to your phone and Apple Watch or Wear OS watch. It costs $5 once and works on both iOS and Android.

1. Go to pushover.net and create a free account
2. On your dashboard, note your User Key — you'll need this for config.json
3. Click Create an Application/API Token
4. Give it a name (e.g. "CPAP Monitor") and click Create
5. Note the API Token — you'll need this too

1. Download Pushover from the App Store
2. Log in with your pushover.net account
3. Open Settings inside the Pushover app
4. Tap Notification Settings
5. Enable Critical Alerts — this is essential. It bypasses Silent mode and all Focus modes including Sleep Focus
6. If you have an Apple Watch, the Pushover app installs automatically on the watch via the Watch app
7. On your Apple Watch, open the Watch app on iPhone → scroll to Pushover → enable Show App on Apple Watch
8. Critical alerts will now appear on both your iPhone and Apple Watch even when your phone is silenced

1. Download Pushover from the Google Play Store
2. Log in with your pushover.net account
3. Open the app → Settings → Notification Channels
4. Enable the Emergency channel — this allows alerts to bypass Do Not Disturb
5. If you have a Wear OS watch (Galaxy Watch, Pixel Watch etc.), notifications mirror automatically from your phone
6. To ensure watch alerts work: on your phone go to Settings → Notifications → find Pushover → enable "Allow notification mirroring" or similar (varies by Android version)

Run this command from your terminal (replace with your actual keys):

curl -s \
  --form-string "token=YOUR_APP_TOKEN" \
  --form-string "user=YOUR_USER_KEY" \
  --form-string "title=CPAP Monitor Test" \
  --form-string "message=Test alert — your setup is working!" \
  --form-string "priority=2" \
  --form-string "retry=60" \
  --form-string "expire=300" \
  https://api.pushover.net/1/messages.json

You should receive a loud alert on your phone and watch within a few seconds.

Important: Only smart plugs with energy monitoring (live power reading in watts) are compatible. Always check your plug's spec sheet before buying.

Your watt_threshold may be too high or confirm_count too low. This is the most common issue with AutoSet machines that dynamically adjust pressure — power draw fluctuates even with the mask on.

Fix:

1. Watch the log for a full night and note minimum watts during therapy
2. Lower watt_threshold to just above standby level
3. Raise confirm_count to 4 or 5 to require more consecutive low readings
4. Raise idle_minutes to 15 to require longer sustained low power before alerting

• Make sure Pushover Critical Alerts is enabled (see Pushover Setup above)
• Verify your User Key and App Token in config.json
• Check internet connection on the monitor device

This is a known issue with newer Tapo firmware. Fixes to try:

1. Power cycle the plug
2. Restart the monitor service
3. Factory reset the plug and re-add to Tapo app

• Verify the IP in config.json matches your plug's current IP
• Make sure monitor device and plug are on the same WiFi network
• Reserve a static IP for the plug in your router

• Check if IP changed — look in your router's connected devices list
• Use ssh pi@snoozesense.local as a fallback (uses hostname instead of IP)
• Reserve a static IP in your router to prevent this permanently

• macOS support
• Linux / Raspberry Pi support (systemd service)
• Windows auto-start service
• Additional smart plugs — Sonoff S31, additional Kasa models
• Additional alert providers — Telegram bot, ntfy.sh, Home Assistant webhook
• Web dashboard — nightly summary, mask-off history, trend graphs
• Multi-machine support — for households with multiple CPAP users
• Auto-calibration — automatically determine watt threshold from first-night data

Community contributions welcome. If you've tested with a device not listed above, please open an issue or PR.

Pull requests are welcome. For major changes, please open an issue first to discuss what you'd like to change.

MIT — free to use, modify, and distribute. See LICENSE for details.

See README_PLUGS.md for the full list of supported plugs including Tapo, Kasa, Wipro, and Havells.