feat(widget): add adaptive card & circular desktop widgets by SteveZMTstudios · Pull Request #1006 · FoedusProgramme/Gramophone

SteveZMTstudios · 2026-08-22T17:30:16Z

Summary

Card widget — a new responsive home-screen widget family for quick playback control. One provider delivers pill (1×1), circle (2×2 w/ progress ring), card (4×1), medium (4×2) and large (4×4 / wide 5×4) layouts, plus favorite & shuffle actions on wide slots.
Widget favorite action connects through a dedicated playback-service helper so the current item's heart rating and widget state stay in sync across lyric/session updates.
Widget resources use Material You system colors on Android 12+ with stable theme-token fallbacks for pre-12 and night mode; default + zh-rCN strings added for all new settings and the widget picker label.

Screenshots, CI tests and more, see #1003

SteveZMTstudios · 2026-08-22T18:42:22Z

Gramophone-1.1.2.2371d0c-release_desktop_widgets.zip

SteveZMTstudios · 2026-08-23T16:46:43Z

Gramophone-1.1.2.1231f2f-release_desktop_widgets.zip

nift4

Note I didn't have time to go through all of the code yet, this is only partial comments

nift4 · 2026-08-26T12:07:02Z

+    ) {
+        val uri = state.artworkUri ?: return
+        CoroutineScope(Dispatchers.IO).launch {
+            val request = ImageRequest.Builder(context)


I'm wondering if there's a more optimal way to do it, did you test letting image view load the cover itself? (I guess a placeholder can be achieved by stacking two imageview in a framelayout, but IDK if that is a great idea)

My initial attempt involved handling album art loading directly with RemoteViews/ImageViews, but I encountered noticeable UI flickering issues: Whenever controls were updated (e.g., scrolling lyrics from a lyrics control, progress updates, or play/pause switching), reapplying RemoteViews caused the launcher's ImageView to reload/redraw the URI from scratch, resulting in very noticeable and distracting flickering of the album art.

Stacking two ImageViews within a FrameLayout was completely unnecessary, not only adding unnecessary layout overhead but also failing to prevent the top album art view from flickering during subsequent RemoteViews updates, as they refreshed together.

By loading the album art once in the background using Coil and caching it in memory (cachedArtworkBitmap), subsequent control updates (progress bar jumps, playback status changes) could immediately reuse the existing Bitmap, completely eliminating flickering and making updates visually smoother.

nift4 · 2026-08-31T09:59:21Z

There's still unused methods fyi, and a conflict because your other PR was merged

nift4 · 2026-09-02T14:03:05Z

I'm confused, do you perhaps have different code locally? because in this branch there's still unused functions like createErrorNotificationChannel or initCustomCommands

SteveZMTstudios · 2026-09-02T15:10:23Z

I apologize, I (and my computer) have been handling too many things simultaneously lately, and I made a mistake while sorting the code. I have fixed it and will carefully review the subsequent steps.

do you perhaps have different code locally?

And yes, I always bring up the code collection in the feature/stevezmt branch change, which is #1003, to test their coupling.

nift4 · 2026-09-09T14:43:42Z

Sorry for the delay, currently occupied with something else, will review soon.

nift4 · 2026-09-15T10:59:38Z

Thanks for your patience, and sorry for the delay. I tried the widgets on my phone now.

My thoughts from testing:

Overall, I really like the concept of the different widgets. But, I think each type of widget at least needs one provider (so one does pill/circle and another does the card ones). Otherwise I think users would simply not notice that there is different types.

Also, I was wondering about the favorite and shuffle button. I think I would prefer there to either be both shuffle and repeat, or none of them. So maybe, in card layout, there could be repeat in place of current favorite, and favorite is moved to be at end of the name text view instead?

Also, I noticed a minor issue where the favorite button is a different color (more grey) than the other buttons.

Lastly, after closing the app, the widget became empty - it should preferably show the last played song instead, that will be played after pressing the play button (the latter part with restarting playback is already working, widget just doesn't show it).

SteveZMTstudios · 2026-09-17T12:59:22Z

I will make time to handle this as soon as possible. Thank you for sharing your experience and feedback.

Note: corrected file copyright header to SteveZMTstudios (author mistakenly copied Akane Foundation header from template during creation, now corrected).

…trings

…to ui/widget Note: corrected file copyright header to SteveZMTstudios (author mistakenly copied Akane Foundation header from template during creation, now corrected).

…iven updates

…roundPlayer

…yric strings

Note: corrected file copyright header to SteveZMTstudios (author mistakenly copied Akane Foundation header from template during creation, now corrected).

…void reflection crash - Remove unsupported reflection setInt(setGravity) on TextViews in large layout preventing VIEW_MODE_ERROR crash - Update responsive breakpoint mapping: * Circle: (40, 40) -> pillSingle, (100, 40) -> pill, (100, 95) -> circle (2x1 selects pill, 2x2 selects circle) * Card: (120, 50) -> card, (180, 75) -> medium, (180, 130) -> large, (250, 130) -> largeWide (3x1 selects medium, 3x2 selects large) - Expose repeat and shuffle buttons on medium layout (selected by default 3x1 slot) - Constrain card_widget cover maxWidth and button widths with minWidth on text column to prevent title column collapse - Isolate CardWidgetStore SharedPreferences into GramophoneCardWidget to avoid polluting LastPlayedManager - Move savePlaybackSnapshot before nulling instanceForWidgetAndLyricsOnly in GramophonePlaybackService.onDestroy - Extract BaseWidgetProvider to decouple shared provider lifecycle, actions, and artwork caching

…r clipping - Support 6 widget themes in Appearance settings (wallpaper/album art palette with follow-system, dark, and light modes) - Resolve dynamic colors via CardWidgetColorResolver with LRU caching - Add preview images for card and circle widgets in widget picker - Fix double rounded corner issue on large 4x4 covers by relying on view clipToOutline and removing CardWidgetBitmapUtils - Optimize responsive layout variants and prevent pill collapse - Add DesktopWidgetTest and WidgetLayoutProbeTest suites

SteveZMTstudios · 2026-09-19T10:34:51Z

Screenshot_2026-09-19-18-34-14-32_b783bf344239542886fee7b48fa4b892

nift4 · 2026-09-21T13:33:16Z

Your screenshot looks nice, but can you remove the favorite button from the 2x1 card (only)? It makes the title unreadable.

SteveZMTstudios · 2026-09-21T14:08:29Z

Your screenshot looks nice, but can you remove the favorite button from the 2x1 card (only)? It makes the title unreadable.

thats 3x1 actually, my screen is 5x6, and 2x1 with cards makes ugly and its feature almost dumplicate with pill widgets.

btw in the previous round of changes, I revisited the color extraction scheme; it now supports extracting colors from the cover art rather than the system theme color, and allows for independent theme configuration for the widget.

It's now looks like.

Screenshot_2026-09-21-22-07-50-45_b783bf344239542886fee7b48fa4b892

- Hidden the favorite button in compact layouts to ensure the title displays correctly.

…ktop-widgets feat(widget): add adaptive card & circular desktop widgets

nift4 · 2026-10-08T12:39:09Z

I'm working on merging your changes into the compose-rewrite branch. We are rewriting the app in compose, this PR is still applicable so I'm merging it there. I will fix the remaining stuff if I find any myself. GitHub does not support merging PR to different branch without retargeting and I do not have permission to retarget, so I will close this PR. Rest assured the code will be merged manually though.

SteveZMTstudios force-pushed the feat/desktop-widgets branch 2 times, most recently from f5c9b4d to e7d7146 Compare August 22, 2026 18:44

nift4 reviewed Aug 26, 2026

View reviewed changes

nift4 reviewed Aug 28, 2026

View reviewed changes

Comment thread app/src/main/java/org/akanework/gramophone/logic/GramophonePlaybackService.kt Outdated

SteveZMTstudios force-pushed the feat/desktop-widgets branch from 55c398c to 2637746 Compare August 31, 2026 13:57

nift4 reviewed Sep 2, 2026

View reviewed changes

Comment thread app/src/main/java/org/akanework/gramophone/logic/GramophonePlaybackService.kt

SteveZMTstudios force-pushed the feat/desktop-widgets branch from a3bfa04 to 9ec3c2f Compare September 2, 2026 15:58

nift4 reviewed Sep 15, 2026

View reviewed changes

Comment thread app/src/main/java/org/akanework/gramophone/ui/CardWidgetProvider.kt Outdated

nift4 reviewed Sep 15, 2026

View reviewed changes

Comment thread app/src/main/java/org/akanework/gramophone/ui/CardWidgetProvider.kt Outdated

SteveZMTstudios added 11 commits September 19, 2026 00:56

feat(widget): add adaptive card & circular desktop widgets

3312803

Note: corrected file copyright header to SteveZMTstudios (author mistakenly copied Akane Foundation header from template during creation, now corrected).

fix(widget): complete playback service updates and clean extraneous s…

b896234

…trings

refactor(widget): decouple widget view building and state handling in…

a42ee69

…to ui/widget Note: corrected file copyright header to SteveZMTstudios (author mistakenly copied Akane Foundation header from template during creation, now corrected).

refactor(widget): remove circular progress bar and switch to event-dr…

9ec0981

…iven updates

refactor(widget): remove unused createMediaSessionBitmapLoader method

3431091

fix(widget): pass prefs and notification lyric callback to EndedWorka…

cfeb2ee

…roundPlayer

fix(widget): clean leftover unused methods and restore notification l…

12cd5d1

…yric strings

refactor(widget): reuse controller.setRating for favorite toggle

eeffa81

fix(widget): address PR review comments

5acc5c2

Note: corrected file copyright header to SteveZMTstudios (author mistakenly copied Akane Foundation header from template during creation, now corrected).

SteveZMTstudios force-pushed the feat/desktop-widgets branch from 9ec3c2f to 4c290ee Compare September 19, 2026 10:17

fix(widget): adjusted the button display for narrow cards.

5c830a9

- Hidden the favorite button in compact layouts to ensure the title displays correctly.

SteveZMTstudios added a commit to SteveZMTstudios/Gramophone that referenced this pull request Sep 22, 2026

Merge pull request FoedusProgramme#1006 from SteveZMTstudios/feat/des…

696f4ca

…ktop-widgets feat(widget): add adaptive card & circular desktop widgets

nift4 closed this Oct 8, 2026

Conversation

SteveZMTstudios commented Aug 22, 2026

Summary

Uh oh!

SteveZMTstudios commented Aug 22, 2026

Uh oh!

SteveZMTstudios commented Aug 23, 2026

Uh oh!

nift4 left a comment

Choose a reason for hiding this comment

Uh oh!

Uh oh!

Uh oh!

Uh oh!

nift4 Aug 26, 2026

Choose a reason for hiding this comment

Uh oh!

SteveZMTstudios Aug 26, 2026

Choose a reason for hiding this comment

Uh oh!

Uh oh!

nift4 commented Aug 31, 2026

Uh oh!

nift4 commented Sep 2, 2026

Uh oh!

SteveZMTstudios commented Sep 2, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Uh oh!

Uh oh!

nift4 commented Sep 9, 2026

Uh oh!

nift4 commented Sep 15, 2026

Uh oh!

Uh oh!

Uh oh!

SteveZMTstudios commented Sep 17, 2026

Uh oh!

SteveZMTstudios commented Sep 19, 2026

Uh oh!

nift4 commented Sep 21, 2026

Uh oh!

SteveZMTstudios commented Sep 21, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Uh oh!

nift4 commented Oct 8, 2026

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

2 participants

SteveZMTstudios commented Sep 2, 2026 •

edited

Loading

SteveZMTstudios commented Sep 21, 2026 •

edited

Loading