https://github.com/liboyang0112/smac

A Simple MQTT Android Client. Simple to use: Fill in host, user and password, and press connect.
https://github.com/liboyang0112/smac

android client mqtt

Last synced: about 2 months ago
JSON representation

A Simple MQTT Android Client. Simple to use: Fill in host, user and password, and press connect.

• Host: GitHub
• URL: https://github.com/liboyang0112/smac
• Owner: liboyang0112
• License: mpl-2.0
• Created: 2025-11-03T02:19:40.000Z (8 months ago)
• Default Branch: main
• Last Pushed: 2025-11-03T03:47:26.000Z (8 months ago)
• Last Synced: 2025-11-03T05:26:53.959Z (8 months ago)
• Topics: android, client, mqtt
• Language: Kotlin
• Homepage:
• Size: 146 KB
• Stars: 0
• Watchers: 0
• Forks: 0
• Open Issues: 0
• Metadata Files:
  • Readme: README.md
  • License: LICENSE

Awesome Lists containing this project

README

          
# MQTT Notifier for Android

![SMAC Demo](assets/demo.jpg)

https://github.com/liboyang0112/smac.git

A lightweight foreground service-based Android app that listens to MQTT messages and shows instant notifications. Perfect for home automation alerts, IoT monitoring, or remote logging and debugging.

Built with Kotlin, `MqttAndroidClient`, and foreground services to ensure reliable delivery — even when the app is in the background.

> ✅ Releases are tested on Redmi K50.

---

## 🚀 Features

- 🔔 Real-time MQTT message notifications

- 🔐 Supports username/password authentication

- 📱 Persistent foreground service (won’t die in background)

- 🔊 High-priority notifications with vibration

- 🎯 Auto-reconnects on network loss

- 🧩 Clean Kotlin + Coroutines architecture

- 💡 Toggles connect/disconnect from UI

- 🔄 Survives app restarts (`START_STICKY`)

---

## 📷 How It Works

1. App connects to your MQTT broker (e.g., Mosquitto, EMQX, HiveMQ).

2. Subscribes to a topic like `notifications/warning`.

3. When a message arrives, it shows a default-priority notification.

4. Runs in foreground with persistent notification to avoid being killed.

---

## 📄 License & Ownership

This project is © 2025 Boyang Li.

All rights reserved except as granted under the [Mozilla Public License 2.0 (MPL-2.0)](LICENSE).

- ✅ You are free to use, modify, and distribute this app.

- 🔒 Modifications to original files must remain open under MPL-2.0.

- 🚫 Do not repackage and sell this app as your own product.

- 🙏 Please credit the original author if used in public projects.