Microsoft-Rewards-Script/docs/ntfy.md

📱 NTFY Push Notifications

Get alerts on your phone instantly

---

💡 What Is NTFY?

Simple push notification service that sends alerts to your phone/desktop.

Free to use: No account required for basic features.

---

⚡ Quick Start

1. Install NTFY App

• Android: Google Play
• iOS: App Store

2. Choose a Topic Name

Pick any unique name (e.g., rewards-myname-2025)

3. Subscribe in App

Open NTFY app → Add subscription → Enter your topic name

4. Configure Script

Edit src/config.jsonc:

{
  "notifications": {
    "ntfy": {
      "enabled": true,
      "url": "https://ntfy.sh",
      "topic": "rewards-myname-2025"
    }
  }
}

That's it! You'll get push notifications on your phone.

---

🔔 What Notifications You Get

• 🚨 Errors — Script crashes, login failures
• ⚠️ Warnings — Missing points, suspicious activity
• 🏆 Milestones — Account completed successfully
• 💳 Buy mode — Point spending detected
• 📊 Summary — End-of-run report

---

🔒 Use Private Server (Optional)

Self-Host NTFY

Docker:

services:
  ntfy:
    image: binwiederhier/ntfy
    ports:
      - "80:80"
    volumes:
      - ./ntfy-data:/var/lib/ntfy
    command: serve

Then configure:

{
  "notifications": {
    "ntfy": {
      "enabled": true,
      "url": "https://ntfy.yourdomain.com",
      "topic": "rewards",
      "authToken": "tk_your_token_here"
    }
  }
}

---

🛠️ Troubleshooting

Problem	Solution
No notifications	Check topic name matches exactly
Wrong server	Verify URL includes https://
Auth failures	Token must start with tk_

Test Manually

# Send test message
curl -d "Test from rewards script" https://ntfy.sh/your-topic

---

📚 Next Steps

Want Discord too?
→ Discord Webhooks

Need detailed logs?
→ Diagnostics Guide

---

← Back to Hub | Config Guide