diff --git a/android/app/src/main/AndroidManifest.xml b/android/app/src/main/AndroidManifest.xml
index 3bb75c69..0d27210f 100644
--- a/android/app/src/main/AndroidManifest.xml
+++ b/android/app/src/main/AndroidManifest.xml
@@ -34,6 +34,18 @@
+
+
+
+
+
+
+
+ if (call.method != "update") {
+ result.notImplemented()
+ return@setMethodCallHandler
+ }
+ context.getSharedPreferences(PREFS, Context.MODE_PRIVATE)
+ .edit()
+ .putInt("dm", call.argument("dm") ?: 0)
+ .putInt("channels", call.argument("channels") ?: 0)
+ .putInt("battery", call.argument("battery") ?: -1)
+ .putBoolean(
+ "connected",
+ call.argument("connected") ?: false,
+ )
+ .apply()
+ refresh(context)
+ result.success(null)
+ }
+ }
+
+ private fun refresh(context: Context) {
+ val manager = AppWidgetManager.getInstance(context)
+ val ids = manager.getAppWidgetIds(
+ ComponentName(context, UnreadWidget::class.java),
+ )
+ if (ids.isEmpty()) return
+ val views = render(context)
+ ids.forEach { manager.updateAppWidget(it, views) }
+ }
+
+ private fun render(context: Context): RemoteViews {
+ val prefs = context.getSharedPreferences(PREFS, Context.MODE_PRIVATE)
+ val dm = prefs.getInt("dm", 0)
+ val channels = prefs.getInt("channels", 0)
+ val battery = prefs.getInt("battery", -1)
+ val connected = prefs.getBoolean("connected", false)
+
+ val views = RemoteViews(context.packageName, R.layout.unread_widget)
+ views.setTextViewText(R.id.widget_dm, "dm ${count(dm)}")
+ views.setTextColor(R.id.widget_dm, if (dm > 0) GREEN else DIM)
+ views.setTextViewText(R.id.widget_channels, "ch ${count(channels)}")
+ views.setTextColor(R.id.widget_channels, if (channels > 0) GREEN else DIM)
+ views.setTextViewText(
+ R.id.widget_battery,
+ if (battery < 0) "bt --" else "bt $battery%",
+ )
+ views.setTextColor(
+ R.id.widget_battery,
+ when {
+ !connected || battery < 0 -> DIM
+ battery <= 20 -> RED
+ else -> INK
+ },
+ )
+
+ val launch = context.packageManager
+ .getLaunchIntentForPackage(context.packageName)
+ ?.addFlags(Intent.FLAG_ACTIVITY_NEW_TASK or Intent.FLAG_ACTIVITY_SINGLE_TOP)
+ if (launch != null) {
+ views.setOnClickPendingIntent(
+ R.id.widget_root,
+ PendingIntent.getActivity(
+ context,
+ 0,
+ launch,
+ PendingIntent.FLAG_UPDATE_CURRENT or PendingIntent.FLAG_IMMUTABLE,
+ ),
+ )
+ }
+ return views
+ }
+
+ private fun count(n: Int) = if (n > 99) "99+" else n.toString()
+ }
+}
diff --git a/android/app/src/main/res/layout/unread_widget.xml b/android/app/src/main/res/layout/unread_widget.xml
new file mode 100644
index 00000000..6321e6be
--- /dev/null
+++ b/android/app/src/main/res/layout/unread_widget.xml
@@ -0,0 +1,42 @@
+
+
+
+
+
+
+
+
+
+
diff --git a/android/app/src/main/res/values/tth_strings.xml b/android/app/src/main/res/values/tth_strings.xml
new file mode 100644
index 00000000..ca536ebd
--- /dev/null
+++ b/android/app/src/main/res/values/tth_strings.xml
@@ -0,0 +1,5 @@
+
+
+
+ Unread direct and channel messages, companion battery
+
diff --git a/android/app/src/main/res/xml/unread_widget_info.xml b/android/app/src/main/res/xml/unread_widget_info.xml
new file mode 100644
index 00000000..567d1966
--- /dev/null
+++ b/android/app/src/main/res/xml/unread_widget_info.xml
@@ -0,0 +1,12 @@
+
+
+
diff --git a/lib/main.dart b/lib/main.dart
index 68f858f7..269da2be 100644
--- a/lib/main.dart
+++ b/lib/main.dart
@@ -23,6 +23,7 @@ import 'services/storage_service.dart';
import 'services/message_retry_service.dart';
import 'services/path_history_service.dart';
import 'services/app_settings_service.dart';
+import 'services/home_widget_bridge.dart';
import 'services/network_map/network_map_upload_service.dart';
import 'services/notification_service.dart';
import 'services/ble_debug_log_service.dart';
@@ -64,6 +65,7 @@ void main() async {
// Initialize services
final storage = StorageService();
final connector = MeshCoreConnector();
+ HomeWidgetBridge(connector).start(); // tth fork: home-screen widget
final pathHistoryService = PathHistoryService(storage);
final retryService = MessageRetryService();
final appSettingsService = AppSettingsService();
diff --git a/lib/services/home_widget_bridge.dart b/lib/services/home_widget_bridge.dart
new file mode 100644
index 00000000..f101d663
--- /dev/null
+++ b/lib/services/home_widget_bridge.dart
@@ -0,0 +1,47 @@
+import 'package:flutter/services.dart';
+
+import '../connector/meshcore_connector.dart';
+import '../utils/app_logger.dart';
+import '../utils/platform_info.dart';
+
+/// tth fork: feeds the 1x1 Android home-screen widget (UnreadWidget.kt) with
+/// unread direct messages, unread channel messages and the companion's
+/// battery. Pushes only when one of those changes - the connector notifies
+/// on every frame.
+class HomeWidgetBridge {
+ static const _channel = MethodChannel('meshcore_open/home_widget');
+
+ final MeshCoreConnector _connector;
+ ({int dm, int channels, int? battery, bool connected})? _last;
+
+ HomeWidgetBridge(this._connector);
+
+ void start() {
+ if (!PlatformInfo.isAndroid) return;
+ _connector.addListener(_onChanged);
+ _onChanged();
+ }
+
+ void _onChanged() {
+ final connected = _connector.isConnected;
+ final state = (
+ dm: _connector.getTotalContactsUnreadCount(),
+ channels: _connector.getTotalChannelsUnreadCount(),
+ // Keep the last known level while disconnected; the widget dims it.
+ battery: _connector.batteryPercent ?? _last?.battery,
+ connected: connected,
+ );
+ if (state == _last) return;
+ _last = state;
+ _channel
+ .invokeMethod('update', {
+ 'dm': state.dm,
+ 'channels': state.channels,
+ 'battery': state.battery ?? -1,
+ 'connected': state.connected,
+ })
+ .catchError((Object e) {
+ appLogger.warn('home widget update failed: $e', noNotify: true);
+ });
+ }
+}