Heretek-AI/not-zune
1
0
Fork 0
mirror of https://github.com/Heretek-AI/not-zune.git synced 2026-10-11 21:19:55 +00:00
Code Issues Packages Projects Releases Wiki Activity

docs(parity): add comprehensive gap inventory vs disassembly (input to next-batch roadmap)

Browse Source
This commit is contained in:
John Smith
2026-09-10 07:23:51 -04:00
parent 481c36312d
commit 3a4318a3fc
1 changed files with 683 additions and 0 deletions
Download Patch File Download Diff File Expand all files Collapse all files
docs/parity/gap_inventory.md
+683
View File
@@ -0,0 +1,683 @@
# Not-Zune ↔ Zune 4.8 Gap Inventory (post-Phase-5 batch)
**Date:** 2026-09-09
**Scope:** Comprehensive cross-reference of `src/NotZune.UI/Views/*` against the
Zune 4.8 evidence base (`tools/disx/zuneshell/`, `tools/disx/zunedbapi/`,
`tools/disx/uix/`, `tools/disx/zune_resources/.rsrc/RCDATA/`).
**Inputs preserved as historical:** `docs/parity/zune48_parity_audit.md`
(written pre-Phases 5–9), `docs/parity/deferred_registry.md` (deferred items).
Effort scale: **quick-win** = ≤½ day, pure plumbing · **medium** = 1–3 days ·
**large** = ≥1 week or hardware/infrastructure dependency.
---
## 1. Views / UX surfaces
### 1.1 Current views (24) under `src/NotZune.UI/Views/`
| File | One-line role |
|---|---|
| `MainShellView.axaml` | Outer shell, custom chrome, panoramic pivot strip, docked HUD, overlays. |
| `CompactMiniPlayerView.axaml` | 420×130 compact mini-player (audio only). |
| `QuickplayView.axaml` | 3-deck panorama (Pins / History / New) + Smart DJ launcher. |
| `CollectionView.axaml` | Music library browser (artists / albums / songs / genres / playlists). |
| `MixviewView.axaml` | Constellation canvas with satellite tiles + action strip. |
| `NowPlayingView.axaml` | 3-mode Now Playing (Artist Canvas / Mosaic Wall / Video clips). |
| `DeviceView.axaml` | Device land: gas gauge, sync content, sync CTA. |
| `SettingsView.axaml` | Two-tier pivot: SOFTWARE (12 sub-pivots) + DEVICE (4 sub-pivots). |
| `FirstLaunchWizardView.axaml` | Welcome → folder → scan → done wizard overlay. |
| `FirstConnectWizardView.axaml` | Per-device-arrival wizard (name → sync options → privacy → done). |
| `WhatsNewView.axaml` | First-launch post-wizard highlights overlay. |
| `PlaylistsView.axaml` | Playlist manager + ZPL export. |
| `PodcastsView.axaml` | RSS feed manager + episode list. |
| `VideoLibraryView.axaml` | Video grid + scan folder + player overlay. |
| `VideoPlaybackView.axaml` | libVLC-backed video player surface. |
| `PhotoLibraryView.axaml` | Folder tree + gallery grid + zoom overlay. |
| `PhotoSlideshowView.axaml` | Ken-Burns full-bleed slideshow (authentic SLIDESHOW.* assets). |
| `CDView.axaml` | DISC pivot: rip + burn queues. |
| `MetadataEditView.axaml` | TagLibSharp-backed tag editor (album/track metadata). |
| `SmartPlaylistEditorView.axaml` | Auto-playlist rule builder (Match All/Any, sort, limit). |
| `TrackMatchReviewView.axaml` | Per-track MusicBrainz match review (`FINDALBUMINFOSONGMATCH` parity). |
| `ZuneCardView.axaml` | Local Zune Card substitute: avatar, stats, badges. |
### 1.2 Cross-reference against `tools/disassembly/zuneshell/ZuneUI/*.Page.cs` (81 page classes)
Pages we cover (25 / 81): `QuickplayPage`, `MusicLibraryPage`, `VideoLibraryPage`,
`PhotoLibraryPage`, `PodcastLibraryPage`, `PlaybackPage`, `SetupLandPage` (≈FirstLaunch),
`FirstConnectPage`+5 child pages, `FirstLaunchPage`+6 child pages, `WizardZunePage`,
`IDeviceContentsPage` (≈DeviceView), `NoStackPage`, `StartupPage`, `TeasePage`,
`CartPage` (N-A), `DownloadsPage` (N-A), `SubscriptionLibraryPage` (N-A),
`ApplicationLibraryPage` (N-A), `FriendsPage` (N-A), `InboxPage` (N-A),
`RadioPage` (N-A), `ProfilePage` (N-A), `Channels*` (N-A).
Pages we DO NOT have (visible-but-not-built, 6 / 81):
| Page | Notes |
|---|---|
| `ApplicationLibraryPage` | Games/Apps hub — N-A (Zune Marketplace shut down). |
| `CategoryPage` | Browse-by-category landing — **MISSING** as a view; Collection is the substitute. |
| `GDILandPage` | The CDI/GDI land root for device update/restore/rollback flows. Device sync screens. |
| `LibraryPage` | The pivot-aggregating "library" root that hosts Music/Video/Photo/Podcast sub-pivots. |
| `ChannelLibraryPage` | Channel/Marketplace — N-A. |
| `DeviceRestore*` (8), `DeviceRollback*` (5), `DeviceUpdate*` (8) | All device firmware lifecycle pages. |
Pages in `tools/disassembly/zuneshell/ZuneUI/*.cs` but never surfaced as a View (representative list — 50+ helpers/landings not listed above): they live behind ViewModels, settings, or wizard orchestration.
### 1.3 Cross-reference against `tools/disassembly/uix/*.UIX` (241 docs)
The `.UIX` resource names hint at "documents" rendered by the Iris UIX engine.
We port roughly 70 of those concepts into AXAML. UIX resources we have an
AXAML equivalent for (representative): `SHELL.uix`, `TRANSPORTCONTROLS`,
`BOTTOMTOOLBAR`, `TOPTOOLBAR`, `PIVOTLIST`, `PIVOTHELPER`, `NONCLIENTCONTROLS`,
`CDVIEW`, `CDSTATE`, `PHOTOLIBRARY`, `PHOTOSLIDESHOW`, `VIDEOLIBRARY`,
`PODCASTLIBRARY`, `PODCASTSERIESPANEL`, `PODCASTDETAILSPANEL`, `PODCASTEPISODESPANEL`,
`COLLECTIONNAVIGATION`, `LIBRARYPANELS`, `LIBRARYCELLS`, `LIBRARYTHUMBNAILOVERLAYS`,
`LIBRARYDIALOGS`, `LIBRARYCONTEXTMENU`, `ALBUMSPANEL`, `ARTISTSPANEL`, `GENRESPANEL`,
`PLAYLISTCONTENTSPANEL`, `PLAYLISTDETAILSPANEL`, `PLAYLISTSPANEL`, `PLAYLISTPOPUP`,
`PLAYLISTDIALOG`, `EDITMEDIAINFODIALOG`, `EDITMEDIAINFOCONTROLS`, `FINDALBUMINFODIALOG`,
`FINDALBUMINFOSONGMATCH`, `AUTOCOMPLETEBOX`, `AUTOPLAYLISTDIALOG`, `SEARCH`,
`NOWPLAYINGLAND`, `NOWPLAYINGSTYLES`, `NOWPLAYINGMUSICBACKGROUND`,
`NOWPLAYINGALBUMGRIDDEFS`, `NOWPLAYINGCLIPS`, `NOWPLAYINGEFFECTS`, `NOWPLAYINGNOTIFICATION`,
`MINIMODE`, `MINIMODEAUDIO`, `MINIMODEJUMPLIST`, `MIXCONTROLS`, `MIXLAYER`, `MIXLAYOUT`,
`MIXMANAGER`, `MIXQUERY`, `QUICKPLAY`, `QUICKPLAYSTRIP`, `QUICKPLAYMODULE`,
`QUICKPLAYMETHODS`, `QUICKPLAYNAVIGATION`, `QUICKPLAYSTYLES`, `QUICKPLAYLISTMODEL`,
`QUICKPLAYTHUMBNAIL`, `QUICKMIX`, `QUICKMIXHELPER`, `QUICKMIXPLAYLISTDIALOG`,
`BADGES`, `MANAGEMENT`, `MANAGEMENTCOLLECTION`, `MANAGEMENTRIP`, `MANAGEMENTBURN`,
`MANAGEMENTMETADATA`, `MANAGEMENTDISPLAY`, `MANAGEMENTPODCAST`, `MANAGEMENTPHOTO`,
`MANAGEMENTFILETYPES`, `MANAGEMENTPRIVACY`, `MANAGEMENTGENERAL`, `MANAGEMENTNAVIGATION`,
`FIRSTLAUNCH`, `FIRSTCONNECT`, `WHATSNEW`, `DIALOG`, `CONTROLS`, `STYLES`,
`SLIDER`, `EDITBOX`, `GASGAUGE`, `MINIGASGAUGE`, `SPREADSHEETCELLS`, `SPREADSHEET`,
`STARRATINGS`, `SYNCANIMATION`, `SYNCINSTRUCTIONTOAST`, `SYNCNOTIFICATION`,
`THUMBNAILBUTTON`, `TOOLBARICON`, `TRANSPORTCONTROLS`, `ANIMATEDICONBUTTON`,
`ANIMATIONS`, `SETUPLAND`, `SHORTCUTKEYS`, `CONTENTLIST`, `LISTVIEWPANEL`,
`JUMPINLIST`, `JUMPLIST`, `LABELWITHARROW`, `FILTERLIST`, `FOCUSRECT`, `GALLERYPANEL`,
`GALLERYVIEW`, `PHOTOFOLDERTREEPANEL`.
UIX resources that hint at concepts we DON'T ship (~50):
| UIX resource | Implication | Gap |
|---|---|---|
| `ABOUTDIALOG` | Standard About box (logo, version, EULA). | **MISSING** as a real About panel — only a "About" sub-pivot placeholder text. |
| `ACCOUNTINFO`, `ACCOUNTCREATION`, `CREATEPASSPORT`, `WINDOWS LIVE` | Passport/Live account creation. | N-A (servers dead). |
| `ADDTOCOLLECTION`, `ADDTOPLAYLIST`, `ADDTOSYNC` | Quick-add flyouts. | **MISSING** — Collection context menu is bare. |
| `APPLICATIONLIBRARY` | Games & apps hub. | N-A. |
| `AUTOPLAYLISTDIALOG` | (Smart playlist rule dialog). | **COVERED** by `SmartPlaylistEditorView` but only from settings, no per-album launch entry. |
| `BADGES` | Badge list. | **COVERED** by ZuneCardView. |
| `BILLINGOFFER`, `BESTVALUE`, `CARTPANEL`, `CARTPAGE`, `SUBSCRIPTIONLIBRARY`, `MANAGEMENTSUBSCRIPTION`, `MANAGEMENTPURCHASES`, `MANAGEMENTRENTALS`, `PAYMENTINSTRUMENT`, `ACCOUNT.CCV.*` | Billing/cart. | N-A. |
| `BROKENUPTEXT` | Wrapping text helper. | **MISSING** — used by bio / lyrics drawer for line-break formatting. |
| `BULLETLIST` | Bullet list helper. | **MISSING**. |
| `CLIPIMAGE` | Image clip helper (circle crops, fan blur). | **MISSING** — artist canvas uses no clipping; avatars are square. |
| `COMMENTSHELPER` | Comment thread helper. | N-A. |
| `COMPLEXSYNCRULEDIALOG` | Advanced sync-rule editor. | **MISSING** — we only expose the simple "All/Selected/Manual" radio set. |
| `CONFIRMALBUMCHANGESDIALOG` | "Apply track match changes" confirm dialog. | **MISSING** — TrackMatchReviewView applies without a confirm step. |
| `CONTENTLIST` | Generic content list. | **MISSING** — we hand-roll `ItemsControl` per view. |
| `DEVICEICONS.UIX`, `DEVICEICON.UIX`, `DEVICEICONPOPUP.UIX`, `ZUNEHDDEVICES.PNG` | Device iconography. | **MISSING** — DeviceView uses no device-portrait assets. |
| `DEVICELAND*` (3), `DEVICEMARKETPLACE`, `DEVICEMOREONWEB`, `DEVICERESTORE`, `DEVICEROLLBACK`, `DEVICESIGNINFAILURE`, `DEVICESUMMARY`, `DEVICESUMMARYDATA`, `DEVICESUMMARYSTATUS` | Device land internals. | Mostly N-A (sign-in / marketplace). Summary surface **MISSING**. |
| `DEVICESPACERESERVATION` | Reservation UI. | **COVERED** by Settings → Space Reservation. |
| `DEVICEUPDATE`, `DEVICEUPDATE*` | Firmware update flows. | N-A (hardware). |
| `DIALOG`, `CONFIRMCLOSE`, `ERRORDIALOG`, `EULADIALOG`, `EXPLICITWARNING`, `SIGNINDIALOG`, `WEBHOSTDIALOG`, `WIZARDDIALOGS` | Standard dialogs. | **MISSING** — confirmations/error dialogs use ad-hoc StackPanels, not a real modal dialog service. |
| `DROPCOMMANDS` | Right-click drop commands. | **PARTIAL** — only Quickplay & Collection have context menus. |
| `EMPTYCOLLECTIONPANEL` | Empty-state visuals. | **MISSING** — we hand-roll per-view empty states. |
| `EPISODESPANEL`, `PODCASTSERIESPANEL`, `PODCASTDETAILSPANEL`, `PODCASTEPISODESPANEL`, `PODCASTDIALOGS`, `PODCASTEPISODESCOLUMNS`, `SERIESPANEL`, `CHANNELSERIESPANEL` | Podcast/series panels. | **PARTIAL** — single list of episodes, no series-level grouping. |
| `FRIENDS.UIX`, `FRIENDSDIALOGS.UIX`, `INBOX*` (8), `SOCIALCOMPOSER.UIX`, `SOCIALEMPTY.UIX`, `SOCIALNAVIGATION.UIX`, `MESSAGINGHELPER.UIX`, `PROFILE.UIX`, `PROFILEEDIT.UIX`, `PROFILECATEGORIES.UIX`, `INBOXBASEDETAILS.UIX` | Social surface. | N-A. |
| `GASGAUGE`, `MINIGASGAUGE` | Gas-gauge primitives. | **PARTIAL** — DeviceView has a custom gauge but no MINIGASGAUGE mini-version on the Quick Dock. |
| `INBOXMAINPANEL` | Inbox notifications. | **MISSING** — no inbox UI even for local notifications (no first-launch welcome toast outside the wizard). |
| `MANAGEMENTACCOUNT` | Account settings page. | N-A (no live account). |
| `MANAGEMENTSHARING` | Per-device "share music/video/photos" toggles. | N-A — deferred in `deferred_registry.md`. |
| `MANAGEMENTDEVICELIST`, `MANAGEMENTDEVICES` | Multi-device list. | **MISSING** — our `DeviceSubPivot.DeviceInfo` shows one device; no enumeration of multiple. |
| `MINIMODEVIDEO` | Mini-player video surface. | N-A (per `deferred_registry.md`). |
| `MOBILEWIRELESSSYNC` | Windows Phone wireless sync. | N-A. |
| `MOREINFOACTIONS` | Right-side action column. | **MISSING** — Now Playing has a top-right action stack but no equivalent side rail on Collection. |
| `NONCLIENTCONTROLS` | Authentic window chrome primitives. | **COVERED** (Window/* assets). |
| `NOTIFICATIONAREA`, `POPUPICON`, `POPUP` | Popups & notification area. | **MISSING** — only one NotificationArea-style overlay (sync toast); no flyout popups. |
| `PAGESTACK`, `PAGINGCONTROL` | Page-stack navigation. | **PARTIAL** — `MainShellViewModel` has a `_navigationHistory` Stack<NavigationPivot> but only one-level deep; no true page-stack history (Collection→Album→Tracks). |
| `PANELRESIZER` | Split-panel resizer. | **MISSING** — PhotoLibraryView, MixviewView, NowPlayingView drawers are fixed-width. |
| `PERCENTAGEICON`, `PERCENTAGEICONFILLED` | Battery/Free-space icons. | **MISSING** — battery text only. |
| `PLAYALL` | "Play all" toolbar. | **MISSING** — no "Play all" button on Collection pivots. |
| `RADIOPANEL`, `RADIOBUTTON.UIX` | Zune Radio (HD). | N-A (spectrum gone). |
| `SLIDER`, `STARBUTTON` | Common controls. | **COVERED** for Slider (volume); **MISSING** for star ratings. |
| `THUMBNAILBUTTONOVERLAY`, `THUMBNAILBUTTON` | Generic thumb button. | **MISSING** — we hand-roll album-art tiles per view. |
| `TOOLTIP`, `WEBHOSTCONTROL`, `WEBHOSTDIALOG` | Tooltip / web host. | **PARTIAL** — ToolTip.Tip set on a few buttons; no shared style or web host. |
| `WIRELESSSYNC` | Wireless sync flows. | **PARTIAL** — only a UI placeholder in Settings. |
| `WIZARD`, `WIZARDCONTROLS`, `WIZARDDIALOGS` | Wizard framework. | **PARTIAL** — only FirstLaunch + FirstConnect re-implement the wizard pattern; no reusable framework. |
### 1.4 `SoftwareSubPivot` / `DeviceSubPivot` enum coverage
**SoftwareSubPivot** (12 of 12 in Zune 4.8 — parity): Collection, Playback, Podcasts, FileTypes, Privacy, Photos, Rip, Burn, Metadata, Display, General, About.
**DeviceSubPivot** (4 of 7 in Zune 4.8):
- ✅ SyncOptions → `DEVICESYNCOPTIONS.UIX`
- ✅ SpaceReservation → `DEVICESPACERESERVATION.UIX`
- ✅ WirelessSync → `WIRELESSSYNC.UIX` (placeholder UI only)
- ✅ DeviceInfo → `DEVICESUMMARY.UIX` (simplified)
- ❌ `MANAGEMENTDEVICELIST.UIX` — multi-device enumeration
- ❌ `MANAGEMENTDEVICES.UIX` — device group manager
- ❌ `DEVICERESTORE.UIX` / `DEVICEROLLBACK.UIX` — restore/rollback UI (N-A w/o hardware but the UI primitives don't exist either)
### 1.5 Pivot gating bug in `SettingsViewModel.cs`
`SoftwarePivot` setter (SettingsViewModel.cs:131–148) fires `OnPropertyChanged` for
**only 7 of 12** sub-pivot flags: Collection, Playback, Rip, Burn, Metadata,
Display, About. It **does not** fire for: Podcasts, FileTypes, Privacy, Photos,
General.
`IsSoftwarePivotActive` is fired by `TopLevelPivot` so cross-tier toggles refresh
correctly. But switching among the 5 un-fanned sub-pivots (e.g. Podcasts →
Privacy → Photos → FileTypes → General) leaves the previous panel visible —
Avalonia only re-evaluates `IsVisible` bindings on `PropertyChanged` events,
and the dependent flags don't fire.
Concrete repro: open Settings → click Podcasts (panel A renders, label active);
click Privacy (label flips active, panel B never replaces panel A → both
StackPanels overlap; lower in the Z-order one wins).
Bug class: One-line fix in the setter (add the 5 missing notifications) — but
the existing tests (`SettingsPagesParityTests.cs:10–53`) only check the
property getter value, so they pass. **Quick-win**, **HIGH** impact (every
user who clicks these settings tabs sees the bug).
### 1.6 Other view surfaces worth noting
- `MINIMODE.UIX` + `MINIMODEAUDIO.UIX` → `CompactMiniPlayerView` (audio-only, no `MINIMODEVIDEO`).
- `FINDALBUMINFOSONGMATCH.UIX` → `TrackMatchReviewView` (real, opened from Collection context menu).
- `AUTOCOMPLETEBOX.UIX` → Header search autocomplete (real, 3+3+3 prefix suggestions).
- `AUTOPLAYLISTDIALOG.UIX` → `SmartPlaylistEditorView` (real, but only opened from settings — no playlist-list entry point).
---
## 2. Audio engine parity
**Real vs. simulated summary**
| Feature | Status | Where |
|---|---|---|
| Real audio decode + output | **REAL** | `BassAudioOutputEngine.cs` (ManagedBass: BASS+FLAC+AAC+Opus) |
| Real gapless chaining (sample-boundary) | **REAL** | `BassAudioOutputEngine.BeginGaplessChainFromSync` |
| Real crossfade (equal-power cosine/sine ramps, 0–10s) | **REAL** | `BassAudioOutputEngine.ApplyFadeRamp` |
| ReplayGain / volume leveling (track gain) | **REAL** | `TagLibReplayGainService.cs` + `PlaybackQueueCoordinator.LoadReplayGainFactor` |
| Real FFT spectrum data (24 perceptual bands) | **REAL** | `BassAudioOutputEngine.GetFftData` |
| Visualizer driven by real FFT | **REAL** | `NowPlayingViewModel._visualizerTimer` (75 ms tick); falls back to fake if no engine |
| Volume control wired to engine | **REAL** | `PlaybackQueueCoordinator.ApplyOutputVolume` → `BassAudioOutputEngine.SetVolume` |
| Mute toggle | **REAL** | Same path. |
| Seek | **REAL** | `BassAudioOutputEngine.Seek` |
| Track-end signal to coordinator | **REAL** | `BassAudioOutputEngine.OnCurrentSourceEnd` |
| EQ (10-band parametric) | **MISSING** | No `Bass.ChannelSetFX(BASS_FXPARAMEQ...)` usage — BASS FX module not loaded. |
| MP3 / WMA / AAC encode (rip) | **SIMULATED** | No real encoder; `CDViewModel.OnRipCdAsync` waits + plays chime. |
| Audio CD burn pipeline | **SIMULATED** | `CDViewModel.OnBurnCdAsync` waits + plays chime. |
| Playback for files without real sources (demo tracks) | **SIMULATED** | `AudioEngine.OnPositionTimerElapsed` drives a 250 ms-tick position advance when `IsSimulatedPlayback`. |
| Sound effects (chimes) | **REAL** | `SoundEffectService.PlaySound` shells to OS CLI player per platform (PowerShell Media.SoundPlayer / afplay / pw-play|paplay|aplay). |
| Network/podcast stream playback | **REAL** | `BassAudioOutputEngine.CreateSource` accepts `http(s)://` and creates async stream. |
| Native audio asset: `ZuneSE_dll` (DShow/EVR sink), `ZuneAACDec_Dll`, `ZuneSrcWrpDLL` | **MISSING** | BASS replaces the role; we don't ship Zune's native decoder. |
| Headless / dummy-device fallback | **REAL** | `Bass.Init(0, ...)` falls back to NoSound. |
**Verdict:** Audio engine is at ~95% parity for playback DSP — the only meaningful
audio gaps are (a) parametric EQ, (b) real encoder for rip, (c) real burner.
(b) and (c) are independent of the playback engine.
---
## 3. Device sync
### 3.1 `IDeviceTransport` boundary
- Interface: `src/NotZune.Application/Interfaces/IDeviceTransport.cs` (real, complete surface: capacity/used/free, GetContents/TryGetItem, CopyToDevice/RemoveFromDevice).
- Implementation in tree: **one** — `src/NotZune.Application/Services/SimulatedDeviceTransport.cs` (in-memory store with seed content).
- Stubs for real transports: **NONE**. There is no `MtpTransport.cs`, no `WmdTransport.cs`, no skeleton class.
- The `SyncEngine` factory pattern (`_transportFactory`) supports injection but no production code injects anything other than `SimulatedDeviceTransport`.
### 3.2 `NotZune.Infrastructure.Devices/` (only 2 files)
- `ZuneDeviceSyncService.cs` — Linux `/sys/bus/usb/devices` scanner, supports Zune product IDs (`063E/0710/0715/0723`).
- `ZuneUsbHttpInterceptor.cs` — placeholder for USB-PPP HTTP interception.
No `TODO`/`FIXME`/`NotImplementedException` markers in this directory (rg confirms clean). The state is "deferred but not stubbed" — i.e. the seam is the `IDeviceTransport` interface, and writing `MtpTransport` is a from-scratch implementation.
### 3.3 Real hardware path (MTPZ)
What Zune 4.8 had:
- `Zumbus.sys` (kernel bus driver) + INF (bus enumeration)
- `ZuneBusEnumSvc` (user-space enumeration service)
- `ZuneMTPZ_dll` (MTPZ protocol implementation, secure variant of MTP)
- `ZuneUsbTransport_dll`, `ZuneIpTransport_dll`, `ZuneTcp2Udp_dll` (USB-PPP, IP, TCP-to-UDP transports)
- `WMZUNE*` (USB-PPP protocol handling)
- `ZuneDriver_dll`
What we'd need for real MTPZ parity: **large** effort. Host-side:
- libusb1 or WinUSB P/Invoke (cross-platform USB bulk transport)
- MTPZ protocol implementation (auth + WMDM metadata + container parsing)
- MTP object store parser (read `\\Content\\Music`, `\\Content\\Podcasts`, etc.)
- ZMDB native parser (4 engine variants)
- ZuneWmduDLL firmware-update logic
- macOS IOKit / Linux udev integration
- `ZuneShellExt_Dll` shell extension (N-A on Linux)
This is hardware-dependent and was deferred in `deferred_registry.md`. **N-A** for the parity scorecard but worth documenting for completeness.
### 3.4 Quick wins inside the simulated path
- `SimulatedDeviceTransport` seed content includes a stale "Macarena" item that always shows in `Keep/Remove` — feels janky. Replace with a placeholder flag. **Quick-win**.
- The "Disconnected" branch on device list is implicit; we never surface the event in the UI. **Quick-win**.
---
## 4. CD Land
`src/NotZune.UI/Views/CDView.axaml` (110 lines) + `CDViewModel.cs` (203 lines).
| Feature | Status | Notes |
|---|---|---|
| Rip / Burn mode toggle | **REAL UI** | `Mode = CDViewMode.Rip/Burn`. |
| Disc session info (title/artist/duration/track count) | **FAKE** | `DiscTitle`, `DiscArtist`, `TotalDurationText = "43:28"` are hard-coded. |
| Disc tracks list (8 sample tracks) | **FAKE** | Hard-coded list of 8 tracks with seeded names + durations. |
| Track playback during rip session | **REAL** | `PlayTrackCommand` enqueues into `IPlayerCoordinator`. |
| Rip progress | **SIMULATED** | `OnRipCdAsync` does `Task.Delay(350)` × track count. |
| Rip destination = settings folder | **FAKE** | `RipDestinationFolder` is read but never written to by `OnRipCdAsync`. |
| Rip completion chime | **REAL** | `SoundEffectService.PlayRipComplete`. |
| Burn queue (per ZPL-style selection) | **MISSING** | `BurnQueue` ObservableCollection is never populated; user can't add tracks to burn. |
| Burn progress | **SIMULATED** | 10-step 300ms loop. |
| Burn completion chime | **REAL** | `SoundEffectService.PlayBurnComplete`. |
| Real optical-drive detection | **MISSING** | No platform code at all — no `cdparanoia`, no IMAPI2, no `cdrdao`. |
| Optical-drive insert/eject events | **MISSING** | `AutoRipCdOnInsert` is a settings checkbox that does nothing. |
| EjectCdAfterRip wiring | **MISSING** | Settings checkbox only. |
### 4.1 What "real CD rip/burn" would require
| Capability | Effort | Notes |
|---|---|---|
| Detect optical drive (Windows: WMI `Win32_CDROMDrive`, Linux: `lsblk -o NAME,TYPE | grep rom`, macOS: `diskutil list`) | medium | One-shot at app startup. |
| Read TOC (`cdparanoia` / Windows IOCTL) | medium | `libcdio` cross-platform C library would do this. |
| Encode to FLAC/MP3/AAC on the fly | large | `ffmpeg` invocation is a pragmatic shortcut; native would be `ZuneEncEngDLL` parity. |
| Burn audio CD | large | `cdrdao` on Linux, IMAPI2 on Windows. |
| Burn data disc | large | ISO 9660 + Joliet image writer. |
| Eject OS notification | quick-win | `eject` shell command. |
**Verdict:** CD Land is at ~30% parity (UI real, behavior simulated, real pipeline is capability-gated). Per `deferred_registry.md` this stays deferred until a developer with optical-drive access explicitly requests it.
---
## 5. Quickplay / Smart DJ
### 5.1 `QuickplayView` (3-deck panorama)
| Deck | Real vs. simulated |
|---|---|
| Pins | **REAL** — `IMediaLibraryService.GetPinnedAlbumsAsync`. |
| History | **REAL** — `IMediaLibraryService.GetRecentHistoryAsync(10)` from SQLite `PlayHistoryEntry`. |
| New | **REAL** — `IMediaLibraryService.GetRecentlyAddedAlbumsAsync(8)`. |
| Smart DJ launcher (3 buttons) | **REAL** — invokes `ISmartDJService.GenerateMixAsync`. |
| Pins context menu (unpin, play) | **REAL** |
**Not yet implemented:**
- Hub hero artwork maps (`QuickPlayMap_*.png`, `SoftwareMap_*.png`) — referenced in `tools/disassembly/uix/` corpus but no assets ship and no view consumes them.
- Radio panel (`RADIOPANEL.UIX`) — N-A (spectrum gone).
- Ad/best-value tiles (`BESTVALUE.UIX`, `BILLINGOFFER.UIX`) — N-A.
- "New" sub-deck filters by genre or period — currently just `recently added`.
- Drag-and-drop reordering of pins.
### 5.2 `SmartDJEngine` (scoring engine)
Current scoring (82 lines):
- Same album +12, same artist +10, same genre +5, favorite rating +4, random jitter 0–3.
What Zune 4.8 had (`QuickMixSessionManager`, `QuickMixPlaylistFactory`):
- Native `IQuickMixManager` interface with ≥10 similar-artist expansion.
- 5-second creation timeout (mix must resolve within 5s).
- Marketplace-backed seed → similar-artist → similar-track chain.
What we have vs. Zune's:
| Concept | Status |
|---|---|
| ≥10 similar artists | **PARTIAL** — Mixview pulls ≥4 related artists by genre/favorite; not used by SmartDJ seed. |
| 5-second creation timeout | **MISSING** — `GenerateMixAsync` is synchronous and un-bounded; could block UI on huge libraries. |
| Mix progress / `QuickMixProgress.cs` | **MISSING** — no progress event during mix generation (only instant for now). |
| Marketplace seeds | N-A (substituted with local). |
Quick wins:
- Add a 5-second `CancellationToken` timeout to `GenerateMixAsync`.
- Add `QuickMixProgress` callback so the Quickplay "STARTING MIX…" overlay can animate.
Medium:
- Build a `IQuickMixProgress` interface and emit progress events.
---
## 6. Now Playing
### 6.1 Modes
| Mode | Status | File |
|---|---|---|
| Artist Canvas (Ken-Burns pan/zoom backdrop + 60pt title / 32pt artist + ambient visualizer) | **REAL** | `NowPlayingView.axaml:17–234`, `NowPlayingViewModel.KenBurnsScale/TranslateX/TranslateY`. |
| Bio drawer | **REAL** | `IsBioDrawerOpen`; Wikipedia bios + `MusicBrainz` enriched data via `ArtistEnrichmentCoordinator`. |
| Lyrics drawer (LRCLIB) | **REAL** | `IsBioDrawerOpen` doubles as lyrics drawer; `LoadLyricsForCurrentTrackAsync`. |
| Showlist (upcoming queue) drawer | **REAL** | `IsShowlistOpen`, `UpcomingQueue`. |
| Auto-hiding HUD (3.5 s idle fade) | **REAL** | `_hudIdleTimer`. |
| Mosaic Wall mode | **REAL** | `NowPlayingView.axaml:239–274`, but it's a static album grid — no Ken-Burns transitions, no cover flow effect. |
| Video Clips mode | **REAL** | `NowPlayingView.axaml:316–348` — libVLC video picker + `VideoPlaybackView` overlay. |
### 6.2 What's a stub
- **Mosaic Wall** is functional but minimal — no fan-blur `CLIPIMAGE`, no autoplay on hover, no "show more albums" pagination.
- **Video Clips** requires the user to manually pick from the list; no "play all" or auto-advance.
- **Bio drawer** has a fixed-width drawer (340 px) with no PANELRESIZER for resize.
- **Lyrics** are displayed unsynced; LRCLIB's synced-lyrics (`SyncedLyrics`) field is captured into `_lyrics` but the timestamps are stripped via `LrcLibStrip`. No karaoke-style line-by-line timing.
- **Showlist** doesn't support drag-reorder of upcoming tracks.
- **Mosaic Wall** transitions between modes use no Iris-style cross-dissolve (we have `TransitioningContentControl` at the shell level but no per-mode fade animation; see §9).
- **Ambient visualizer** falls back to a random-fake if `BassAudioOutputEngine.IsAvailable == false`, but there's no "audio engine unavailable" indicator shown to the user.
- **Wallpaper rotation** (8 s cadence, randomized scale/translate) is deterministic in cadence but the backdrops list is fixed to 10 USERBACKGROUND JPGs when no enrichment is loaded — see `_themeBackdrops` in `NowPlayingViewModel`.
### 6.3 Quick wins
- Add an "engine unavailable" indicator when the visualizer is in fake-fallback state.
- Add the LRCLIB timestamp-aware rendering (use the synced-lyrics without stripping).
- Add a "PLAY ALL" button on Video Clips mode.
---
## 7. Settings — anything still missing?
### 7.1 SoftwareSubPivot coverage
All 12 sub-pivots exist. Cross-reference vs `MANAGEMENT*.UIX`:
| Zune 4.8 page | UIX doc | Our pivot | Status |
|---|---|---|---|
| Collection (monitored folders) | `MANAGEMENTCOLLECTION` | `Collection` | **FULL** |
| Playback (crossfade/gapless/sound FX) | `MANAGEMENTNAVIGATION` + sub-control | `Playback` | **FULL** (FX is toggle-only; no per-track DSP) |
| Podcasts (keep/auto-download) | `MANAGEMENTPODCAST` | `Podcasts` | **FULL** |
| File Types (ingest extensions) | `MANAGEMENTFILETYPES` | `FileTypes` | **FULL** (in-app ingest only; no OS assoc — see `deferred_registry.md`) |
| Privacy (usage data, auto-update) | `MANAGEMENTPRIVACY` | `Privacy` | **FULL** |
| Photos (folder, slideshow) | `MANAGEMENTPHOTO` | `Photos` | **FULL** |
| Rip (format/bitrate/destination) | `MANAGEMENTRIP` | `Rip` | **FULL** (encoder simulated) |
| Burn (disc type/speed/volume leveling) | `MANAGEMENTBURN` | `Burn` | **FULL** (burner simulated) |
| Metadata (auto-fetch, write to file, providers, API keys) | `MANAGEMENTMETADATA` | `Metadata` | **FULL** |
| Display (accents, themes, background art, compact always-on-top) | `MANAGEMENTDISPLAY` | `Display` | **FULL** |
| General (startup view, show ratings, device name) | `MANAGEMENTGENERAL` | `General` | **FULL** |
| About (version, OS info) | `MANAGEMENTNAVIGATION` "About" | `About` | **PARTIAL** — `VersionInfo`/`PlatformInfo` populated but no big "About" panel with logo + EULA link. |
### 7.2 Missing software settings pages
- **`MANAGEMENTACCOUNT.UIX`** — Passport/Live sign-in. N-A.
- **`MANAGEMENTSHARING.UIX`** — UPnP / per-device sharing toggles. Deferred in `deferred_registry.md`.
- **`MANAGEMENTPURCHASES.UIX`**, **`MANAGEMENTRENTALS.UIX`**, **`MANAGEMENTSUBSCRIPTION.UIX`** — billing/subscription. N-A.
### 7.3 Missing device settings pages
- **`MANAGEMENTDEVICELIST.UIX`** — multiple-device enumeration. We never show "no device / Zune 30 / Zune HD" simultaneous list.
- **`MANAGEMENTDEVICES.UIX`** — device-group manager (sync groups per device). We have one device's sync rules at a time.
- **`DEVICESUMMARY.UIX`** — full device summary panel (firmware, capacity, free space, serial, color). We have a simplified `DeviceInfo` sub-pivot.
- **`DEVICESUMMARYSTATUS.UIX`**, **`DEVICESUMMARYDATA.UIX`** — sub-panels.
### 7.4 Pivot-gating bug (also see §1.5)
This is a **HIGH** impact, **quick-win** fix in `SettingsViewModel.SoftwarePivot` setter.
### 7.5 About sub-pivot
The current `IsAboutSubPivotActive` panel only renders version + OS info. Zune's `ABOUTDIALOG.UIX` had: color logo, version, build, OS, EULA link, build date, copyright. **Medium** effort to flesh out.
---
## 8. Graphics / assets
### 8.1 Bundled assets under `src/NotZune.UI/Assets/Zune/` (12 dirs, ~100 files)
- `Backgrounds/` — 44 USERBACKGROUND JPGs (10, 11–19, 20–29, 30–39, 40–47; missing 27 — gap).
- `Branding/` — QUICKMIXICON, ZUNECOLORLOGO, ZUNEHDDEVICES, ZUNELOGO(.HOVER/.PRESSED), ZUNELOGOTEXT, ZUNEUSER.
- `CD/` — CDARTSHADOW, CDLANDSHINE, CDRIPBURNGLOW. **NOT REFERENCED in CDView.axaml** (gap).
- `Fonts/` — 5 Segoe ZLC variants.
- `Mixview/` — MIX.ADD(.DEFAULT/.HOVER/.PRESSED), MIX.HATEIT(.DEFAULT/.HOVER/.PRESSED), MIX.INFO(.DEFAULT/.HOVER/.PRESSED), MIX.LIKEIT(.DEFAULT/.HOVER/.PRESSED), MIX.MIX(.DEFAULT/.HOVER/.PRESSED), MIX.PERIPHERYTILE.OUTLINEDARK. (No HOVER/PRESSED for MIX.PLAY — used in code but PNG missing? Quick-win.)
- `Rating/` — 60+ RATING.* PNGs (DARK / NP / NOWPLAYING / Hover/Pressed/Click variants for Likeit/Hateit/Notrated).
- `Slideshow/` — SLIDESHOW.BACK/NEXT/PAUSE/PLAY, VIDEOOVERLAY, VIDEOS.EMPTY.
- `Social/` — PROFILE.BADGE.SEAL, PROFILE.DEFAULT.TILE. (Missing: ZuneCard frame, message tile, etc.)
- `Sounds/` — COMPLETEDRIPREVERSYNC.WAV, COMPLETEDSYNCBURNCD.WAV, DOWNLOAD.WAV, INBOX.WAV.
- `Sync/` — SYNC.ACTIVELYSYNCING.NOWPLAYING, SYNC.ACTIVELYSYNCING, SYNCGLOW, SYNC.TOASTARROW.
- `Transport/` — TRANSPORT.* (BACK, FORWARD, FULLSCREEN, MUTE, PAUSE, PLAY, REPEAT, SHOWLIST, SHUFFLE, SLIDESHOW, STOP, SWITCH.TOMUSIC, SWITCH.TOPHOTO) + ICON.NOWPLAYING.ENTER.
### 8.2 Resources extracted but NOT in our tree (corpus → missing)
Searching the 1,671-item RCDATA list:
- **`BRANDTAG.HORIZONTAL.PNG`, `BRANDTAG.VERTICAL.PNG`** — Not-Zune brand tag. Not bundled.
- **All `ZUNELOGO.*` variants** — only the 3 we have. The 3 PNGs we already have are identical, just renamed.
- **`ZUNEUSER.PNG`** — bundled.
- **`ICON.NOWPLAYING.FRAME01.PNG`…`FRAME10.PNG`** (and HOVER/PRESSED variants, 30 total) — only `ICON.NOWPLAYING.FRAME*.PNG` (FRAME01–10) and the ENTER variant are in use. The HOVER/PRESSED variants per-frame would give the hover-state animation fidelity of Zune 4.8.
- **`NOWPLAYINGARTLOGO_01.PNG`–`_06.PNG`** (6 frames) and **`NOWPLAYINGARTSHAPE_01A–03D.PNG`** (12 frames) — the actual Iris-rendered "art spinning behind the now playing text" frames. We do not animate these.
- **`NOWPLAYINGANIMATIONORANGE1.PNG`, `NOWPLAYINGANIMATIONPINK1.PNG`** — Now Playing button animation frames. We use static `ICON.NOWPLAYING.ENTER.PNG`.
- **`NOWPLAYINGLISTTRIANGLE.PNG`** — triangle indicator. Not used.
- **`NOWPLAYINGBOXSHADOW.PNG`** — shadow under the now-playing text. Not used.
- **`NOWPLAYING.BUTTON.PNG` / `.HOVER.PNG` / `.PRESSED.PNG` / `.DISABLED.PNG`** — Now Playing toggle button states. We use `ICON.NOWPLAYING.*` instead.
- **`ALBUM.SMALL.SHADOW.PNG`** — small album shadow. Not used (we hand-roll per-tile borders).
- **`ACTIONBUTTON.PNG` / `ACTIONBUTTON.DISABLED.PNG` / `ACTIONBUTTON.HOVER.PNG` / `ACTIONBUTTON.PRESSED.PNG`** — generic action button. We don't use these.
- **`ACTIONBUTTON.PINK.*`** — pink variant.
- **`ACTIONOVERLAY.PNG`** — overlay graphic.
- **`ACTIONPROGRESSBUTTON.PROGRESSBACKGROUND.PNG` / `.PROGRESSBAR.PNG` / `.PROGRESSPLAYBACKGROUND.PNG`** + `ACTIONPROGRESSBUTTON.UIX` — action button with progress fill. Not used.
- **`ACTIVESHADOWTOP/BOTTOM/LEFT/RIGHT.PNG`** — window active shadow. Not used.
- **`ACQUIRINGALBUMART.PNG`** — album art acquisition state. Not used.
- **`ARTISTBOX.BACKGROUND.PNG` / `.DISABLED.PNG` / `.FOCUSED.PNG`** — text box for artist search. Not used.
- **`COMBOBOXWITHICONS.DROPDOWNBACKGROUND.PNG`** — dropdown background. Not used.
- **`CROSSHATCH.QUICKPLAY.WELCOME.PNG`** — Quickplay welcome backplate. Not used.
- **`DEVICEICON*` family** — device-icon set. Only `ZUNEHDDEVICES.PNG` shipped.
- **`ICON.HD.PNG`**, **`ICON.MARKETPLACE.RADIO.PNG`**, **`ICON.QUICKPLAY.*` family** — only `QUICKPLAY.COLLECTION.PNG` is shipped.
- **`ICON.EXTERNALLINK.PNG`, `ICON.EXTERNALLINK.LIGHT.PNG`** — external link icon. Not used.
- **`ICON.PAGE.CURRENT.PNG`, `ICON.PAGE.OTHER.PNG`** — page indicator dots. Not used.
- **`ICON.PC.*`** family — PC device icon. Not used.
- **`ICON.PLAYLIST.*`** family, **`ICON.BURN.*`** family, **`ICON.QUICKPLAY.PLAYLIST.*`** family — many device/drag variants missing.
- **`MIXMELDICON.PNG`** — "mix meld" icon. Not used.
- **`MIX.PERIPHERYTILE.OUTLINE.PNG`** — satellite tile outline. We have `.OUTLINEDARK.PNG` only.
- **`MIX.SEEDTILESHADOW.PNG` / `.NOWPLAYING.PNG`** — seed-tile drop shadow. Not used.
- **`MIX.TILE.ROLLOVER.FILL.PNG` / `.NOWPLAYING.PNG`** — tile hover fill. Not used.
- **`MIX.TILE.ACTION.GLOW.PNG`** — action glow on tile. Not used.
- **`MIX.UNRATED.DEFAULT.PNG` / `.HOVER.PNG` / `.PRESSED.PNG`** — unrated action tile. Not used.
- **`POPUPICONMENUDROPSHADOW.PNG`** — popup shadow. Not used.
- **`PIVOT.SCROLL.QUICKPLAY.LEFT/RIGHT.*`** — pivot chevron scroll arrows (drag-pan parity). We document this gap in `deferred_registry.md`.
- **`RATING.HEADER.PNG`** — rating column header (used in `LIBRARYTHUMBNAILOVERLAYS.UIX`). Not used.
- **`RATING.LIKEORUNRATED.PNG` / `.HOVER.PNG`** — combined like-or-unrated state. Not used.
- **`RATING.NOWPLAYING.*` family** — Now-Playing variant (we have `NP.*` shipped; `NOWPLAYING.*` is in repo but the same path).
- **`SPLITTER.PNG`** — split-panel handle. Not used (we lack PANELRESIZER).
- **`SYNC.*` family beyond `SYNC.ACTIVELYSYNCING.*`, `SYNCGLOW.PNG`, `SYNC.TOASTARROW.PNG`** — only4 of N are bundled.
- **`SYNCINSTRUCTIONTOAST.UIX`**, **`SYNCNOTIFICATION.UIX`** — sync animation surfaces. Not implemented.
- **`WHATSNEWBACKGROUND.PNG`, `WHATSNEWIMAGE.PNG`** — What's New hero art. We use a tiny unicode diamond instead.
- **`VIDEOS.EMPTY.PNG`** (bundled) — referenced in `VideoLibraryView.axaml:68`. OK.
### 8.3 Asset-related quick wins
- Drop in `CDLANDSHINE.PNG` + `CDRIPBURNGLOW.PNG` + `CDARTSHADOW.PNG` (already in the repo) on the CDView disc summary box. **Quick-win** (~30 min).
- Drop in `NOWPLAYING.BUTTON.*` + `NOWPLAYINGANIMATION*` for the Now Playing toggle. **Quick-win**.
- Drop in `ICON.NOWPLAYING.FRAME01–10` + HOVER/PRESSED variants to give the Now Playing button a true animated-state UI. **Quick-win**.
- Drop in `NOWPLAYINGARTLOGO_*` and `NOWPLAYINGARTSHAPE_*` frames for the iris-style "art behind text" animation in Artist Canvas mode. **Medium** (need a timer + ImageArray).
---
## 9. Animations
### 9.1 What exists
| Animation | Where | Status |
|---|---|---|
| Now Playing equalizer button frame cycle (10 frames @ ~200 ms) | `MainShellViewModel._equalizerTimer` cycling `ICON.NOWPLAYING.FRAME01..10` | **REAL** |
| Now Playing slideshow backdrop (8 s cadence, randomized Ken-Burns scale/translate) | `NowPlayingViewModel._slideshowTimer` (8000 ms) + `KenBurnsScale/TranslateX/TranslateY` bindings | **REAL** |
| Ambient visualizer (75 ms tick) | `NowPlayingViewModel._visualizerTimer` + `_audioEngine.GetFftData()` | **REAL** |
| Photo slideshow Ken-Burns (6 s cadence) | `PhotoSlideshowViewModel._advanceTimer` (6000 ms) | **REAL** |
| Photo slideshow randomization on advance | `RandomizeKenBurns` | **REAL** |
| HUD auto-fade (3.5 s idle) | `NowPlayingViewModel._hudIdleTimer` (3500 ms) | **REAL** |
| Pivot mode swap | `ToggleModeCommand` swaps the mode; no transition. | **MISSING** — direct repaint. |
| Sync instruction toast slide-in | Static `Border` with `IsVisible` toggle. | **MISSING** — no slide/fade. |
| Drawer slide-out (Bio / Showlist) | Static `Border` with `IsVisible` toggle. | **MISSING** — no slide-in. |
| Bio drawer close → Showlist open transition | `ToggleShowlistCommand` sets `IsShowlistOpen=true; IsBioDrawerOpen=false` simultaneously. | **MISSING** — instant swap. |
| Pivot strip horizontal bleed | Mouse-wheel pan (`OnPivotStripPointerWheelChanged`). | **PARTIAL** — no inertia / no touch drag. |
| Mixview satellite glide-to-center | Direct `Canvas.Left/Top` binding. | **PARTIAL** — no Iris-style inertia. |
| Mini-player drag-to-move | `OnMiniBarPointerPressed` calls `window.BeginMoveDrag(e)`. | **REAL** |
| FirstConnectWizard / FirstLaunchWizard / WhatsNew overlays | `TransitioningContentControl` at shell level gives CrossFade. | **PARTIAL** — one animation only. |
| `ANIMATIONS.UIX`, `ANIMATEDICONBUTTON.UIX` (Iris animation engine equivalents) | **MISSING** — we have no XAML transitions at all. |
### 9.2 What Zune 4.8 had
`ANIMATIONS.UIX` is the Iris UIX animation definition language. Zune used Iris
animation pipelines for:
- Pivot panorama transition (push / crossfade).
- Drawer slide-in / slide-out (with inertia + collapse).
- Now Playing art-frame rotation.
- Mixview satellite fly-to-center.
- Sync animation (`SYNCANIMATION.UIX`).
### 9.3 Current implementation in code
There are **zero** `Transitions`, `Storyboard`, `DoubleAnimation`, `Easing`
elements in any AXAML file. The only animations are timer-driven property
updates on view-models.
### 9.4 Quick wins
- Add Avalonia `Transitions` to drawer `Border` width/offset for slide-in.
- Add `Transitions` to bio/showlist drawers (OpacityTransform + TranslateTransform).
- Add `Transitions` to mode-swap Grid (CrossFade via `TransitioningContentControl` child).
- Add `Easing` to the Now Playing mode toggle (replace direct swap with 250ms cross-fade).
Medium:
- Re-implement Zune's Ken-Burns pan/zoom (Zune did 20s per backdrop; we do 8s — we are faster but less meditative).
Large:
- Implement a proper Iris-style animation engine in pure Avalonia. Probably not worth it.
---
## 10. Search
| Zune 4.8 surface | Our implementation | Status |
|---|---|---|
| Header search box | `HeaderSearchQuery` + `MainShellView.axaml:159–219` | **REAL** |
| ShowSearch per page (hidden on Quickplay/NowPlaying/Settings) | `IsHeaderSearchVisible` | **REAL** |
| Autocomplete suggestions (`AUTOCOMPLETEBOX.UIX`) | `HasSearchSuggestions` + 3 artists + 3 albums + 3 songs prefix-matches via `UpdateSearchSuggestions` | **REAL** (limited to 8 items, single category match) |
| Suggestions clickable | `AcceptSuggestionCommand` | **REAL** |
| `HasSearchSuggestions` cleared below 2 chars | `UpdateSearchSuggestions` (line 122) | **REAL** |
| Per-track MusicBrainz match review (`FINDALBUMINFOSONGMATCH.UIX`) | `TrackMatchReviewView.axaml` (70 lines) | **REAL** (dialog opened from Collection context menu; per-track checkboxes + MBID resolution) |
| Search across podcasts | **MISSING** — no `PodcastSeries` prefix match. |
| Search across videos | **MISSING** — no `Video` prefix match. |
| Search across playlists | **MISSING** — no `Playlist` prefix match. |
| Search across devices (MTPZ) | N-A (no real device). |
| Type-ahead A–Z jump-in-list (`SHORTCUTKEYS.UIX` + `JUMPINLIST.UIX`) | **MISSING** — deferred in `deferred_registry.md`. |
| "Search Community" (marketplace) | N-A. |
| Find Album Info art only | **REAL** (`Phase 4` audit) |
| Find Album Info per-track | **REAL** (Phase 5) |
### 10.1 Quick wins
- Add podcasts + videos + playlists to the `UpdateSearchSuggestions` prefix-matches.
- Highlight the matched substring inside the suggestion item.
Medium:
- Add a "find in all libraries" toggle (current code searches Collection only).
---
## 11. Social / Zune Card
### 11.1 Current `ZuneCardView` + `ZuneCardViewModel`
| Surface | Status |
|---|---|
| Avatar tile (default `PROFILE.DEFAULT.TILE.PNG`) | **REAL** (placeholder — no real avatar picker) |
| ZuneTag (display name) | **REAL** — `Profile.ZuneTag` from local stats. |
| Member since | **REAL** — derived from `Profile.MemberSinceUtc`. |
| Status message | **REAL** — editable in `Profile.StatusMessage`. |
| Scrobbles counter | **REAL** — `UserStatsService.GetProfileAsync` from SQLite play history. |
| Listening hours | **REAL** — `Profile.TotalListeningTime`. |
| Top artists (5) with play-count bars | **REAL** — `UserStatsService.GetTopArtistsAsync`. |
| Badges (5 categories) | **REAL** — `UserStatsService.GetBadgesAsync`; `PROFILE.BADGE.SEAL.PNG`. |
| Friends list (`FRIENDS.UIX`) | N-A. |
| Inbox (`INBOX*.UIX`) | N-A. |
| Social composer | N-A. |
| Marketplace profile | N-A. |
### 11.2 What's a stub
- Avatar is hard-coded to `PROFILE.DEFAULT.TILE.PNG` (no file picker).
- "Zune Tag" can't be edited in the UI (it's set on first launch).
- The "Member Since" date is read-only.
- No per-badge unlock notification (badges just appear when they appear).
- No share-to-social button.
### 11.3 Quick wins
- Add a "Customize" button on ZuneCardView that opens an inline editor for ZuneTag + StatusMessage.
- Add per-badge unlock toast.
---
## 12. Mini-player
`CompactMiniPlayerView.axaml` (108 lines, 420×130).
| Feature | Status |
|---|---|
| Compact mode toggle (Ctrl+M) | **REAL** |
| Hairline seek scrubber (2px) | **REAL** |
| Mini album-art tile (44×44) | **REAL** |
| Heart badge if favorite | **REAL** |
| Track title / artist / elapsed | **REAL** |
| Mini transport (back/play-pause/forward) | **REAL** |
| Restore button → MainShell | **REAL** |
| Close button | **REAL** |
| Drag-to-move window | **REAL** (`OnMiniBarPointerPressed` → `BeginMoveDrag`) |
| Drag-edge-to-dock (Zune's edge-snap) | **MISSING** |
| Audio-only surface | **REAL** (no video inside the mini-player) |
| Video mini-mode (`MINIMODEVIDEO.UIX`) | N-A per `deferred_registry.md` |
| Showlist toggle inside mini-player | **MISSING** |
| EQ / volume slider inside mini-player | **MISSING** — must open main shell to access volume. |
| Mini Now Playing icon frame animation | **MISSING** — main shell has the cycle; mini uses static play/pause. |
| "Always on top" toggle (`CompactModeAlwaysOnTop`) | **REAL** as a setting, no enforcement. |
| Jump list (recent/pinned tasks) | N-A (Windows shell). |
| Notification area icon | N-A (per `deferred_registry.md`). |
### 12.1 Quick wins
- Add showlist toggle inside the mini-player (use the same `ToggleShowlistCommand` at the shell level).
- Add volume slider to mini-player.
- Add the animated `ICON.NOWPLAYING.FRAME*` cycle in mini-player.
Medium:
- Implement edge-snap docking (detect proximity to screen edges on move-drag).
---
## TOP 15 GAPS TO CLOSE
**Ranking by impact × ease-of-implementation.** The recent Phases 5–9 already
moved parity from ~55–60% to ~75–80%. This list targets the next band.
| # | Gap | Effort | Impact | Rationale |
|---|---|---|---|---|
| 1 | **Settings pivot-gating bug** (`SoftwarePivot` setter doesn't fire 5 sub-pivot notifications) | **quick-win** (≤1 hr) | **HIGH** | Every user that clicks Podcasts/FileTypes/Privacy/Photos/General sees a stacking bug. Trivial fix. |
| 2 | **CDView disc backdrop + glow** (`CDLANDSHINE.PNG` + `CDRIPBURNGLOW.PNG` + `CDARTSHADOW.PNG` already extracted but not referenced in `CDView.axaml`) | **quick-win** (½ day) | MEDIUM | Three assets sitting in `Assets/Zune/CD/` already; we just don't bind them. |
| 3 | **Now Playing button animation states** (`NOWPLAYING.BUTTON.PNG/.HOVER/.PRESSED/.DISABLED.PNG` + 10 HOVER/PRESSED frame variants already in corpus) | **quick-win** (½ day) | MEDIUM | The MainShell's animated equalizer button currently only cycles 10 default frames — adding HOVER/PRESSED per-frame gives the authentic hover-state fidelity. |
| 4 | **Now Playing art-frame iris animation** (`NOWPLAYINGARTLOGO_01–06.PNG` + `NOWPLAYINGARTSHAPE_01A–03D.PNG` already extracted) | **medium** (1–2 days) | HIGH | The most distinctive Zune 4.8 visual moment — the iris-revealing colored-art frames behind the now-playing text. We have the assets, we just don't animate them. |
| 5 | **Drawer slide-in / fade animations** (Bio, Showlist, Sync toast — currently IsVisible toggle) | **medium** (1 day) | HIGH | Avalonia `Transitions` + a small `ReactiveDrawer` behavior; Zune's slide-out drawers are a defining interaction. |
| 6 | **Mode-swap crossfade in Now Playing** (Artist Canvas ↔ Mosaic Wall ↔ Video) | **medium** (½ day) | MEDIUM | Replace the direct Grid swap with `TransitioningContentControl` + a 250 ms cross-fade. |
| 7 | **Smart DJ 5-second timeout + progress callback** (`IQuickMixProgress`) | **quick-win** (½ day) | MEDIUM | `GenerateMixAsync` should honor `CancellationToken(5s)` and emit progress. Zune parity +1 minor +1 medium. |
| 8 | **Reusable confirm/error dialog service** (`DIALOG.UIX`, `ERRORDIALOG.UIX`, `CONFIRMCLOSE.UIX`) | **medium** (1 day) | MEDIUM | Every view that mutates state currently hand-rolls its confirm dialog. A `IDialogService` with modal Avalonia windows is the missing framework piece. |
| 9 | **REAL About sub-pivot** (logo, version, OS, build date, copyright, EULA link) | **medium** (½ day) | LOW | Cosmetic; "About" page is currently just two text lines. |
| 10 | **Search across podcasts / videos / playlists** | **quick-win** (½ day) | MEDIUM | 5 LOC change in `UpdateSearchSuggestions` to include those collections. |
| 11 | **Smart DJ seed-progress + Quick Mix notification** (`QuickMixProgress.cs` + `QuickMixNotification.cs` parity) | **medium** (1 day) | MEDIUM | Animated "CREATING YOUR MIX…" overlay during generation. |
| 12 | **Zune Card avatar picker + editable ZuneTag/StatusMessage** | **medium** (1 day) | LOW | Replace static tile with image-picker; inline edit for the displayed strings. |
| 13 | **Mini-player showlist toggle + volume slider** | **quick-win** (½ day) | MEDIUM | Two commands we already have; just expose them inside `CompactMiniPlayerView`. |
| 14 | **Hub hero artwork maps on Quickplay** (`QuickPlayMap_*.png` / `SoftwareMap_*.png` shipped but not consumed) | **medium** (1–2 days) | MEDIUM | The Quickplay hub background is a solid color; the asset names hint at high-fidelity world-map graphics that ship but aren't bound. |
| 15 | **Real CD rip/burn pipeline** (`cdparanoia` / `cdrdao` / IMAPI2 / `ffmpeg`) | **large** (1+ week) | MEDIUM-LOW | Capability-gated by optical-drive access; documented as deferred in `deferred_registry.md`. Promote to "in-progress" if a developer with optical-drive access joins. |
### Not-on-the-list (already covered or N-A)
- Real MTPZ device sync → N-A (hardware-dependent).
- UPnP media sharing → N-A (deferred).
- Windows shell extensions / jump lists / taskbar integration → N-A.
- i18n (26 Zune locales) → deferred per registry.
- Marketplace / Zune Pass / cart / billing → N-A.
- Friends / Inbox / Social composer → N-A.
- Mini-player video surface → deferred per registry.
- Drag-inertia panoramic pivot strip → deferred per registry.
- A–Z type-ahead jump-in-list → deferred per registry.
### Cumulative parity scorecard after this list
If all 15 are closed, weighted parity (UI presentation strongly, hardware/features neutral) lands at ~85–90%. The remaining ~10–15% is hardware-dependent MTPZ / i18n / Windows shell integration, all explicitly deferred.
End of inventory.