yonlu/yellowjacket
1
1
Fork 0
Code Issues 55 Pull Requests 6 Actions Packages Projects Releases 12 Wiki Activity

Desktop: mini-player — a small always-on-top window with basic controls #12

New Issue
Open
opened 2026-08-18 05:53:05 +00:00 by logan · 0 comments
logan commented 2026-08-18 05:53:05 +00:00
Collaborator
Copy Link
Copy Source

Report

Feature request: a very small always-on-top window with basic transport controls and now-playing metadata, as an alternative to keeping the whole app window up.

Findings

  • Wails v3 supports multiple windows: app.Window.NewWithOptions(...) in main.go creates the main one, and AlwaysOnTop is a window option.
  • The frontend is one bundle; a second window would load the same assets with a query/hash selecting a mini-player root, so frontend/index.ts would need an entry branch that mounts only that component.
  • The stores are singletons per window; state comes from backend events, which are broadcast, so both windows stay in sync for free. Anything read once at startup needs checking.

Direction

Scope for a first cut: art, title/artist, play-pause, prev/next, seek bar, close-to-tray-ish behaviour. Open questions: does closing the main window keep the app alive (interacts with ShouldQuit's async veto), and does the mini window get its own MPRIS/media-controls handling (it should not — that is process-level).

Related: the "small window sizes" issue floats switching to a mini-player mode when the main window is shrunk far enough.

**Report** Feature request: a very small always-on-top window with basic transport controls and now-playing metadata, as an alternative to keeping the whole app window up. **Findings** - Wails v3 supports multiple windows: `app.Window.NewWithOptions(...)` in `main.go` creates the main one, and `AlwaysOnTop` is a window option. - The frontend is one bundle; a second window would load the same assets with a query/hash selecting a mini-player root, so `frontend/index.ts` would need an entry branch that mounts only that component. - The stores are singletons *per window*; state comes from backend events, which are broadcast, so both windows stay in sync for free. Anything read once at startup needs checking. **Direction** Scope for a first cut: art, title/artist, play-pause, prev/next, seek bar, close-to-tray-ish behaviour. Open questions: does closing the main window keep the app alive (interacts with `ShouldQuit`'s async veto), and does the mini window get its own MPRIS/media-controls handling (it should not — that is process-level). Related: the "small window sizes" issue floats switching to a mini-player mode when the main window is shrunk far enough.
logan added the Area/PlayerKind/FeaturePlatform/Desktop
Priority
Low
4
 labels 2026-08-18 14:36:05 +00:00
Sign in to join this conversation.
No Branch/Tag Specified
Branches Tags
Labels
Clear labels
Area/Design
Area/Downloads
Area/Explore
Area/Library-UI
Area/Metadata
Area/Packaging
Area/Player
Area/Queue
Area/Settings
Area/Shell-Nav
Compat/Breaking
Breaking change that won't be backward compatible
 Kind/Bug
Something is not working
 Kind/Documentation
Documentation changes
 Kind/Enhancement
Improve existing functionality
 Kind/Feature
New functionality
 Kind/Security
This is security issue
 Kind/Testing
Issue or pull request related to testing
 Platform/Android
Platform/Desktop
Priority
Critical
1
The priority is critical
Priority
High
2
The priority is high
Priority
Medium
3
The priority is medium
Priority
Low
4
The priority is low
Reviewed
Confirmed
1
Issue has been confirmed
Reviewed
Duplicate
2
This issue or pull request already exists
Reviewed
Invalid
3
Invalid issue
Reviewed
Won't Fix
3
This issue won't be fixed
Status
Blocked
1
Something is blocking this issue or pull request
Status
Need More Info
2
Feedback is required to reproduce issue or to continue work
Status
Abandoned
3
Somebody has started to work on this but abandoned work
Status
In Progress
Somebody is actively working on this right now
No labels Area/Player Kind/Feature Platform/Desktop
Priority
Low
4
Milestone
No items
No Milestone
Projects
Clear projects
No projects
Assignees
Clear assignees
logan yonlu
No Assignees
1 Participants
Notifications
Due Date
No due date set.
Dependencies

No dependencies set.

Reference: yonlu/yellowjacket#12