notepush-ios-main

NotePush Support

Welcome to NotePush Support! We’re here to help you get the most out of your enhanced push notification experience.

Getting Started

What is NotePush?

NotePush is an enhanced version of the open-source ntfy iOS client with additional features to make notification management easier and more powerful. Like the original ntfy app, you can connect to any compatible notification server, but NotePush adds:

How to Get Started:

  1. Choose a Server
    • 🏠 Self-hosted: Run your own ntfy server (most private)
    • 🌐 Public: Use ntfy.sh or other public servers
    • 🏢 Enterprise: Connect to your organization’s server
  2. Add Your Server
    • Open NotePush → Tap “+” → Enter server URL manually
    • NEW: Scan a QR code for instant setup
    • NEW: Configure multiple topics at once
  3. Subscribe to Topics
    • Create meaningful topic names (e.g., “home-alerts”, “work-notifications”)
    • NEW: Subscribe to multiple topics simultaneously
    • Keep topic names private and non-guessable
  4. Start Receiving Notifications
    • Send HTTP requests to your server
    • Notifications appear instantly on your device
    • NEW: Enhanced attachment previews

Need detailed setup instructions? → Full Documentation

Test QR Code for App Store Reviewers

Quick Testing for Reviewers: We’ve provided a test QR code to easily demonstrate the enhanced QR code functionality:

Test QR Code

What it does: This QR code automatically configures NotePush to connect to the public ntfy.sh server and subscribe to two test topics.

How to Test:

  1. Open NotePush → Tap “+” → “Scan QR Code”
  2. Point camera at the QR code above
  3. Review the configuration (shows ntfy.sh server with two test topics)
  4. Confirm to subscribe to the test topics
  5. Send test notifications by visiting https://ntfy.sh/[topic-name] in a browser
  6. Send a message to see instant notification delivery

What This Demonstrates:

Enhanced Features Guide

🆕 QR Code Server Setup

Quick Setup via QR Code:

  1. Get a QR code from your server administrator
  2. Open NotePush → Tap “+” → “Scan QR Code”
  3. Point camera at QR code
  4. Confirm server and topic subscriptions
  5. Done! All topics configured automatically

QR Code Benefits:

🆕 Multi-Topic Subscriptions

Subscribe to Multiple Topics:

🆕 Display Name Support

Improved Usability for Security Best Practices:

Public ntfy servers recommend using hard-to-guess topic names to reduce the risk of unwanted access. NotePush’s display name feature makes this more practical:

The Challenge:

NotePush Makes It Easier:

Example:

Actual topic: "a7b2c3d4-e5f6-7890-abcd-ef1234567890" (hard to guess)
Display name: "🚨 Critical Alerts" (easy to understand)
Result: Better security practices with good usability

Benefits:

🆕 Enhanced Attachment Previews

Improved Attachment Support:

Common Issues & Solutions

🔔 Notifications Not Appearing

Check Permissions:

  1. iOS Settings → Notifications → NotePush → Enable “Allow Notifications”
  2. iOS Settings → General → Background App Refresh → Enable for NotePush

Test Your Setup:

  1. Open NotePush → Settings → Run Diagnostics
  2. Try the Test Local Notification button
  3. Verify your server URL is correct and accessible

Still not working? Email us at support@notepush.app with:

🌐 Server Connection Problems

Common Fixes:

Testing with Public Server: Try connecting to https://ntfy.sh first to verify the app works, then troubleshoot your custom server.

📱 QR Code Scanning Issues

Camera Permission Required:

  1. iOS Settings → Privacy & Security → Camera → NotePush → Enable
  2. Good Lighting: Ensure QR code is well-lit and clear
  3. Manual Entry: If scanning fails, enter server details manually

QR Code Format:

🔋 Background Notifications Delayed

Understanding iOS Limitations:

Optimization Tips:

  1. Use the app regularly (increases iOS priority)
  2. Keep in recent apps (don’t force-close)
  3. Charge your device (iOS limits background activity on low battery)
  4. Enable all permissions (notifications + background refresh)

Server Setup Help

🏠 Self-Hosting (Recommended for Privacy)

Quick Docker Setup:

# Basic setup
docker run -p 80:80 -v /var/cache/ntfy:/var/cache/ntfy binwiederhier/ntfy

# With HTTPS (production)
docker run -p 443:80 -v /var/cache/ntfy:/var/cache/ntfy binwiederhier/ntfy

Need detailed server setup? → ntfy Documentation

🌐 Public Servers

Recommended Public Servers:

Public Server Considerations:

🏢 Enterprise Setup

For Organizations:

Need enterprise support? Contact developer@notepush.app

Sending Notifications

Basic Examples

Simple Message:

curl -d "Hello World!" https://your-server.com/your-topic

With Title and Priority:

curl -H "Title: Alert" -H "Priority: urgent" -d "Server is down!" https://your-server.com/alerts

With Attachments (Enhanced Preview):

# Image attachment
curl -H "Title: Server Status" -H "Attach: https://example.com/chart.png" -d "Daily metrics" https://your-server.com/monitoring

# File attachment  
curl -H "Title: Report" -H "Attach: https://example.com/report.pdf" -d "Monthly report ready" https://your-server.com/reports

From Programming Languages:

// JavaScript/Node.js
fetch('https://your-server.com/your-topic', {
  method: 'POST',
  body: 'Hello from JavaScript!'
});

# Python
import requests
requests.post('https://your-server.com/your-topic', data='Hello from Python!')

More examples: → Full Documentation

Privacy & Security

🔒 Your Privacy is Protected

What We DON’T Collect:

What We DO Collect:

Local Storage Only:

🛡️ Security Best Practices

App Security:

Server Security:

Frequently Asked Questions

General Questions

Q: How is NotePush different from the original ntfy iOS app? A: NotePush builds on the excellent open-source ntfy foundation with enhanced features: QR code server setup, multi-topic subscriptions, display name support for better topic management, improved attachment previews, and better server management - all while maintaining the same privacy-first approach.

Q: Why is display name support useful? A: It makes security best practices more practical. Public ntfy servers recommend using hard-to-guess topic names (like UUIDs) to reduce unwanted access, but these are difficult for users to manage. NotePush lets you use secure topic names while showing friendly names like “Home Alerts” to users, making it easier to follow recommended practices without sacrificing usability.

Q: Do I need to pay for a server? A: Not necessarily! You can use free public servers like ntfy.sh, run your own at home, or use cloud hosting starting from a few dollars per month.

Q: Can I use multiple servers? A: Yes! NotePush supports multiple servers simultaneously. Perfect for separating work and personal notifications.

Technical Questions

Q: What servers are compatible? A: Any server implementing the ntfy protocol, including the official ntfy server software and compatible implementations.

Q: How reliable are notifications? A: Very reliable when properly configured. iOS controls background timing, but NotePush includes optimizations for best delivery.

Q: Can I send notifications programmatically? A: Absolutely! Use simple HTTP requests from any programming language, script, or automation tool.

Privacy Questions

Q: Can NotePush see my notifications? A: No! Notifications go directly from your server to your device. We never see your notification content.

Q: Is my data shared with anyone? A: No. All data stays on your device. We only use Firebase for the delivery mechanism (not content).

Q: Can I use this for business? A: Yes! The enhanced features make it even better for enterprise use where you want to control your notification infrastructure.

Contact Support

📧 Email Support

General Support:

Technical Issues:

📋 When Contacting Support

Please Include:

Screenshots Help! Include screenshots of any error messages or unexpected behavior.

🔧 Self-Service Tools

Before Contacting Support:

  1. Run Diagnostics: NotePush Settings → Run Diagnostics
  2. Check Documentation: docs.notepush.app
  3. Try Public Server: Test with ntfy.sh to isolate issues
  4. Review Permissions: Notifications and Background App Refresh

Additional Resources

📖 Documentation & Guides

🌐 Community & Forums

🔗 Official Links

About NotePush

NotePush builds on the excellent ntfy project by Philipp Heckel. We’re committed to enhancing the ntfy experience with improved user interface and additional features while maintaining the same privacy-first, server-agnostic approach.

Our Mission: Enhance the ntfy experience with better usability while preserving user control and privacy.

Our Values:

Thank you for choosing NotePush! 🚀

Need immediate help? Email support@notepush.app

*Last updated: [Date] NotePush v0.9.1*