Skip to content

A cross platform Audiobookshelf client for Android and iOS

Dart

Add a 1x1 cover widget that toggles play/pause

Barnabas234daf7ba23d
diff --git a/android/app/src/main/AndroidManifest.xml b/android/app/src/main/AndroidManifest.xml
index c429dcb8..4b7cb8c5 100644
--- a/android/app/src/main/AndroidManifest.xml
+++ b/android/app/src/main/AndroidManifest.xml
@@ -143,6 +143,18 @@
android:resource="@xml/now_playing_widget_compact_info" />
</receiver>
+ <!-- Now Playing tiny cover widget (1x1) -->
+ <receiver
+ android:name=".NowPlayingWidgetTiny"
+ 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_tiny_info" />
+ </receiver>
+
<!-- Listening stats homescreen widget (4x2) -->
<receiver
android:name=".StatsWidget"
diff --git a/android/app/src/main/kotlin/com/barnabas/absorb/NowPlayingWidgetTiny.kt b/android/app/src/main/kotlin/com/barnabas/absorb/NowPlayingWidgetTiny.kt
new file mode 100644
index 00000000..eb91df0c
--- /dev/null
+++ b/android/app/src/main/kotlin/com/barnabas/absorb/NowPlayingWidgetTiny.kt
@@ -0,0 +1,147 @@
+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
+
+// 1x1 widget: just the cover art. Tapping anywhere toggles play/pause.
+class NowPlayingWidgetTiny : AppWidgetProvider() {
+
+ override fun onUpdate(
+ context: Context,
+ appWidgetManager: AppWidgetManager,
+ appWidgetIds: IntArray
+ ) {
+ for (appWidgetId in appWidgetIds) {
+ // Never let a widget render failure crash the whole app.
+ try {
+ updateWidget(context, appWidgetManager, appWidgetId)
+ } catch (e: Exception) {
+ android.util.Log.e("NowPlayingWidgetTiny", "updateWidget failed", e)
+ }
+ }
+ }
+
+ 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()
+
+ val mgr = AppWidgetManager.getInstance(context)
+ for (id in mgr.getAppWidgetIds(ComponentName(context, NowPlayingWidgetTiny::class.java))) {
+ 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_TINY"
+
+ private fun roundBitmap(bitmap: Bitmap, radiusDp: Float, context: Context): Bitmap {
+ val density = context.resources.displayMetrics.density
+ // ~80dp target tile; scale the radius to the source bitmap so corners
+ // look right after centerCrop.
+ val displayPx = 80f * density
+ val scale = minOf(bitmap.width, bitmap.height).toFloat() / displayPx
+ val radiusPx = radiusDp * density * scale
+ 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
+ }
+
+ fun updateWidget(
+ context: Context,
+ appWidgetManager: AppWidgetManager,
+ appWidgetId: Int
+ ) {
+ val widgetData = HomeWidgetPlugin.getData(context)
+ val views = RemoteViews(context.packageName, R.layout.now_playing_widget_tiny)
+
+ val hasBook = widgetData.getBoolean("widget_has_book", false)
+ val isPlaying = widgetData.getBoolean("widget_is_playing", false)
+ val coverPath = widgetData.getString("widget_cover_path", null)
+
+ // Cover art (rounded corners)
+ var setCover = false
+ 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) {
+ val rounded = roundBitmap(bitmap, 16f, context)
+ views.setImageViewBitmap(R.id.widget_cover, rounded)
+ // Recycle only the source: RemoteViews serialises `rounded`
+ // later in updateAppWidget, so recycling it here crashes the app.
+ bitmap.recycle()
+ setCover = true
+ }
+ }
+ }
+ if (!setCover) views.setImageViewResource(R.id.widget_cover, R.mipmap.ic_launcher)
+
+ // Play/pause indicator - only when there's a session to control.
+ if (hasBook) {
+ views.setViewVisibility(R.id.widget_play_pause, View.VISIBLE)
+ views.setImageViewResource(
+ R.id.widget_play_pause,
+ if (isPlaying) R.drawable.ic_widget_pause_dark else R.drawable.ic_widget_play_dark
+ )
+ } else {
+ views.setViewVisibility(R.id.widget_play_pause, View.GONE)
+ }
+
+ // Tap anywhere on the tile: toggle if there's a session, else open the app.
+ val tapIntent = if (hasBook) {
+ val toggleIntent = Intent(context, NowPlayingWidgetTiny::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_root, tapIntent)
+
+ appWidgetManager.updateAppWidget(appWidgetId, views)
+ }
+ }
+}
diff --git a/android/app/src/main/res/layout/now_playing_widget_tiny.xml b/android/app/src/main/res/layout/now_playing_widget_tiny.xml
new file mode 100644
index 00000000..9159fd46
--- /dev/null
+++ b/android/app/src/main/res/layout/now_playing_widget_tiny.xml
@@ -0,0 +1,30 @@
+<?xml version="1.0" encoding="utf-8"?>
+<!-- Tiny 1x1 now-playing widget: cover art, tap anywhere toggles play/pause -->
+<FrameLayout xmlns:android="http://schemas.android.com/apk/res/android"
+ android:id="@+id/widget_root"
+ android:layout_width="match_parent"
+ android:layout_height="match_parent"
+ android:background="@drawable/widget_background"
+ android:clipToOutline="true">
+
+ <ImageView
+ android:id="@+id/widget_cover"
+ android:layout_width="match_parent"
+ android:layout_height="match_parent"
+ android:scaleType="centerCrop"
+ android:src="@mipmap/ic_launcher"
+ android:contentDescription="Cover art" />
+
+ <!-- Subtle centered play/pause indicator (reflects state; whole tile is tappable) -->
+ <ImageView
+ android:id="@+id/widget_play_pause"
+ android:layout_width="40dp"
+ android:layout_height="40dp"
+ android:layout_gravity="center"
+ android:padding="9dp"
+ android:src="@drawable/ic_widget_play_dark"
+ android:background="@drawable/widget_play_btn_bg"
+ android:scaleType="centerInside"
+ android:contentDescription="Play or pause" />
+
+</FrameLayout>
diff --git a/android/app/src/main/res/values/strings.xml b/android/app/src/main/res/values/strings.xml
index a5159def..337e3617 100644
--- a/android/app/src/main/res/values/strings.xml
+++ b/android/app/src/main/res/values/strings.xml
@@ -2,5 +2,6 @@
<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>
+ <string name="widget_tiny_description">Cover art only - tap to play or pause.</string>
<string name="widget_stats_description">Listening stats: today, this week, streak, and books finished this year.</string>
</resources>
diff --git a/android/app/src/main/res/xml/now_playing_widget_tiny_info.xml b/android/app/src/main/res/xml/now_playing_widget_tiny_info.xml
new file mode 100644
index 00000000..4d509368
--- /dev/null
+++ b/android/app/src/main/res/xml/now_playing_widget_tiny_info.xml
@@ -0,0 +1,13 @@
+<?xml version="1.0" encoding="utf-8"?>
+<appwidget-provider xmlns:android="http://schemas.android.com/apk/res/android"
+ android:initialLayout="@layout/now_playing_widget_tiny"
+ android:minWidth="40dp"
+ android:minHeight="40dp"
+ android:targetCellWidth="1"
+ android:targetCellHeight="1"
+ android:resizeMode="none"
+ android:widgetCategory="home_screen"
+ android:previewImage="@mipmap/ic_launcher"
+ android:previewLayout="@layout/now_playing_widget_tiny"
+ android:description="@string/widget_tiny_description"
+ android:updatePeriodMillis="0" />
diff --git a/lib/services/home_widget_service.dart b/lib/services/home_widget_service.dart
index fca753c0..94eaa64b 100644
--- a/lib/services/home_widget_service.dart
+++ b/lib/services/home_widget_service.dart
@@ -17,6 +17,7 @@ import 'wear_player_service.dart';
const String _androidWidgetName = 'NowPlayingWidget';
const String _androidWidgetCompactName = 'NowPlayingWidgetCompact';
+const String _androidWidgetTinyName = 'NowPlayingWidgetTiny';
const String _androidWidgetStatsName = 'StatsWidget';
const String _iOSWidgetName = 'NowPlayingWidget';
const String _iOSStatsWidgetName = 'StatsWidget';
@@ -633,6 +634,7 @@ class HomeWidgetService {
if (Platform.isAndroid) {
await HomeWidget.updateWidget(name: _androidWidgetName);
await HomeWidget.updateWidget(name: _androidWidgetCompactName);
+ await HomeWidget.updateWidget(name: _androidWidgetTinyName);
await HomeWidget.updateWidget(name: _androidWidgetStatsName);
} else if (Platform.isIOS) {
await HomeWidget.updateWidget(iOSName: _iOSWidgetName);