← Back
wsgsc

wsgsc/NtfyChat

A chat system based on ntfy

View on GitHub ↗
Stars
347
Forks
0
Watchers
347
Open issues
0
Contributors
1
Language
Kotlin
License
—
Default branch
main
Created Sep 3, 2026Updated Sep 10, 2026

Star growth

Today—
This week—
This month—

Star history will appear here once this repo has been tracked for a couple of days.

README

NtfyChat - Open Source Instant Messaging App

English | 简体中文


Overview

NtfyChat is an open-source instant messaging application based on ntfy.

How it works: You can set up a subscription topic, username, and encryption password. When two users share the same subscription topic and encryption password, they can communicate securely. The implementation uses symmetric encryption algorithms, making it simple yet effective for private messaging.

Features

  • 📱 Real-time messaging based on ntfy protocol
  • 🚀 No server configuration needed - uses official ntfy.sh by default
  • 🔒 End-to-end encryption support
  • 🌐 Self-hosted server option
  • 📎 File and image sharing
  • 🎨 Material Design UI
  • 🔔 Push notifications
  • 💬 Group chat support

Download

  • Google Play Store: Coming soon
  • F-Droid: Coming soon
  • GitHub Releases: Download APK

Build Instructions

For detailed build instructions, please refer to the official ntfy docs.

# Clone the repository
git clone https://github.com/wsgsc/NtfyChat.git
cd NtfyChat

# Build the app
./gradlew assembleRelease

Technology Stack

  • Language: Kotlin
  • Architecture: MVVM + Repository Pattern
  • Database: Room (SQLite)
  • Networking: OkHttp
  • UI: Material Design Components
  • Dependency Injection: Manual DI
  • Push Notifications: Firebase Cloud Messaging (Play variant only)

Contributing

We welcome contributions! Please feel free to submit pull requests or open issues.

Translations

We use Weblate for translations. Contributions are welcome!

License

Distributed under the Apache License 2.0.

Based on ntfy by Philipp C. Heckel.