Dispatch

A free iOS and macOS client for ntfy — push notifications from your own scripts, servers, and services to your iPhone. Works with ntfy.sh and self-hosted ntfy servers.

This repository is the public home of Dispatch: source releases, bug reports, and feature requests.

Features

• Subscribe to topics on ntfy.sh or any self-hosted ntfy server
• Instant push delivery, priorities, tags, emoji, and Markdown
• Critical Alerts for priority-5 messages (breaks through silent mode, opt-in)
• Image and file attachments with configurable auto-download
• Per-topic muting, categories, retention, and read/unread tracking

Releasing

Releases are cut from the private working repository with scripts/publish-release.sh (included here with each release). From a clean main:

1. Set the version in project.yml: MARKETING_VERSION is CalVer year.month.patch (e.g. 2026.8.0), CURRENT_PROJECT_VERSION is YYYYMMDDnn (e.g. 2026080401, incrementing nn for same-day uploads).
2. Preview: ./scripts/publish-release.sh --dry-run — prints the itemized sync without touching anything.
3. Publish: ./scripts/publish-release.sh [notes.md] — without a notes file, gh opens an editor for the release notes.

The script exports the tracked sources (private infrastructure paths are pruned; this README is preserved), commits them here as Release v<version> (source <sha>), tags v<version> in both repositories, and creates the GitHub release. Prerequisites: gh authenticated, and this repository cloned at ~/Code/dispatch (override with DISPATCH_MIRROR).

Credits

Dispatch is a fork of ntfy-ios, the open-source ntfy client, by its authors and contributors — thank you for building in the open. Dispatch is independent and not affiliated with the ntfy project.

License

MIT, matching the upstream project.