Project Status | 项目状态 Designed for long-term, unattended operation on Pi-Star systems. Actively maintained and validated in real-world hotspot deployments.
本项目面向 Pi-Star 的长期稳定运行场景设计， 已在真实热点环境中验证并持续维护， 优先保证稳定性、性能与兼容性。
A high-performance notification system for Pi-Star / MMDVM 一个为 Pi-Star / MMDVM 设计的高性能通联与系统状态推送工具
MMDVM-Push-Notifier 是一个专为 Pi-Star 数字语音热点 设计的实时推送通知工具。
它通过解析 MMDVMHost 运行日志，自动识别 语音 / 数据通联事件，并将结构化信息推送至多个平台。
MMDVM-Push-Notifier is a real-time notification system designed specifically for Pi-Star based MMDVM hotspots.
It monitors MMDVMHost logs and sends structured notifications for voice and data transmissions.
支持 / Supported platforms:
- 📢 Telegram
- 📢 WeChat (PushPlus)
- 📢 Feishu (Lark Webhook)
- 语音 / 数据通联自动识别 Automatic detection of voice and data transmissions
- 呼号、群组、时长、误码率、丢包率解析 Callsign, talkgroup, duration, BER and packet loss parsing
- DMR Slot 1 / Slot 2 自动识别 Automatic Slot 1 / Slot 2 detection
- 最短通联时长过滤 Minimum transmission duration filter
- 本地解析
nextionUsers.csv（无需外部 API） Local lookup vianextionUsers.csv(no external API) - 姓名 + 地区显示（如可用） Name and location display when available
- 国家 Emoji + 中文名称映射 Country emoji with Chinese localization
- mmap + LRU Cache，高性能低占用 High performance via mmap + LRU cache
- 系统启动上线通知 Boot / online notification
- IP / CPU / 内存 / 温度信息 IP, CPU, memory and temperature reporting
- 硬件高温告警（可配置） Configurable high temperature alerts
- 呼号白名单（focus_list） Callsign whitelist
- 呼号黑名单（ignore_list） Callsign blacklist
- 免打扰时段（quiet mode） Quiet hours / Do-Not-Disturb mode
- 重复推送抑制 Duplicate notification suppression
- Pi-Star Dashboard 原生集成 Native Pi-Star dashboard integration
- 无需手动编辑 JSON No manual JSON editing required
- 配置热加载（即时生效） Hot-reload configuration without restart
- 一键更新脚本
update.shOne-click update script - 保留所有用户配置 User configuration preserved
- 自动修复权限并重启服务 Automatic permission fix and service restart
- Pi-Star (official or compatible build)
- Python 3 (included in Pi-Star)
- Running MMDVMHost service
MMDVM-Push-Notifier/
├── mmdvm_push.py # 核心服务入口，日志轮询/推送/健康输出
├── alerts.py # 告警管理和触发
├── parser.py # 日志解析（语音/数据、呼号、时长、时隙等）
├── identity.py # 呼号检索与缓存（呼号、姓名、地区等）
├── hardware.py # 系统资源与温度报警（IP、内存，CPU等）
├── notifier.py # 推送服务及重试逻辑（微信、TG、飞书等）
├── config.py # 配置加载与校验（检验现有配置）
├── filters.py # 过滤策略（白/黑名单、静音时段、重复抑制等）
├── notify_fmt.py # 推送文案格式化（中英文/i18n）
├── push_admin.php # Web 管理面板（含健康状态只读面板）
├── install.sh # 安装脚本（完整性检查、最小权限）
├── update.sh # 更新脚本（完整性检查、健康输出）
├── uninstall.sh # 卸载脚本（多路径清理、sudoers.d 规则清理）
├── diagnose.sh # 诊断脚本（一键检查服务状态、日志、网络、推送测试）
├── mmdvm_push.service # systemd 服务（资源限制、自动重启）
└── tests/ # 轻量单元测试（parser/filters/notify）
rpi-rw
cd /home/pi-star
git clone https://github.com/fnshiwu/MMDVM-Push-Notifier.git
cd MMDVM-Push-Notifier
sudo bash install.shsudo python3 /home/pi-star/MMDVM-Push-Notifier/mmdvm_push.py --testsudo python3 /home/pi-star/MMDVM-Push-Notifier/mmdvm_push.py --healthcd /home/pi-star/MMDVM-Push-Notifier
sudo bash diagnose.sh自动检查：服务状态、进程、日志、配置、网络、推送功能 Auto checks: service status, process, logs, config, network, push function
访问 / Access:
http://pi-star.local/admin/push_admin.php
配置文件 / Configuration file:
/etc/mmdvm_push.json
配置修改后自动生效，无需重启服务。 Configuration changes take effect automatically without restarting the service.
rpi-rw
cd /home/pi-star/MMDVM-Push-Notifier
sudo bash update.shrpi-rw
cd /home/pi-star/MMDVM-Push-Notifier
sudo bash uninstall.sh- mmap + regex based log parsing
- ThreadPool + semaphore controlled concurrency
- Hot-reload configuration design
- Deep integration with Pi-Star filesystem and permission model
- Callsign: BA4SMQ
- QTH: Jiangsu Funing, China