https://github.com/rubix-studios-pty-ltd/ntfy-app
A desktop application for ntfy that provides instant native notifications and real-time messaging directly from your desktop. It supports both ntfy.sh and self-hosted ntfy instances through a lightweight, privacy-focused interface.
https://github.com/rubix-studios-pty-ltd/ntfy-app
desktop linux macos nextjs notifications ntfy ntfy-sh push-notifications rust self-hosted tauri tauri-app windows
Last synced: 25 days ago
JSON representation
A desktop application for ntfy that provides instant native notifications and real-time messaging directly from your desktop. It supports both ntfy.sh and self-hosted ntfy instances through a lightweight, privacy-focused interface.
- Host: GitHub
- URL: https://github.com/rubix-studios-pty-ltd/ntfy-app
- Owner: rubix-studios-pty-ltd
- License: mit
- Created: 2026-05-11T15:57:41.000Z (about 2 months ago)
- Default Branch: main
- Last Pushed: 2026-06-01T22:35:48.000Z (about 1 month ago)
- Last Synced: 2026-06-02T00:21:47.042Z (about 1 month ago)
- Topics: desktop, linux, macos, nextjs, notifications, ntfy, ntfy-sh, push-notifications, rust, self-hosted, tauri, tauri-app, windows
- Language: Rust
- Homepage: https://rubixstudios.com.au/insights/ntfy-desktop-app
- Size: 814 KB
- Stars: 8
- Watchers: 2
- Forks: 1
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- Changelog: CHANGELOG.md
- Funding: .github/FUNDING.yml
- License: LICENSE
- Code of conduct: CODE_OF_CONDUCT.md
- Security: SECURITY.md
Awesome Lists containing this project
README
# Ntfy App
A cross-platform desktop client for [ntfy.sh](https://ntfy.sh) and self-hosted ntfy instances. Built with [Rust](https://www.rust-lang.org/), [Tauri](https://tauri.app/), and [Next.js](https://nextjs.org/).
Automatic updates are disabled by default to reduce background activity, external requests to GitHub, and unnecessary resource usage. Update checking and installation are user controlled through the system tray.
[](LICENSE)
[](https://github.com/rubix-studios-pty-ltd/ntfy-app/releases)
[](https://github.com/rubix-studios-pty-ltd/ntfy-app)
[](https://github.com/rubix-studios-pty-ltd/ntfy-app/commits/main)
[](#contributors-)
## Features
- **Notifications**: Receive native desktop notifications from any ntfy topic
- **Webhook Builder**: Generate authenticated webhook URLs for your topics
- **Schedules**: Schedule working hours for notification alerts and suppression
- **Self-hosted**: Connect to your own ntfy instance or use ntfy.sh
- **Cross-platform**: Windows, Linux, and macOS (Intel & Apple Silicon)
- **System Tray**: Runs quietly in the background with tray controls
- **Lightweight**: Built with Rust and Tauri for minimal resource usage
- **Modern UI**: Next.js, React, and Tailwind CSS
## In Development (Beta)
- **Automations**: Trigger local programs, scripts, URLs, and system actions
based on incoming ntfy messages
> **Note:** Automation topics should be reserved and access-controlled.
> For self-hosted instances, use ntfy ACL to restrict publish access
> to trusted users only.
## macOS
macOS may block unsigned applications on first launch. Open Terminal and run the following command once before opening the app:
```
xattr -cr "/Applications/Ntfy App.app"
```
## Prerequisites
- **Node.js** 24.x or 25.x
- **pnpm** 10.x or later
- **Rust** 1.93.1 or later (for building)
### From Releases
Download the latest release for your operating system from the [releases page](https://github.com/rubix-studios-pty-ltd/ntfy-app/releases).
### From Source
1. **Clone the repository:**
```bash
git clone https://github.com/rubix-studios-pty-ltd/ntfy-app.git
cd ntfy-app
```
2. **Install dependencies:**
```bash
pnpm install
```
3. **Build the application:**
```bash
pnpm build
```
The executable will be created in `src-tauri/target/release/`.
## Development
### Prerequisites
Install Rust toolchain:
```bash
curl --proto '=https' --tlsv1.2 -sSf https://sh.rustup.rs | sh
```
For macOS, also install additional targets:
```bash
rustup target add aarch64-apple-darwin x86_64-apple-darwin
```
### Running Development
Start the development server:
```bash
pnpm dev
```
This will:
- Start the Next.js dev server on `http://localhost:5173`
- Launch the Tauri development window with hot-reload
### Scripts
```bash
# Development
pnpm dev # Start development server with Tauri
pnpm dev:ui # Start Next.js dev server only (port 5173)
# Building
pnpm build # Build the full Tauri application
pnpm build:ui # Build Next.js frontend only
# Format and Lint
pnpm lint # Run linter (Biome)
pnpm lint:fix # Fix linting issues automatically
pnpm format # Format code with Biome
pnpm typecheck # Check TypeScript types
# Maintenance
pnpm update # Update dependencies interactively
```
## Structure
```
ntfy-app/
├── app/ # Next.js app directory
├── components/ # React components
├── lib/ # Utility functions
├── src-tauri/ # Rust/Tauri backend
│ ├── src/
│ │ ├── main.rs # Application entry point
│ │ ├── window.rs # Window event handling
│ │ ├── tray.rs # System tray setup
│ │ ├── listener.rs # ntfy listener logic
│ │ ├── commands/ # Tauri IPC commands
│ │ └── ...
│ └── tauri.conf.json # Tauri configuration
├── styles/ # Global styles
├── types/ # TypeScript types
├── utils/ # Frontend utilities
└── scripts/ # Build/release scripts
```
## Contributing
We welcome contributions! Please follow these guidelines:
1. Fork the repository
2. Create a feature branch (`git checkout -b feature/amazing-feature`)
3. Make your changes
4. Run linting and type checking:
```bash
pnpm lint:fix
pnpm typecheck
```
5. Commit your changes (`git commit -m 'Add amazing feature'`)
6. Push to the branch (`git push origin feature/amazing-feature`)
7. Open a Pull Request
## Security
Please refer to [SECURITY.md](SECURITY.md) for security vulnerability reporting guidelines.
## Changelog
See [CHANGELOG.md](CHANGELOG.md) for release notes and version history.
## License
This project is licensed under the MIT License - see the [LICENSE](LICENSE) file for details.
## Support
For support or inquiries:
- LinkedIn: [rubixvi](https://www.linkedin.com/in/rubixvi/)
- Website: [Rubix Studios](https://rubixstudios.com.au)
## Author
Rubix Studios
[https://rubixstudios.com.au](https://rubixstudios.com.au)