Skip to content

A cross platform Audiobookshelf client for Android and iOS

Dart

Add now playing homescreen widgets (4x2 and 4x1 compact)

Nathan Poulson0280a026fba5
diff --git a/android/app/src/main/AndroidManifest.xml b/android/app/src/main/AndroidManifest.xml
index c438c93d..322816f2 100644
--- a/android/app/src/main/AndroidManifest.xml
+++ b/android/app/src/main/AndroidManifest.xml
@@ -96,7 +96,7 @@
android:resource="@xml/file_paths" />
</provider>
- <!-- Now Playing homescreen widget -->
+ <!-- Now Playing homescreen widget (4x2) -->
<receiver
android:name=".NowPlayingWidget"
android:exported="true">
@@ -108,6 +108,18 @@
android:resource="@xml/now_playing_widget_info" />
</receiver>
+ <!-- Now Playing compact widget (4x1) -->
+ <receiver
+ android:name=".NowPlayingWidgetCompact"
+ 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_compact_info" />
+ </receiver>
+
</application>
diff --git a/android/app/src/main/kotlin/com/barnabas/absorb/MainActivity.kt b/android/app/src/main/kotlin/com/barnabas/absorb/MainActivity.kt
index d9d0cc75..ea6b69c5 100644
--- a/android/app/src/main/kotlin/com/barnabas/absorb/MainActivity.kt
+++ b/android/app/src/main/kotlin/com/barnabas/absorb/MainActivity.kt
@@ -25,6 +25,10 @@ class MainActivity : AudioServiceActivity() {
MethodChannel(flutterEngine.dartExecutor.binaryMessenger, CHANNEL)
.setMethodCallHandler { call, result ->
when (call.method) {
+ "moveToBackground" -> {
+ moveTaskToBack(true)
+ result.success(true)
+ }
"init" -> handleInit(result)
"attachSession" -> {
val sessionId = call.argument<Int>("sessionId") ?: 0
diff --git a/android/app/src/main/kotlin/com/barnabas/absorb/NowPlayingWidget.kt b/android/app/src/main/kotlin/com/barnabas/absorb/NowPlayingWidget.kt
index fe2abe5c..a431e1c0 100644
--- a/android/app/src/main/kotlin/com/barnabas/absorb/NowPlayingWidget.kt
+++ b/android/app/src/main/kotlin/com/barnabas/absorb/NowPlayingWidget.kt
@@ -15,7 +15,9 @@ import android.graphics.PorterDuffXfermode
import android.graphics.RectF
import android.view.KeyEvent
import android.view.View
+import android.net.Uri
import android.widget.RemoteViews
+import es.antonborri.home_widget.HomeWidgetLaunchIntent
import es.antonborri.home_widget.HomeWidgetPlugin
import java.io.File
@@ -31,7 +33,36 @@ class NowPlayingWidget : AppWidgetProvider() {
}
}
+ override fun onReceive(context: Context, intent: Intent) {
+ if (intent.action == ACTION_TOGGLE_PLAYBACK) {
+ // Optimistic UI: flip the icon immediately, then send the real media button.
+ val widgetData = HomeWidgetPlugin.getData(context)
+ val wasPlaying = widgetData.getBoolean("widget_is_playing", false)
+ widgetData.edit().putBoolean("widget_is_playing", !wasPlaying).apply()
+
+ // Re-render both widget types so they stay in sync.
+ val mgr = AppWidgetManager.getInstance(context)
+ for (id in mgr.getAppWidgetIds(ComponentName(context, NowPlayingWidget::class.java))) {
+ updateWidget(context, mgr, id)
+ }
+ for (id in mgr.getAppWidgetIds(ComponentName(context, NowPlayingWidgetCompact::class.java))) {
+ NowPlayingWidgetCompact.updateWidget(context, mgr, id)
+ }
+
+ // Forward to MediaButtonReceiver for the actual playback toggle.
+ val mediaIntent = Intent(Intent.ACTION_MEDIA_BUTTON).apply {
+ component = ComponentName(context, "com.ryanheise.audioservice.MediaButtonReceiver")
+ putExtra(Intent.EXTRA_KEY_EVENT, KeyEvent(KeyEvent.ACTION_DOWN, KeyEvent.KEYCODE_MEDIA_PLAY_PAUSE))
+ }
+ context.sendBroadcast(mediaIntent)
+ return
+ }
+ super.onReceive(context, intent)
+ }
+
companion object {
+ const val ACTION_TOGGLE_PLAYBACK = "com.barnabas.absorb.ACTION_TOGGLE_PLAYBACK"
+
private fun roundBitmap(bitmap: Bitmap, radiusDp: Float, context: Context): Bitmap {
val density = context.resources.displayMetrics.density
val radiusPx = radiusDp * density
@@ -45,28 +76,6 @@ class NowPlayingWidget : AppWidgetProvider() {
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,
@@ -88,7 +97,7 @@ class NowPlayingWidget : AppWidgetProvider() {
)
}
- private fun updateWidget(
+ fun updateWidget(
context: Context,
appWidgetManager: AppWidgetManager,
appWidgetId: Int
@@ -96,26 +105,39 @@ class NowPlayingWidget : AppWidgetProvider() {
val widgetData = HomeWidgetPlugin.getData(context)
val views = RemoteViews(context.packageName, R.layout.now_playing_widget)
+ val hasBook = widgetData.getBoolean("widget_has_book", false)
val title = widgetData.getString("widget_title", null)
val author = widgetData.getString("widget_author", null)
+ val chapter = widgetData.getString("widget_chapter", null)
val isPlaying = widgetData.getBoolean("widget_is_playing", false)
val progress = widgetData.getInt("widget_progress", 0)
val coverPath = widgetData.getString("widget_cover_path", null)
+ val skipBack = widgetData.getInt("widget_skip_back", 10)
+ val skipForward = widgetData.getInt("widget_skip_forward", 30)
+
+ views.setTextViewText(R.id.widget_skip_back_text, skipBack.toString())
+ views.setTextViewText(R.id.widget_skip_forward_text, skipForward.toString())
if (!title.isNullOrEmpty()) {
views.setTextViewText(R.id.widget_title, title)
views.setTextViewText(R.id.widget_author, author ?: "")
+ if (!chapter.isNullOrEmpty()) {
+ views.setTextViewText(R.id.widget_chapter, chapter)
+ views.setViewVisibility(R.id.widget_chapter, View.VISIBLE)
+ } else {
+ views.setViewVisibility(R.id.widget_chapter, View.GONE)
+ }
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)
+ views.setImageViewResource(R.id.widget_play_pause, R.drawable.ic_widget_pause_dark)
} else {
- views.setImageViewResource(R.id.widget_play_pause, R.drawable.ic_widget_play)
+ views.setImageViewResource(R.id.widget_play_pause, R.drawable.ic_widget_play_dark)
}
- // Cover art from file (rounded corners + blurred background)
+ // Cover art from file (rounded corners)
if (coverPath != null) {
val file = File(coverPath)
if (file.exists()) {
@@ -123,19 +145,14 @@ class NowPlayingWidget : AppWidgetProvider() {
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
@@ -144,8 +161,8 @@ class NowPlayingWidget : AppWidgetProvider() {
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.setViewVisibility(R.id.widget_chapter, 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
@@ -164,10 +181,24 @@ class NowPlayingWidget : AppWidgetProvider() {
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)
- )
+ // Active session: custom broadcast flips the icon instantly then forwards
+ // to MediaSession. No session: launch the app for cold resume.
+ val playPauseIntent = if (hasBook) {
+ val toggleIntent = Intent(context, NowPlayingWidget::class.java).apply {
+ action = ACTION_TOGGLE_PLAYBACK
+ }
+ PendingIntent.getBroadcast(
+ context, 1, toggleIntent,
+ PendingIntent.FLAG_IMMUTABLE or PendingIntent.FLAG_UPDATE_CURRENT
+ )
+ } else {
+ HomeWidgetLaunchIntent.getActivity(
+ context,
+ MainActivity::class.java,
+ Uri.parse("absorb://widget/play_pause")
+ )
+ }
+ views.setOnClickPendingIntent(R.id.widget_play_pause, playPauseIntent)
views.setOnClickPendingIntent(
R.id.widget_skip_forward,
mediaButtonPendingIntent(context, KeyEvent.KEYCODE_MEDIA_FAST_FORWARD, 3)
diff --git a/android/app/src/main/kotlin/com/barnabas/absorb/NowPlayingWidgetCompact.kt b/android/app/src/main/kotlin/com/barnabas/absorb/NowPlayingWidgetCompact.kt
new file mode 100644
index 00000000..cb188221
--- /dev/null
+++ b/android/app/src/main/kotlin/com/barnabas/absorb/NowPlayingWidgetCompact.kt
@@ -0,0 +1,191 @@
+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.net.Uri
+import android.widget.RemoteViews
+import es.antonborri.home_widget.HomeWidgetLaunchIntent
+import es.antonborri.home_widget.HomeWidgetPlugin
+import java.io.File
+
+class NowPlayingWidgetCompact : AppWidgetProvider() {
+
+ override fun onUpdate(
+ context: Context,
+ appWidgetManager: AppWidgetManager,
+ appWidgetIds: IntArray
+ ) {
+ for (appWidgetId in appWidgetIds) {
+ updateWidget(context, appWidgetManager, appWidgetId)
+ }
+ }
+
+ override fun onReceive(context: Context, intent: Intent) {
+ if (intent.action == ACTION_TOGGLE_PLAYBACK) {
+ val widgetData = HomeWidgetPlugin.getData(context)
+ val wasPlaying = widgetData.getBoolean("widget_is_playing", false)
+ widgetData.edit().putBoolean("widget_is_playing", !wasPlaying).apply()
+
+ val mgr = AppWidgetManager.getInstance(context)
+ for (id in mgr.getAppWidgetIds(ComponentName(context, NowPlayingWidgetCompact::class.java))) {
+ updateWidget(context, mgr, id)
+ }
+ for (id in mgr.getAppWidgetIds(ComponentName(context, NowPlayingWidget::class.java))) {
+ NowPlayingWidget.updateWidget(context, mgr, id)
+ }
+
+ val mediaIntent = Intent(Intent.ACTION_MEDIA_BUTTON).apply {
+ component = ComponentName(context, "com.ryanheise.audioservice.MediaButtonReceiver")
+ putExtra(Intent.EXTRA_KEY_EVENT, KeyEvent(KeyEvent.ACTION_DOWN, KeyEvent.KEYCODE_MEDIA_PLAY_PAUSE))
+ }
+ context.sendBroadcast(mediaIntent)
+ return
+ }
+ super.onReceive(context, intent)
+ }
+
+ companion object {
+ const val ACTION_TOGGLE_PLAYBACK = "com.barnabas.absorb.ACTION_TOGGLE_PLAYBACK_COMPACT"
+
+ 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 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 + 10, intent,
+ PendingIntent.FLAG_IMMUTABLE or PendingIntent.FLAG_UPDATE_CURRENT
+ )
+ }
+
+ fun updateWidget(
+ context: Context,
+ appWidgetManager: AppWidgetManager,
+ appWidgetId: Int
+ ) {
+ val widgetData = HomeWidgetPlugin.getData(context)
+ val views = RemoteViews(context.packageName, R.layout.now_playing_widget_compact)
+
+ val hasBook = widgetData.getBoolean("widget_has_book", false)
+ val title = widgetData.getString("widget_title", null)
+ val author = widgetData.getString("widget_author", null)
+ val isPlaying = widgetData.getBoolean("widget_is_playing", false)
+ val coverPath = widgetData.getString("widget_cover_path", null)
+ val skipBack = widgetData.getInt("widget_skip_back", 10)
+ val skipForward = widgetData.getInt("widget_skip_forward", 30)
+
+ views.setTextViewText(R.id.widget_skip_back_text, skipBack.toString())
+ views.setTextViewText(R.id.widget_skip_forward_text, skipForward.toString())
+
+ if (!title.isNullOrEmpty()) {
+ views.setTextViewText(R.id.widget_title, title)
+ views.setTextViewText(R.id.widget_author, author ?: "")
+ views.setViewVisibility(R.id.widget_controls, View.VISIBLE)
+
+ if (isPlaying) {
+ views.setImageViewResource(R.id.widget_play_pause, R.drawable.ic_widget_pause_dark)
+ } else {
+ views.setImageViewResource(R.id.widget_play_pause, R.drawable.ic_widget_play_dark)
+ }
+
+ // Cover art from file (rounded corners)
+ 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, 12f, context))
+ } else {
+ views.setImageViewResource(R.id.widget_cover, R.mipmap.ic_launcher)
+ }
+ } else {
+ views.setImageViewResource(R.id.widget_cover, R.mipmap.ic_launcher)
+ }
+ } else {
+ views.setImageViewResource(R.id.widget_cover, R.mipmap.ic_launcher)
+ }
+ } else {
+ // Idle state
+ views.setTextViewText(R.id.widget_title, "Absorb")
+ views.setTextViewText(R.id.widget_author, "Not playing")
+ views.setViewVisibility(R.id.widget_controls, View.GONE)
+ views.setImageViewResource(R.id.widget_cover, R.mipmap.ic_launcher)
+ }
+
+ // 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, 5, launchIntent,
+ PendingIntent.FLAG_IMMUTABLE or PendingIntent.FLAG_UPDATE_CURRENT
+ )
+ views.setOnClickPendingIntent(R.id.widget_root, pendingIntent)
+ }
+
+ // Playback controls
+ views.setOnClickPendingIntent(
+ R.id.widget_skip_back,
+ mediaButtonPendingIntent(context, KeyEvent.KEYCODE_MEDIA_REWIND, 12)
+ )
+ val playPauseIntent = if (hasBook) {
+ val toggleIntent = Intent(context, NowPlayingWidgetCompact::class.java).apply {
+ action = ACTION_TOGGLE_PLAYBACK
+ }
+ PendingIntent.getBroadcast(
+ context, 11, toggleIntent,
+ PendingIntent.FLAG_IMMUTABLE or PendingIntent.FLAG_UPDATE_CURRENT
+ )
+ } else {
+ HomeWidgetLaunchIntent.getActivity(
+ context,
+ MainActivity::class.java,
+ Uri.parse("absorb://widget/play_pause")
+ )
+ }
+ views.setOnClickPendingIntent(R.id.widget_play_pause, playPauseIntent)
+ views.setOnClickPendingIntent(
+ R.id.widget_skip_forward,
+ mediaButtonPendingIntent(context, KeyEvent.KEYCODE_MEDIA_FAST_FORWARD, 13)
+ )
+ appWidgetManager.updateAppWidget(appWidgetId, views)
+ }
+ }
+}
diff --git a/android/app/src/main/res/drawable/widget_background.xml b/android/app/src/main/res/drawable/widget_background.xml
index a651d6da..f7b24659 100644
--- a/android/app/src/main/res/drawable/widget_background.xml
+++ b/android/app/src/main/res/drawable/widget_background.xml
@@ -1,6 +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" />
+ <solid android:color="#CC000000" />
<corners android:radius="24dp" />
</shape>
diff --git a/android/app/src/main/res/drawable/widget_play_btn_bg.xml b/android/app/src/main/res/drawable/widget_play_btn_bg.xml
new file mode 100644
index 00000000..9f3c01df
--- /dev/null
+++ b/android/app/src/main/res/drawable/widget_play_btn_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/layout/now_playing_widget.xml b/android/app/src/main/res/layout/now_playing_widget.xml
index bcad3d0b..fdfc51ac 100644
--- a/android/app/src/main/res/layout/now_playing_widget.xml
+++ b/android/app/src/main/res/layout/now_playing_widget.xml
@@ -16,19 +16,11 @@
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_width="130dp"
+ android:layout_height="130dp"
android:layout_alignParentStart="true"
android:layout_centerVertical="true"
android:layout_marginStart="6dp"
@@ -45,14 +37,45 @@
android:layout_alignTop="@id/widget_cover"
android:paddingStart="12dp"
android:paddingEnd="12dp"
+ android:paddingTop="4dp"
android:text="Absorb"
android:textColor="#FFFFFF"
- android:textSize="16sp"
+ android:textSize="15sp"
android:textStyle="bold"
android:maxLines="1"
android:ellipsize="end"
android:fontFamily="sans-serif-medium" />
+ <!-- Author below title -->
+ <TextView
+ android:id="@+id/widget_author"
+ android:layout_width="match_parent"
+ android:layout_height="wrap_content"
+ android:layout_toEndOf="@id/widget_cover"
+ android:layout_below="@id/widget_title"
+ android:paddingStart="12dp"
+ android:paddingEnd="12dp"
+ android:text="Not playing"
+ android:textColor="#99FFFFFF"
+ android:textSize="12sp"
+ android:maxLines="1"
+ android:ellipsize="end" />
+
+ <!-- Chapter title below author -->
+ <TextView
+ android:id="@+id/widget_chapter"
+ android:layout_width="match_parent"
+ android:layout_height="wrap_content"
+ android:layout_toEndOf="@id/widget_cover"
+ android:layout_below="@id/widget_author"
+ android:paddingStart="12dp"
+ android:paddingEnd="12dp"
+ android:textColor="#77FFFFFF"
+ android:textSize="11sp"
+ android:maxLines="1"
+ android:ellipsize="end"
+ android:visibility="gone" />
+
<!-- Controls aligned with bottom of cover -->
<LinearLayout
android:id="@+id/widget_controls"
@@ -66,70 +89,96 @@
android:paddingEnd="4dp"
android:visibility="gone">
- <ImageButton
+ <!-- Skip back: arrow icon with duration overlay -->
+ <FrameLayout
android:id="@+id/widget_skip_back"
android:layout_width="0dp"
- android:layout_height="34dp"
+ android:layout_height="40dp"
android:layout_weight="1"
- android:src="@drawable/ic_widget_skip_back"
android:background="@android:color/transparent"
- android:contentDescription="Skip backward"
- android:scaleType="centerInside" />
+ android:contentDescription="Skip backward">
+ <ImageView
+ android:layout_width="32dp"
+ android:layout_height="32dp"
+ android:layout_gravity="center"
+ android:src="@drawable/ic_widget_skip_back"
+ android:scaleType="centerInside" />
+ <TextView
+ android:id="@+id/widget_skip_back_text"
+ android:layout_width="wrap_content"
+ android:layout_height="wrap_content"
+ android:layout_gravity="center"
+ android:layout_marginTop="2dp"
+ android:text="10"
+ android:textColor="#FFFFFF"
+ android:textSize="8sp"
+ android:textStyle="bold"
+ android:fontFamily="sans-serif-medium" />
+ </FrameLayout>
+ <!-- Play/pause: white circle with dark icon -->
<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:layout_width="40dp"
+ android:layout_height="40dp"
+ android:padding="8dp"
+ android:src="@drawable/ic_widget_play_dark"
+ android:background="@drawable/widget_play_btn_bg"
android:contentDescription="Play or pause"
android:scaleType="centerInside" />
- <ImageButton
+ <!-- Skip forward: arrow icon with duration overlay -->
+ <FrameLayout
android:id="@+id/widget_skip_forward"
android:layout_width="0dp"
- android:layout_height="34dp"
+ android:layout_height="40dp"
android:layout_weight="1"
- android:src="@drawable/ic_widget_skip_forward"
android:background="@android:color/transparent"
- android:contentDescription="Skip forward"
- android:scaleType="centerInside" />
+ android:contentDescription="Skip forward">
+ <ImageView
+ android:layout_width="32dp"
+ android:layout_height="32dp"
+ android:layout_gravity="center"
+ android:src="@drawable/ic_widget_skip_forward"
+ android:scaleType="centerInside" />
+ <TextView
+ android:id="@+id/widget_skip_forward_text"
+ android:layout_width="wrap_content"
+ android:layout_height="wrap_content"
+ android:layout_gravity="center"
+ android:layout_marginTop="2dp"
+ android:text="30"
+ android:textColor="#FFFFFF"
+ android:textSize="8sp"
+ android:textStyle="bold"
+ android:fontFamily="sans-serif-medium" />
+ </FrameLayout>
</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"
+ <!-- Wrapper fills the gap; ProgressBar is centered inside at 2dp thin -->
+ <FrameLayout
+ android:id="@+id/widget_progress_wrapper"
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" />
+ android:layout_below="@id/widget_chapter"
+ android:layout_above="@id/widget_controls">
+
+ <ProgressBar
+ android:id="@+id/widget_progress"
+ style="@android:style/Widget.ProgressBar.Horizontal"
+ android:layout_width="match_parent"
+ android:layout_height="2dp"
+ android:layout_gravity="center"
+ android:layout_marginStart="12dp"
+ android:layout_marginEnd="12dp"
+ android:max="1000"
+ android:progress="0"
+ android:progressDrawable="@drawable/widget_progress_bar"
+ android:visibility="invisible" />
+
+ </FrameLayout>
</RelativeLayout>
diff --git a/android/app/src/main/res/layout/now_playing_widget_compact.xml b/android/app/src/main/res/layout/now_playing_widget_compact.xml
new file mode 100644
index 00000000..26e2c8b2
--- /dev/null
+++ b/android/app/src/main/res/layout/now_playing_widget_compact.xml
@@ -0,0 +1,157 @@
+<?xml version="1.0" encoding="utf-8"?>
+<!-- Compact 4x1 now-playing widget -->
+<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="5dp"
+ android:paddingBottom="5dp">
+
+ <!-- The card -->
+ <LinearLayout
+ android:id="@+id/widget_root"
+ android:layout_width="match_parent"
+ android:layout_height="match_parent"
+ android:background="@drawable/widget_background"
+ android:clipToOutline="true"
+ android:orientation="horizontal">
+
+ <!-- Cover art: full height of card, square -->
+ <ImageView
+ android:id="@+id/widget_cover"
+ android:layout_width="wrap_content"
+ android:layout_height="match_parent"
+ android:adjustViewBounds="true"
+ android:scaleType="centerCrop"
+ android:src="@mipmap/ic_launcher"
+ android:contentDescription="Cover art" />
+
+ <!-- Right side: title/author on top, controls centered below -->
+ <LinearLayout
+ android:layout_width="0dp"
+ android:layout_height="match_parent"
+ android:layout_weight="1"
+ android:orientation="vertical"
+ android:paddingTop="4dp"
+ android:paddingBottom="4dp">
+
+ <!-- Title -->
+ <TextView
+ android:id="@+id/widget_title"
+ android:layout_width="match_parent"
+ android:layout_height="wrap_content"
+ android:paddingStart="10dp"
+ android:paddingEnd="10dp"
+ android:text="Absorb"
+ android:textColor="#FFFFFF"
+ android:textSize="13sp"
+ android:textStyle="bold"
+ android:maxLines="1"
+ android:ellipsize="end"
+ android:fontFamily="sans-serif-medium" />
+
+ <!-- Author -->
+ <TextView
+ android:id="@+id/widget_author"
+ android:layout_width="match_parent"
+ android:layout_height="wrap_content"
+ android:paddingStart="10dp"
+ android:paddingEnd="10dp"
+ android:text="Not playing"
+ android:textColor="#99FFFFFF"
+ android:textSize="11sp"
+ android:maxLines="1"
+ android:ellipsize="end" />
+
+ <!-- Equal spacers above and below controls to center them -->
+ <FrameLayout
+ android:layout_width="match_parent"
+ android:layout_height="0dp"
+ android:layout_weight="1" />
+
+ <!-- Controls spread across full width -->
+ <LinearLayout
+ android:id="@+id/widget_controls"
+ android:layout_width="match_parent"
+ android:layout_height="wrap_content"
+ android:orientation="horizontal"
+ android:gravity="center_vertical"
+ android:paddingStart="4dp"
+ android:paddingEnd="4dp"
+ android:visibility="gone">
+
+ <FrameLayout
+ android:id="@+id/widget_skip_back"
+ android:layout_width="0dp"
+ android:layout_height="40dp"
+ android:layout_weight="1"
+ android:background="@android:color/transparent"
+ android:contentDescription="Skip backward">
+ <ImageView
+ android:layout_width="32dp"
+ android:layout_height="32dp"
+ android:layout_gravity="center"
+ android:src="@drawable/ic_widget_skip_back"
+ android:scaleType="centerInside" />
+ <TextView
+ android:id="@+id/widget_skip_back_text"
+ android:layout_width="wrap_content"
+ android:layout_height="wrap_content"
+ android:layout_gravity="center"
+ android:layout_marginTop="2dp"
+ android:text="10"
+ android:textColor="#FFFFFF"
+ android:textSize="8sp"
+ android:textStyle="bold"
+ android:fontFamily="sans-serif-medium" />
+ </FrameLayout>
+
+ <ImageButton
+ android:id="@+id/widget_play_pause"
+ android:layout_width="40dp"
+ android:layout_height="40dp"
+ android:padding="8dp"
+ android:src="@drawable/ic_widget_play_dark"
+ android:background="@drawable/widget_play_btn_bg"
+ android:contentDescription="Play or pause"
+ android:scaleType="centerInside" />
+
+ <FrameLayout
+ android:id="@+id/widget_skip_forward"
+ android:layout_width="0dp"
+ android:layout_height="40dp"
+ android:layout_weight="1"
+ android:background="@android:color/transparent"
+ android:contentDescription="Skip forward">
+ <ImageView
+ android:layout_width="32dp"
+ android:layout_height="32dp"
+ android:layout_gravity="center"
+ android:src="@drawable/ic_widget_skip_forward"
+ android:scaleType="centerInside" />
+ <TextView
+ android:id="@+id/widget_skip_forward_text"
+ android:layout_width="wrap_content"
+ android:layout_height="wrap_content"
+ android:layout_gravity="center"
+ android:layout_marginTop="2dp"
+ android:text="30"
+ android:textColor="#FFFFFF"
+ android:textSize="8sp"
+ android:textStyle="bold"
+ android:fontFamily="sans-serif-medium" />
+ </FrameLayout>
+
+ </LinearLayout>
+
+ <FrameLayout
+ android:layout_width="match_parent"
+ android:layout_height="0dp"
+ android:layout_weight="1" />
+
+ </LinearLayout>
+
+ </LinearLayout>
+
+</FrameLayout>
diff --git a/android/app/src/main/res/values/strings.xml b/android/app/src/main/res/values/strings.xml
index 1277ad00..7dd45a29 100644
--- a/android/app/src/main/res/values/strings.xml
+++ b/android/app/src/main/res/values/strings.xml
@@ -1,4 +1,5 @@
<?xml version="1.0" encoding="utf-8"?>
<resources>
<string name="widget_description">Shows the currently playing audiobook with playback controls.</string>
+ <string name="widget_compact_description">Compact now-playing bar with playback controls.</string>
</resources>
diff --git a/android/app/src/main/res/xml/now_playing_widget_compact_info.xml b/android/app/src/main/res/xml/now_playing_widget_compact_info.xml
new file mode 100644
index 00000000..de96a286
--- /dev/null
+++ b/android/app/src/main/res/xml/now_playing_widget_compact_info.xml
@@ -0,0 +1,11 @@
+<?xml version="1.0" encoding="utf-8"?>
+<appwidget-provider xmlns:android="http://schemas.android.com/apk/res/android"
+ android:initialLayout="@layout/now_playing_widget_compact"
+ android:minWidth="250dp"
+ android:minHeight="40dp"
+ android:minResizeWidth="180dp"
+ android:resizeMode="horizontal"
+ android:widgetCategory="home_screen"
+ android:previewImage="@mipmap/ic_launcher"
+ android:description="@string/widget_compact_description"
+ android:updatePeriodMillis="0" />
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
index 7f87b560..ede96d28 100644
--- a/android/app/src/main/res/xml/now_playing_widget_info.xml
+++ b/android/app/src/main/res/xml/now_playing_widget_info.xml
@@ -3,9 +3,9 @@
android:initialLayout="@layout/now_playing_widget"
android:minWidth="250dp"
android:minHeight="110dp"
- android:minResizeWidth="180dp"
- android:minResizeHeight="110dp"
- android:resizeMode="horizontal|vertical"
+ android:targetCellWidth="4"
+ android:targetCellHeight="2"
+ android:resizeMode="horizontal"
android:widgetCategory="home_screen"
android:previewImage="@mipmap/ic_launcher"
android:description="@string/widget_description"
diff --git a/lib/services/home_widget_service.dart b/lib/services/home_widget_service.dart
index 08c9f202..1b83e219 100644
--- a/lib/services/home_widget_service.dart
+++ b/lib/services/home_widget_service.dart
@@ -1,15 +1,19 @@
import 'dart:async';
+import 'dart:convert';
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 'package:shared_preferences/shared_preferences.dart';
import 'audio_player_service.dart';
+import 'api_service.dart';
import 'download_service.dart';
const String _androidWidgetName = 'NowPlayingWidget';
+const String _androidWidgetCompactName = 'NowPlayingWidgetCompact';
class HomeWidgetService {
static final HomeWidgetService _instance = HomeWidgetService._();
@@ -22,6 +26,7 @@ class HomeWidgetService {
DateTime? _lastUpdate;
bool _initialized = false;
bool _updating = false;
+ StreamSubscription? _clickSub;
/// Call after AudioPlayerService is initialized to start pushing state.
Future<void> init() async {
@@ -31,6 +36,15 @@ class HomeWidgetService {
final player = AudioPlayerService();
player.addListener(_onPlayerChanged);
+ // Listen for widget click actions (e.g. play/pause button)
+ _clickSub = HomeWidget.widgetClicked.listen(_onWidgetClicked);
+
+ // Check if the app was cold-started from a widget tap
+ final launchUri = await HomeWidget.initiallyLaunchedFromHomeWidget();
+ if (launchUri != null) {
+ _onWidgetClicked(launchUri);
+ }
+
// Push current state in case a widget already exists.
_scheduleUpdate();
}
@@ -38,9 +52,108 @@ class HomeWidgetService {
void dispose() {
_progressTimer?.cancel();
_pendingUpdate?.cancel();
+ _clickSub?.cancel();
AudioPlayerService().removeListener(_onPlayerChanged);
}
+ void _onWidgetClicked(Uri? uri) {
+ debugPrint('[HomeWidget] widgetClicked: $uri');
+ if (uri == null) return;
+ if (uri.host == 'widget' && uri.path == '/play_pause') {
+ _handlePlayPause();
+ }
+ }
+
+ Future<void> _handlePlayPause() async {
+ final player = AudioPlayerService();
+
+ // When there's an active session the widget uses a MediaSession media button
+ // instead of launching the app, so this path is only hit for cold resume.
+ if (player.hasBook) return;
+
+ // No active session — cold resume (app stays open for initial setup)
+ final prefs = await SharedPreferences.getInstance();
+ final itemId = prefs.getString('widget_item_id');
+ debugPrint('[HomeWidget] play_pause: cold resume, itemId=$itemId');
+ if (itemId == null) return;
+
+ final serverUrl = prefs.getString('server_url');
+ final token = prefs.getString('token');
+ debugPrint('[HomeWidget] play_pause: server=${serverUrl != null}, token=${token != null}');
+ if (serverUrl == null || token == null) return;
+
+ Map<String, String>? customHeaders;
+ final headersJson = prefs.getString('custom_headers');
+ if (headersJson != null) {
+ try {
+ customHeaders =
+ Map<String, String>.from(jsonDecode(headersJson) as Map);
+ } catch (_) {}
+ }
+
+ final api = ApiService(
+ baseUrl: serverUrl,
+ token: token,
+ customHeaders: customHeaders ?? const {},
+ );
+
+ final episodeId = prefs.getString('widget_episode_id');
+
+ try {
+ debugPrint('[HomeWidget] play_pause: fetching item $itemId (episode=$episodeId)');
+ final fullItem = await api.getLibraryItem(itemId);
+ if (fullItem == null) {
+ debugPrint('[HomeWidget] play_pause: getLibraryItem returned null');
+ return;
+ }
+
+ final media = fullItem['media'] as Map<String, dynamic>? ?? {};
+ final metadata = media['metadata'] as Map<String, dynamic>? ?? {};
+ final title = metadata['title'] as String? ?? '';
+ final author = metadata['authorName'] as String? ?? '';
+ final coverUrl = api.getCoverUrl(itemId);
+ final duration = (media['duration'] is num)
+ ? (media['duration'] as num).toDouble()
+ : 0.0;
+ final chapters = (media['chapters'] as List<dynamic>?) ?? [];
+
+ if (episodeId != null) {
+ final episodes = (media['episodes'] as List<dynamic>?) ?? [];
+ final episode = episodes.cast<Map<String, dynamic>>().firstWhere(
+ (e) => e['id'] == episodeId,
+ orElse: () => <String, dynamic>{},
+ );
+ final epTitle = episode['title'] as String? ?? title;
+ final epDuration =
+ (episode['duration'] as num?)?.toDouble() ?? duration;
+
+ await player.playItem(
+ api: api,
+ itemId: itemId,
+ title: epTitle,
+ author: title,
+ coverUrl: coverUrl,
+ totalDuration: epDuration,
+ chapters: [],
+ episodeId: episodeId,
+ episodeTitle: epTitle,
+ );
+ } else {
+ await player.playItem(
+ api: api,
+ itemId: itemId,
+ title: title,
+ author: author,
+ coverUrl: coverUrl,
+ totalDuration: duration,
+ chapters: chapters,
+ );
+ }
+ } catch (e) {
+ debugPrint('[HomeWidget] Resume playback failed: $e');
+ }
+ }
+
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.
@@ -77,11 +190,20 @@ class HomeWidgetService {
await HomeWidget.saveWidgetData<bool>('widget_has_book', hasBook);
+ // Push user's skip durations so the widget shows them on the buttons.
+ final skipBack = await PlayerSettings.getBackSkip();
+ final skipForward = await PlayerSettings.getForwardSkip();
+ await HomeWidget.saveWidgetData<int>('widget_skip_back', skipBack);
+ await HomeWidget.saveWidgetData<int>('widget_skip_forward', skipForward);
+
if (hasBook) {
await HomeWidget.saveWidgetData<String>(
'widget_title', player.currentTitle ?? '');
await HomeWidget.saveWidgetData<String>(
'widget_author', player.currentAuthor ?? '');
+ final chapter = player.currentChapter;
+ final chapterTitle = chapter?['title'] as String? ?? '';
+ await HomeWidget.saveWidgetData<String>('widget_chapter', chapterTitle);
await HomeWidget.saveWidgetData<bool>(
'widget_is_playing', player.isPlaying);
@@ -93,6 +215,15 @@ class HomeWidgetService {
}
await HomeWidget.saveWidgetData<int>('widget_progress', progress);
+ // Persist item/episode ID so the widget can resume after app kill
+ final prefs = await SharedPreferences.getInstance();
+ await prefs.setString('widget_item_id', player.currentItemId!);
+ if (player.currentEpisodeId != null) {
+ await prefs.setString('widget_episode_id', player.currentEpisodeId!);
+ } else {
+ await prefs.remove('widget_episode_id');
+ }
+
// Cover art — fire-and-forget so it doesn't block the update.
_updateCoverArt(player.currentItemId!);
@@ -109,6 +240,7 @@ class HomeWidgetService {
}
await HomeWidget.updateWidget(name: _androidWidgetName);
+ await HomeWidget.updateWidget(name: _androidWidgetCompactName);
}
Future<void> _updateCoverArt(String itemId) async {
@@ -152,6 +284,7 @@ class HomeWidgetService {
try {
await HomeWidget.saveWidgetData<String?>('widget_cover_path', coverPath);
await HomeWidget.updateWidget(name: _androidWidgetName);
+ await HomeWidget.updateWidget(name: _androidWidgetCompactName);
} catch (e) {
debugPrint('[HomeWidget] Cover save failed: $e');
}