Skip to content

tobagin/Ntfyr

 
 

Repository files navigation

Ntfyr

A native ntfy.sh client for the GNOME Desktop.

Ntfyr Application

Get it on Flathub Support me on Ko-Fi

🎉 Version 0.4.1 - Quick Fix

Ntfyr 0.4.1 is a quick fix release to address AppStream metadata issues.

✨ Key Features

  • 🚀 Native and Fast: Built with Rust and GTK4 for a smooth, native experience.
  • 📨 Push Notifications: Instant notifications from ntfy.sh or self-hosted servers.
  • 🔐 End-to-End Encryption: Send and receive encrypted messages securely.
  • 🛡️ App Locking: Protect your messages with a PIN code.
  • 🔄 Background Service: Runs reliably in the background via system portals.
  • 📂 Attachments: View images and download files directly within the app.
  • 🧩 Multiple Servers: Group subscriptions by server for better organizational.
  • 🛡️ Privacy Focused: Full support for self-hosted instances.

🆕 What's New in 0.4.1

  • Fixed: AppStream metadata validation.
  • Improved: Release description formatting.

For detailed release notes and version history, see CHANGELOG.md.

Features

Core Features

  • Native Desktop Integration: Uses GTK4 and Libadwaita for a perfect GNOME fit.
  • Unified Server Management: Manage subscriptions from ntfy.sh and custom servers in one list.
  • Persistent Connection: Daemonized backend ensures you never miss a notification.

User Experience

  • Action Buttons: Interact with notifications (Open Link, HTTP actions).
  • Shortcuts: Keyboard shortcuts for quick navigation (Ctrl+,, F1, Ctrl+N).
  • System Tray: Quick access and unread status indication.
  • Dark Mode: Fully supports system-wide dark theme preference.

Privacy & Customization

  • Self-Hosted Support: Connect to your own ntfy server instances.
  • Local History: Notifications are cached locally for offline viewing.
  • No Telemetry: Your data stays on your machine.

Building from Source

# Clone the repository
git clone https://github.com/tobagin/Ntfyr.git
cd Ntfyr

# Build and install development version
./build.sh --dev

Usage

Basic Usage

Launch Ntfyr from your applications menu or run:

flatpak run io.github.tobagin.Ntfyr
  1. Click the + button to add a subscription.
  2. Enter the topic component (e.g., mytopic).
  3. (Optional) Select or add a custom server.

Sending Notifications

You can test Ntfyr using curl:

curl -d "Hello from CLI" ntfy.sh/mytopic

Keyboard Shortcuts

  • Ctrl+, - Open Preferences
  • Ctrl+Q - Quit Application
  • F1 - Show Shortcuts Help
  • Ctrl+N - Subscribe to new topic
  • Ctrl+F - Search notifications

Privacy & Security

Ntfyr is designated to respect your privacy:

  • Sandboxed: Distributed as a Flatpak with strict permissions.
  • Local Data: All history and configuration is stored locally.
  • Open Source: Code is fully available for audit.

Contributing

Contributions are welcome! Please see CONTRIBUTING.md for guidelines.

License

Ntfyr is licensed under the GPL-3.0-or-later.

Acknowledgments

  • ntfy.sh: For the amazing notification platform.
  • GNOME: For the GTK toolkit.
  • Rust: For the language.

Screenshots

Main Window Topics View Preferences
Main Window Topics Preferences

Ntfyr - A native ntfy.sh client for the GNOME Desktop.

About

Linux client for https://ntfy.sh

Resources

License

Contributing

Stars

Watchers

Forks

Packages

No packages published

Languages

  • Rust 91.1%
  • Python 5.5%
  • Meson 2.3%
  • Other 1.1%