Skip to content

A cross platform Audiobookshelf client for Android and iOS

Dart

WIP: Add now playing homescreen widget

Nathan Poulson3d04cbd38079
diff --git a/android/app/proguard-rules.pro b/android/app/proguard-rules.pro
index 83555133..bef5cc96 100644
--- a/android/app/proguard-rules.pro
+++ b/android/app/proguard-rules.pro
@@ -24,3 +24,6 @@
-keepclasseswithmembernames class * {
native <methods>;
}
+
+# home_widget
+-keep class es.antonborri.home_widget.** { *; }
diff --git a/android/app/src/main/AndroidManifest.xml b/android/app/src/main/AndroidManifest.xml
index 925a969d..c438c93d 100644
--- a/android/app/src/main/AndroidManifest.xml
+++ b/android/app/src/main/AndroidManifest.xml
@@ -26,7 +26,6 @@
<action android:name="com.ryanheise.audioservice.NOTIFICATION_CLICK"/>
<category android:name="android.intent.category.DEFAULT"/>
</intent-filter>
-
</activity>
<!-- OIDC callback via Chrome Custom Tab (flutter_web_auth_2) -->
@@ -97,6 +96,20 @@
android:resource="@xml/file_paths" />
</provider>
+ <!-- Now Playing homescreen widget -->
+ <receiver
+ android:name=".NowPlayingWidget"
+ android:exported="true">
+ <intent-filter>
+ <action android:name="android.appwidget.action.APPWIDGET_UPDATE" />
+ </intent-filter>
+ <meta-data
+ android:name="android.appwidget.provider"
+ android:resource="@xml/now_playing_widget_info" />
+ </receiver>
+
+
+
</application>
<queries>
diff --git a/android/app/src/main/kotlin/com/barnabas/absorb/NowPlayingWidget.kt b/android/app/src/main/kotlin/com/barnabas/absorb/NowPlayingWidget.kt
new file mode 100644
index 00000000..fe2abe5c
--- /dev/null
+++ b/android/app/src/main/kotlin/com/barnabas/absorb/NowPlayingWidget.kt
@@ -0,0 +1,178 @@
+package com.barnabas.absorb
+
+import android.appwidget.AppWidgetManager
+import android.appwidget.AppWidgetProvider
+import android.app.PendingIntent
+import android.content.ComponentName
+import android.content.Context
+import android.content.Intent
+import android.graphics.Bitmap
+import android.graphics.BitmapFactory
+import android.graphics.Canvas
+import android.graphics.Paint
+import android.graphics.PorterDuff
+import android.graphics.PorterDuffXfermode
+import android.graphics.RectF
+import android.view.KeyEvent
+import android.view.View
+import android.widget.RemoteViews
+import es.antonborri.home_widget.HomeWidgetPlugin
+import java.io.File
+
+class NowPlayingWidget : AppWidgetProvider() {
+
+ override fun onUpdate(
+ context: Context,
+ appWidgetManager: AppWidgetManager,
+ appWidgetIds: IntArray
+ ) {
+ for (appWidgetId in appWidgetIds) {
+ updateWidget(context, appWidgetManager, appWidgetId)
+ }
+ }
+
+ companion object {
+ private fun roundBitmap(bitmap: Bitmap, radiusDp: Float, context: Context): Bitmap {
+ val density = context.resources.displayMetrics.density
+ val radiusPx = radiusDp * density
+ val output = Bitmap.createBitmap(bitmap.width, bitmap.height, Bitmap.Config.ARGB_8888)
+ val canvas = Canvas(output)
+ val paint = Paint(Paint.ANTI_ALIAS_FLAG)
+ val rect = RectF(0f, 0f, bitmap.width.toFloat(), bitmap.height.toFloat())
+ canvas.drawRoundRect(rect, radiusPx, radiusPx, paint)
+ paint.xfermode = PorterDuffXfermode(PorterDuff.Mode.SRC_IN)
+ canvas.drawBitmap(bitmap, 0f, 0f, paint)
+ return output
+ }
+
+ private fun blurredBackground(source: Bitmap, radiusDp: Float, context: Context): Bitmap {
+ // Crop center band to ~2:1 aspect ratio (zoomed-in center, no stretching)
+ val srcW = source.width
+ val srcH = source.height
+ val cropH = (srcW / 2).coerceAtMost(srcH)
+ val cropY = (srcH - cropH) / 2
+ val cropped = Bitmap.createBitmap(source, 0, cropY, srcW, cropH)
+
+ // Scale down to tiny size then back up = cheap blur
+ val small = Bitmap.createScaledBitmap(cropped, 16, 8, true)
+ val blurred = Bitmap.createScaledBitmap(small, 400, 200, true)
+
+ // Darken so white text stays readable
+ val output = blurred.copy(Bitmap.Config.ARGB_8888, true)
+ val canvas = Canvas(output)
+ val paint = Paint()
+ paint.color = 0xAA000000.toInt() // ~67% black overlay
+ canvas.drawRect(0f, 0f, 400f, 200f, paint)
+
+ return output
+ }
+
+ private fun mediaButtonPendingIntent(
+ context: Context,
+ keyCode: Int,
+ requestCode: Int
+ ): PendingIntent {
+ val intent = Intent(Intent.ACTION_MEDIA_BUTTON).apply {
+ component = ComponentName(
+ context,
+ "com.ryanheise.audioservice.MediaButtonReceiver"
+ )
+ putExtra(
+ Intent.EXTRA_KEY_EVENT,
+ KeyEvent(KeyEvent.ACTION_DOWN, keyCode)
+ )
+ }
+ return PendingIntent.getBroadcast(
+ context, requestCode, intent,
+ PendingIntent.FLAG_IMMUTABLE or PendingIntent.FLAG_UPDATE_CURRENT
+ )
+ }
+
+ private fun updateWidget(
+ context: Context,
+ appWidgetManager: AppWidgetManager,
+ appWidgetId: Int
+ ) {
+ val widgetData = HomeWidgetPlugin.getData(context)
+ val views = RemoteViews(context.packageName, R.layout.now_playing_widget)
+
+ val title = widgetData.getString("widget_title", null)
+ val author = widgetData.getString("widget_author", null)
+ val isPlaying = widgetData.getBoolean("widget_is_playing", false)
+ val progress = widgetData.getInt("widget_progress", 0)
+ val coverPath = widgetData.getString("widget_cover_path", null)
+
+ if (!title.isNullOrEmpty()) {
+ views.setTextViewText(R.id.widget_title, title)
+ views.setTextViewText(R.id.widget_author, author ?: "")
+ views.setProgressBar(R.id.widget_progress, 1000, progress, false)
+ views.setViewVisibility(R.id.widget_progress, View.VISIBLE)
+ views.setViewVisibility(R.id.widget_controls, View.VISIBLE)
+
+ if (isPlaying) {
+ views.setImageViewResource(R.id.widget_play_pause, R.drawable.ic_widget_pause)
+ } else {
+ views.setImageViewResource(R.id.widget_play_pause, R.drawable.ic_widget_play)
+ }
+
+ // Cover art from file (rounded corners + blurred background)
+ if (coverPath != null) {
+ val file = File(coverPath)
+ if (file.exists()) {
+ val options = BitmapFactory.Options().apply { inSampleSize = 2 }
+ val bitmap = BitmapFactory.decodeFile(file.absolutePath, options)
+ if (bitmap != null) {
+ views.setImageViewBitmap(R.id.widget_cover, roundBitmap(bitmap, 16f, context))
+ views.setImageViewBitmap(R.id.widget_bg_blur, blurredBackground(bitmap, 24f, context))
+ views.setViewVisibility(R.id.widget_bg_blur, View.VISIBLE)
+ } else {
+ views.setImageViewResource(R.id.widget_cover, R.mipmap.ic_launcher)
+ views.setViewVisibility(R.id.widget_bg_blur, View.GONE)
+ }
+ } else {
+ views.setImageViewResource(R.id.widget_cover, R.mipmap.ic_launcher)
+ views.setViewVisibility(R.id.widget_bg_blur, View.GONE)
+ }
+ } else {
+ views.setImageViewResource(R.id.widget_cover, R.mipmap.ic_launcher)
+ views.setViewVisibility(R.id.widget_bg_blur, View.GONE)
+ }
+ } else {
+ // Idle state
+ views.setTextViewText(R.id.widget_title, "Absorb")
+ views.setTextViewText(R.id.widget_author, "Not playing")
+ views.setProgressBar(R.id.widget_progress, 1000, 0, false)
+ views.setViewVisibility(R.id.widget_progress, View.INVISIBLE)
+ views.setViewVisibility(R.id.widget_controls, View.GONE)
+ views.setImageViewResource(R.id.widget_cover, R.mipmap.ic_launcher)
+ views.setViewVisibility(R.id.widget_bg_blur, View.GONE)
+ }
+
+ // Tap widget body to bring existing app to front
+ val launchIntent = context.packageManager.getLaunchIntentForPackage(context.packageName)
+ if (launchIntent != null) {
+ launchIntent.addFlags(Intent.FLAG_ACTIVITY_NEW_TASK or Intent.FLAG_ACTIVITY_CLEAR_TOP)
+ val pendingIntent = PendingIntent.getActivity(
+ context, 0, launchIntent,
+ PendingIntent.FLAG_IMMUTABLE or PendingIntent.FLAG_UPDATE_CURRENT
+ )
+ views.setOnClickPendingIntent(R.id.widget_root, pendingIntent)
+ }
+
+ // Playback controls via MediaSession (same as notification/headphone buttons)
+ views.setOnClickPendingIntent(
+ R.id.widget_skip_back,
+ mediaButtonPendingIntent(context, KeyEvent.KEYCODE_MEDIA_REWIND, 2)
+ )
+ views.setOnClickPendingIntent(
+ R.id.widget_play_pause,
+ mediaButtonPendingIntent(context, KeyEvent.KEYCODE_MEDIA_PLAY_PAUSE, 1)
+ )
+ views.setOnClickPendingIntent(
+ R.id.widget_skip_forward,
+ mediaButtonPendingIntent(context, KeyEvent.KEYCODE_MEDIA_FAST_FORWARD, 3)
+ )
+ appWidgetManager.updateAppWidget(appWidgetId, views)
+ }
+ }
+}
diff --git a/android/app/src/main/res/drawable/ic_widget_next_chapter.xml b/android/app/src/main/res/drawable/ic_widget_next_chapter.xml
new file mode 100644
index 00000000..70f538ae
--- /dev/null
+++ b/android/app/src/main/res/drawable/ic_widget_next_chapter.xml
@@ -0,0 +1,9 @@
+<vector xmlns:android="http://schemas.android.com/apk/res/android"
+ android:width="32dp"
+ android:height="32dp"
+ android:viewportWidth="24"
+ android:viewportHeight="24">
+ <path
+ android:fillColor="#FFFFFF"
+ android:pathData="M6,18l8.5,-6L6,6v12zM16,6v12h2V6h-2z"/>
+</vector>
diff --git a/android/app/src/main/res/drawable/ic_widget_pause.xml b/android/app/src/main/res/drawable/ic_widget_pause.xml
new file mode 100644
index 00000000..ef324a69
--- /dev/null
+++ b/android/app/src/main/res/drawable/ic_widget_pause.xml
@@ -0,0 +1,9 @@
+<vector xmlns:android="http://schemas.android.com/apk/res/android"
+ android:width="36dp"
+ android:height="36dp"
+ android:viewportWidth="24"
+ android:viewportHeight="24">
+ <path
+ android:fillColor="#FFFFFF"
+ android:pathData="M6,19h4V5H6v14zM14,5v14h4V5h-4z"/>
+</vector>
diff --git a/android/app/src/main/res/drawable/ic_widget_pause_dark.xml b/android/app/src/main/res/drawable/ic_widget_pause_dark.xml
new file mode 100644
index 00000000..96f6145b
--- /dev/null
+++ b/android/app/src/main/res/drawable/ic_widget_pause_dark.xml
@@ -0,0 +1,9 @@
+<vector xmlns:android="http://schemas.android.com/apk/res/android"
+ android:width="24dp"
+ android:height="24dp"
+ android:viewportWidth="24"
+ android:viewportHeight="24">
+ <path
+ android:fillColor="#000000"
+ android:pathData="M6,19h4V5H6v14zM14,5v14h4V5h-4z"/>
+</vector>
diff --git a/android/app/src/main/res/drawable/ic_widget_play.xml b/android/app/src/main/res/drawable/ic_widget_play.xml
new file mode 100644
index 00000000..e74d028a
--- /dev/null
+++ b/android/app/src/main/res/drawable/ic_widget_play.xml
@@ -0,0 +1,9 @@
+<vector xmlns:android="http://schemas.android.com/apk/res/android"
+ android:width="36dp"
+ android:height="36dp"
+ android:viewportWidth="24"
+ android:viewportHeight="24">
+ <path
+ android:fillColor="#FFFFFF"
+ android:pathData="M8,5v14l11,-7z"/>
+</vector>
diff --git a/android/app/src/main/res/drawable/ic_widget_play_dark.xml b/android/app/src/main/res/drawable/ic_widget_play_dark.xml
new file mode 100644
index 00000000..26763c89
--- /dev/null
+++ b/android/app/src/main/res/drawable/ic_widget_play_dark.xml
@@ -0,0 +1,9 @@
+<vector xmlns:android="http://schemas.android.com/apk/res/android"
+ android:width="24dp"
+ android:height="24dp"
+ android:viewportWidth="24"
+ android:viewportHeight="24">
+ <path
+ android:fillColor="#000000"
+ android:pathData="M8,5v14l11,-7z"/>
+</vector>
diff --git a/android/app/src/main/res/drawable/ic_widget_prev_chapter.xml b/android/app/src/main/res/drawable/ic_widget_prev_chapter.xml
new file mode 100644
index 00000000..74cc73c2
--- /dev/null
+++ b/android/app/src/main/res/drawable/ic_widget_prev_chapter.xml
@@ -0,0 +1,9 @@
+<vector xmlns:android="http://schemas.android.com/apk/res/android"
+ android:width="32dp"
+ android:height="32dp"
+ android:viewportWidth="24"
+ android:viewportHeight="24">
+ <path
+ android:fillColor="#FFFFFF"
+ android:pathData="M6,6h2v12H6V6zM9.5,12l8.5,6V6l-8.5,6z"/>
+</vector>
diff --git a/android/app/src/main/res/drawable/ic_widget_skip_back.xml b/android/app/src/main/res/drawable/ic_widget_skip_back.xml
new file mode 100644
index 00000000..6768faf8
--- /dev/null
+++ b/android/app/src/main/res/drawable/ic_widget_skip_back.xml
@@ -0,0 +1,9 @@
+<vector xmlns:android="http://schemas.android.com/apk/res/android"
+ android:width="32dp"
+ android:height="32dp"
+ android:viewportWidth="24"
+ android:viewportHeight="24">
+ <path
+ android:fillColor="#FFFFFF"
+ android:pathData="M12,5V1L7,6l5,5V7c3.31,0 6,2.69 6,6s-2.69,6 -6,6 -6,-2.69 -6,-6H4c0,4.42 3.58,8 8,8s8,-3.58 8,-8 -3.58,-8 -8,-8z"/>
+</vector>
diff --git a/android/app/src/main/res/drawable/ic_widget_skip_forward.xml b/android/app/src/main/res/drawable/ic_widget_skip_forward.xml
new file mode 100644
index 00000000..c09a7132
--- /dev/null
+++ b/android/app/src/main/res/drawable/ic_widget_skip_forward.xml
@@ -0,0 +1,9 @@
+<vector xmlns:android="http://schemas.android.com/apk/res/android"
+ android:width="32dp"
+ android:height="32dp"
+ android:viewportWidth="24"
+ android:viewportHeight="24">
+ <path
+ android:fillColor="#FFFFFF"
+ android:pathData="M18,13c0,3.31 -2.69,6 -6,6s-6,-2.69 -6,-6 2.69,-6 6,-6v4l5,-5 -5,-5v4c-4.42,0 -8,3.58 -8,8s3.58,8 8,8 8,-3.58 8,-8h-2z"/>
+</vector>
diff --git a/android/app/src/main/res/drawable/widget_background.xml b/android/app/src/main/res/drawable/widget_background.xml
new file mode 100644
index 00000000..a651d6da
--- /dev/null
+++ b/android/app/src/main/res/drawable/widget_background.xml
@@ -0,0 +1,6 @@
+<?xml version="1.0" encoding="utf-8"?>
+<shape xmlns:android="http://schemas.android.com/apk/res/android"
+ android:shape="rectangle">
+ <solid android:color="#E8000000" />
+ <corners android:radius="24dp" />
+</shape>
diff --git a/android/app/src/main/res/drawable/widget_cover_bg.xml b/android/app/src/main/res/drawable/widget_cover_bg.xml
new file mode 100644
index 00000000..35d58c10
--- /dev/null
+++ b/android/app/src/main/res/drawable/widget_cover_bg.xml
@@ -0,0 +1,6 @@
+<?xml version="1.0" encoding="utf-8"?>
+<shape xmlns:android="http://schemas.android.com/apk/res/android"
+ android:shape="rectangle">
+ <solid android:color="#33FFFFFF" />
+ <corners android:radius="16dp" />
+</shape>
diff --git a/android/app/src/main/res/drawable/widget_play_button_bg.xml b/android/app/src/main/res/drawable/widget_play_button_bg.xml
new file mode 100644
index 00000000..9f3c01df
--- /dev/null
+++ b/android/app/src/main/res/drawable/widget_play_button_bg.xml
@@ -0,0 +1,5 @@
+<?xml version="1.0" encoding="utf-8"?>
+<shape xmlns:android="http://schemas.android.com/apk/res/android"
+ android:shape="oval">
+ <solid android:color="#FFFFFF" />
+</shape>
diff --git a/android/app/src/main/res/drawable/widget_progress_bar.xml b/android/app/src/main/res/drawable/widget_progress_bar.xml
new file mode 100644
index 00000000..f7b75b74
--- /dev/null
+++ b/android/app/src/main/res/drawable/widget_progress_bar.xml
@@ -0,0 +1,19 @@
+<?xml version="1.0" encoding="utf-8"?>
+<layer-list xmlns:android="http://schemas.android.com/apk/res/android">
+ <!-- Background track -->
+ <item android:id="@android:id/background">
+ <shape android:shape="rectangle">
+ <solid android:color="#33FFFFFF" />
+ <corners android:radius="2dp" />
+ </shape>
+ </item>
+ <!-- Progress fill -->
+ <item android:id="@android:id/progress">
+ <clip>
+ <shape android:shape="rectangle">
+ <solid android:color="#FFFFFF" />
+ <corners android:radius="2dp" />
+ </shape>
+ </clip>
+ </item>
+</layer-list>
diff --git a/android/app/src/main/res/layout/now_playing_widget.xml b/android/app/src/main/res/layout/now_playing_widget.xml
new file mode 100644
index 00000000..bcad3d0b
--- /dev/null
+++ b/android/app/src/main/res/layout/now_playing_widget.xml
@@ -0,0 +1,136 @@
+<?xml version="1.0" encoding="utf-8"?>
+<!-- Outer wrapper: padding creates space between widget cell and the card -->
+<FrameLayout xmlns:android="http://schemas.android.com/apk/res/android"
+ android:layout_width="match_parent"
+ android:layout_height="match_parent"
+ android:paddingStart="5dp"
+ android:paddingEnd="5dp"
+ android:paddingTop="35dp"
+ android:paddingBottom="35dp">
+
+ <!-- The card -->
+ <RelativeLayout
+ android:id="@+id/widget_root"
+ android:layout_width="match_parent"
+ android:layout_height="match_parent"
+ android:background="@drawable/widget_background"
+ android:clipToOutline="true">
+
+ <!-- Blurred cover background (behind everything) -->
+ <ImageView
+ android:id="@+id/widget_bg_blur"
+ android:layout_width="match_parent"
+ android:layout_height="match_parent"
+ android:scaleType="fitXY"
+ android:visibility="gone" />
+
+ <!-- Cover art: fixed square, small left margin, centered vertically -->
+ <ImageView
+ android:id="@+id/widget_cover"
+ android:layout_width="105dp"
+ android:layout_height="105dp"
+ android:layout_alignParentStart="true"
+ android:layout_centerVertical="true"
+ android:layout_marginStart="6dp"
+ android:scaleType="centerCrop"
+ android:src="@mipmap/ic_launcher"
+ android:contentDescription="Cover art" />
+
+ <!-- Title aligned with top of cover -->
+ <TextView
+ android:id="@+id/widget_title"
+ android:layout_width="match_parent"
+ android:layout_height="wrap_content"
+ android:layout_toEndOf="@id/widget_cover"
+ android:layout_alignTop="@id/widget_cover"
+ android:paddingStart="12dp"
+ android:paddingEnd="12dp"
+ android:text="Absorb"
+ android:textColor="#FFFFFF"
+ android:textSize="16sp"
+ android:textStyle="bold"
+ android:maxLines="1"
+ android:ellipsize="end"
+ android:fontFamily="sans-serif-medium" />
+
+ <!-- Controls aligned with bottom of cover -->
+ <LinearLayout
+ android:id="@+id/widget_controls"
+ android:layout_width="match_parent"
+ android:layout_height="wrap_content"
+ android:layout_toEndOf="@id/widget_cover"
+ android:layout_alignBottom="@id/widget_cover"
+ android:orientation="horizontal"
+ android:gravity="center_vertical"
+ android:paddingStart="4dp"
+ android:paddingEnd="4dp"
+ android:visibility="gone">
+
+ <ImageButton
+ android:id="@+id/widget_skip_back"
+ android:layout_width="0dp"
+ android:layout_height="34dp"
+ android:layout_weight="1"
+ android:src="@drawable/ic_widget_skip_back"
+ android:background="@android:color/transparent"
+ android:contentDescription="Skip backward"
+ android:scaleType="centerInside" />
+
+ <ImageButton
+ android:id="@+id/widget_play_pause"
+ android:layout_width="0dp"
+ android:layout_height="38dp"
+ android:layout_weight="1"
+ android:src="@drawable/ic_widget_play"
+ android:background="@android:color/transparent"
+ android:contentDescription="Play or pause"
+ android:scaleType="centerInside" />
+
+ <ImageButton
+ android:id="@+id/widget_skip_forward"
+ android:layout_width="0dp"
+ android:layout_height="34dp"
+ android:layout_weight="1"
+ android:src="@drawable/ic_widget_skip_forward"
+ android:background="@android:color/transparent"
+ android:contentDescription="Skip forward"
+ android:scaleType="centerInside" />
+
+ </LinearLayout>
+
+ <!-- Progress bar just above controls -->
+ <ProgressBar
+ android:id="@+id/widget_progress"
+ style="@android:style/Widget.ProgressBar.Horizontal"
+ android:layout_width="match_parent"
+ android:layout_height="2dp"
+ android:layout_toEndOf="@id/widget_cover"
+ android:layout_above="@id/widget_controls"
+ android:layout_marginStart="12dp"
+ android:layout_marginEnd="12dp"
+ android:layout_marginBottom="2dp"
+ android:max="1000"
+ android:progress="0"
+ android:progressDrawable="@drawable/widget_progress_bar"
+ android:visibility="invisible" />
+
+ <!-- Author centered between title and progress bar -->
+ <TextView
+ android:id="@+id/widget_author"
+ android:layout_width="match_parent"
+ android:layout_height="0dp"
+ android:layout_toEndOf="@id/widget_cover"
+ android:layout_below="@id/widget_title"
+ android:layout_above="@id/widget_progress"
+ android:paddingStart="12dp"
+ android:paddingEnd="12dp"
+ android:gravity="center_vertical"
+ android:text="Not playing"
+ android:textColor="#99FFFFFF"
+ android:textSize="13sp"
+ android:maxLines="1"
+ android:ellipsize="end" />
+
+ </RelativeLayout>
+
+</FrameLayout>
diff --git a/android/app/src/main/res/values/strings.xml b/android/app/src/main/res/values/strings.xml
new file mode 100644
index 00000000..1277ad00
--- /dev/null
+++ b/android/app/src/main/res/values/strings.xml
@@ -0,0 +1,4 @@
+<?xml version="1.0" encoding="utf-8"?>
+<resources>
+ <string name="widget_description">Shows the currently playing audiobook with playback controls.</string>
+</resources>
diff --git a/android/app/src/main/res/xml/now_playing_widget_info.xml b/android/app/src/main/res/xml/now_playing_widget_info.xml
new file mode 100644
index 00000000..7f87b560
--- /dev/null
+++ b/android/app/src/main/res/xml/now_playing_widget_info.xml
@@ -0,0 +1,12 @@
+<?xml version="1.0" encoding="utf-8"?>
+<appwidget-provider xmlns:android="http://schemas.android.com/apk/res/android"
+ android:initialLayout="@layout/now_playing_widget"
+ android:minWidth="250dp"
+ android:minHeight="110dp"
+ android:minResizeWidth="180dp"
+ android:minResizeHeight="110dp"
+ android:resizeMode="horizontal|vertical"
+ android:widgetCategory="home_screen"
+ android:previewImage="@mipmap/ic_launcher"
+ android:description="@string/widget_description"
+ android:updatePeriodMillis="0" />
diff --git a/lib/main.dart b/lib/main.dart
index bc5303e2..b4532dac 100644
--- a/lib/main.dart
+++ b/lib/main.dart
@@ -18,6 +18,7 @@ import 'services/sleep_timer_service.dart';
import 'services/user_account_service.dart';
import 'services/android_auto_service.dart';
import 'services/chromecast_service.dart';
+import 'services/home_widget_service.dart';
import 'services/log_service.dart';
import 'screens/login_screen.dart';
import 'screens/app_shell.dart';
@@ -322,6 +323,8 @@ class _AuthGateState extends State<AuthGate> {
// Pre-populate Android Auto browse tree in background.
// Do not block app startup on Android Auto server refresh.
Future.microtask(() => AndroidAutoService().refresh());
+ // Initialize homescreen widget
+ await HomeWidgetService().init();
} catch (e) {
debugPrint('Service init failed: $e');
}
diff --git a/lib/services/home_widget_service.dart b/lib/services/home_widget_service.dart
new file mode 100644
index 00000000..08c9f202
--- /dev/null
+++ b/lib/services/home_widget_service.dart
@@ -0,0 +1,171 @@
+import 'dart:async';
+import 'dart:io';
+
+import 'package:flutter/foundation.dart';
+import 'package:home_widget/home_widget.dart';
+import 'package:http/http.dart' as http;
+import 'package:path_provider/path_provider.dart';
+
+import 'audio_player_service.dart';
+import 'download_service.dart';
+
+const String _androidWidgetName = 'NowPlayingWidget';
+
+class HomeWidgetService {
+ static final HomeWidgetService _instance = HomeWidgetService._();
+ factory HomeWidgetService() => _instance;
+ HomeWidgetService._();
+
+ Timer? _progressTimer;
+ Timer? _pendingUpdate;
+ String? _lastCoverItemId;
+ DateTime? _lastUpdate;
+ bool _initialized = false;
+ bool _updating = false;
+
+ /// Call after AudioPlayerService is initialized to start pushing state.
+ Future<void> init() async {
+ if (_initialized) return;
+ _initialized = true;
+
+ final player = AudioPlayerService();
+ player.addListener(_onPlayerChanged);
+
+ // Push current state in case a widget already exists.
+ _scheduleUpdate();
+ }
+
+ void dispose() {
+ _progressTimer?.cancel();
+ _pendingUpdate?.cancel();
+ AudioPlayerService().removeListener(_onPlayerChanged);
+ }
+
+ void _onPlayerChanged() {
+ // Throttle to max once per 2 seconds, but never drop an update —
+ // schedule a deferred one so the final state always gets pushed.
+ final now = DateTime.now();
+ if (_lastUpdate != null &&
+ now.difference(_lastUpdate!).inMilliseconds < 2000) {
+ _pendingUpdate?.cancel();
+ _pendingUpdate = Timer(const Duration(seconds: 2), _scheduleUpdate);
+ return;
+ }
+ _scheduleUpdate();
+ }
+
+ /// Schedule an update on the next microtask so we never do async work
+ /// inside the synchronous ChangeNotifier callback.
+ void _scheduleUpdate() {
+ if (_updating) return;
+ _updating = true;
+ Future.microtask(() async {
+ try {
+ await _updateWidgetData();
+ } catch (e) {
+ debugPrint('[HomeWidget] Update failed: $e');
+ } finally {
+ _updating = false;
+ }
+ });
+ }
+
+ Future<void> _updateWidgetData() async {
+ _lastUpdate = DateTime.now();
+ final player = AudioPlayerService();
+ final hasBook = player.hasBook;
+
+ await HomeWidget.saveWidgetData<bool>('widget_has_book', hasBook);
+
+ if (hasBook) {
+ await HomeWidget.saveWidgetData<String>(
+ 'widget_title', player.currentTitle ?? '');
+ await HomeWidget.saveWidgetData<String>(
+ 'widget_author', player.currentAuthor ?? '');
+ await HomeWidget.saveWidgetData<bool>(
+ 'widget_is_playing', player.isPlaying);
+
+ final totalDur = player.totalDuration;
+ final posSec = player.position.inMilliseconds / 1000.0;
+ int progress = 0;
+ if (totalDur > 0) {
+ progress = ((posSec / totalDur) * 1000).round().clamp(0, 1000);
+ }
+ await HomeWidget.saveWidgetData<int>('widget_progress', progress);
+
+ // Cover art — fire-and-forget so it doesn't block the update.
+ _updateCoverArt(player.currentItemId!);
+
+ if (player.isPlaying) {
+ _startProgressTimer();
+ } else {
+ _stopProgressTimer();
+ }
+ } else {
+ // No active book — just mark as paused but keep the last book's data
+ // so the widget still shows it after app close / force stop.
+ await HomeWidget.saveWidgetData<bool>('widget_is_playing', false);
+ _stopProgressTimer();
+ }
+
+ await HomeWidget.updateWidget(name: _androidWidgetName);
+ }
+
+ Future<void> _updateCoverArt(String itemId) async {
+ if (_lastCoverItemId == itemId) return;
+ _lastCoverItemId = itemId;
+
+ String? coverPath;
+
+ try {
+ // Check for a locally downloaded cover first.
+ final downloadService = DownloadService();
+ if (downloadService.isDownloaded(itemId)) {
+ coverPath = await downloadService.getLocalCoverPath(itemId);
+ }
+
+ // If no local cover, download from server to a temp file.
+ if (coverPath == null) {
+ final player = AudioPlayerService();
+ final coverUrl = player.currentCoverUrl;
+ if (coverUrl != null && coverUrl.isNotEmpty) {
+ final cacheDir = await getTemporaryDirectory();
+ final widgetCoverDir = Directory('${cacheDir.path}/widget_covers');
+ if (!widgetCoverDir.existsSync()) {
+ widgetCoverDir.createSync(recursive: true);
+ }
+ final coverFile = File('${widgetCoverDir.path}/$itemId.jpg');
+
+ final response = await http
+ .get(Uri.parse(coverUrl))
+ .timeout(const Duration(seconds: 10));
+ if (response.statusCode == 200 && response.bodyBytes.isNotEmpty) {
+ await coverFile.writeAsBytes(response.bodyBytes);
+ coverPath = coverFile.path;
+ }
+ }
+ }
+ } catch (e) {
+ debugPrint('[HomeWidget] Cover update failed: $e');
+ }
+
+ try {
+ await HomeWidget.saveWidgetData<String?>('widget_cover_path', coverPath);
+ await HomeWidget.updateWidget(name: _androidWidgetName);
+ } catch (e) {
+ debugPrint('[HomeWidget] Cover save failed: $e');
+ }
+ }
+
+ void _startProgressTimer() {
+ if (_progressTimer?.isActive == true) return;
+ _progressTimer = Timer.periodic(const Duration(seconds: 30), (_) {
+ _scheduleUpdate();
+ });
+ }
+
+ void _stopProgressTimer() {
+ _progressTimer?.cancel();
+ _progressTimer = null;
+ }
+}
diff --git a/pubspec.lock b/pubspec.lock
index 291ea849..3028881a 100644
--- a/pubspec.lock
+++ b/pubspec.lock
@@ -384,6 +384,14 @@ packages:
url: "https://pub.dev"
source: hosted
version: "4.7.3"
+ home_widget:
+ dependency: "direct main"
+ description:
+ name: home_widget
+ sha256: "7430f7549d42cef2e729bd3c779de748b93f1eb78b1abfe6bca8fffd1cfce3e9"
+ url: "https://pub.dev"
+ source: hosted
+ version: "0.7.0+1"
html:
dependency: transitive
description:
diff --git a/pubspec.yaml b/pubspec.yaml
index 65eb902d..9401a659 100644
--- a/pubspec.yaml
+++ b/pubspec.yaml
@@ -68,6 +68,9 @@ dependencies:
# Log sharing
share_plus: ^10.0.0
+ # Homescreen widget
+ home_widget: ^0.7.0
+
dev_dependencies:
flutter_test:
sdk: flutter