Skip to content

← All documentation

Post-install setup · Y2Reborn

Reborn UI v1 navigation and focus map

Documentation published by SchulzCode/Y2Reborn.

Instructions published by the project, shown here word for word.

Reborn UI v1 navigation and focus map

> **Historical record.** The dates, candidate identity, "current" claims, > next steps and permissions below belong to this recorded boundary. See > [current state](../CURRENT_REBORN_STATE.md) for the latest physically observed result.

All rows traverse top-to-bottom in displayed order, skipping disabled actions. Visible windows contain five rows, or three below album/artist art. Counter shows position/total. Select opens/acts; Back restores parent filter/focus/scroll. Long Back returns Home unless closing a modal. Every interactive view has one focus. Boot and locked root-install preparation are noninteractive and have no focus.

Global Play/Pause, Previous/Next and Volume remain available through ordinary views, dialogs, pairing and password entry, subject to the existing input router. Volume never navigates. Screen-off navigation is ignored. Long Play opens Now Playing only outside a focus trap. Long Select means Context, or password submit. An unavailable context is a deliberate no-op, not an empty menu. No touch paths.

ScreenParent / child destinations and focus orderBackContext / special long actionEmpty / unavailable
StartupBoot → Home after actual startupNoneNoneMeaningful service failure; no fake progress
HomeMusic → Now Playing → Queue → Connectivity → SettingsNo-opLong Play: Now PlayingRoot navigation always available
MusicHome; Albums → Artists → Songs → Folders → ScanHomeNoneScan is available; child lists explain empty state
AlbumsMusic or Artist; alphabetic album rows → AlbumRestore parentJump to LetterScan Library action
AlbumAlbums/context; Play All → ordered tracksSame album positionPlay All: collection actions; track: track actionsOffline/missing collection explanation, Back
ArtistsMusic; artist rows → ArtistMusicJump to LetterScan Library action
ArtistArtists/context; Play All → Albums by Artist → songsSame artist positionPlay All: artist actions; song: track actionsUnknown artist label; no fake art
SongsMusic; title-ordered tracksMusic or supplied parentTrack context + Jump to Letter for unfiltered SongsScan Library action
FoldersMusic/folder; child folders then direct songsParent folder with same focus/scrollTrack actions for filesScan; Back always reaches parent
Letter IndexSongs/Albums/Artists; represented letters, # for other initialsRestore original list positionSelect jumps into originating listBack row if no index
Now PlayingHome/long Play; Options → Queue → Audio InfoRestore invoking routeTrack contextOpen Music; sink/source recovery hint
QueueHome/Now Playing; ordered occurrencesRestore invoking routePlay Now → Remove → Move Up → Move Down → Clear FutureOpen Music
Track InformationTrack context; Title → Artist → Album → File → Codec → Rate → Duration → SourceFocused trackEach fact opens Value DetailBack / track unavailable
Track contextFocused track; Play → Play Next → Add to Queue → Album → Artist → Information → optional Letter IndexClose, restore track focusWheel trappedCloses when its catalog indexes become invalid
Collection contextAlbum/Artist Play All; Play → Shuffle → Play Next → Add to Queue → optional Audio InfoCloseWheel trappedNo playable tracks: no playback request
Queue contextQueue occurrence ID; Play Now → Remove → Move Up → Move Down → Clear FutureCloseFuture moves only; Clear Future confirmationVanished occurrence closes menu
ConnectivityHome/Settings; Wi-Fi → Bluetooth → PC Transfer → Quick SettingsParentNoneExplicit unavailable radio summaries
Quick SettingsConnectivity; Wi-Fi → Bluetooth → Output → Display → System SettingsConnectivityNoneUnavailable service facts/guarded effects
Wi-FiConnectivity/Quick Settings; Power → Scan → saved networks → other networks → Disconnect → Details → error detailInvoking parentSaved network: Connect → Forget → Disconnect → DetailsUnsupported security disabled; unavailable adapter controls skipped
Wi-Fi PasswordUnsaved secured network; circular characters → Delete → Connect → CancelCancel and clear secretLong Select submits valid passphraseInvalid length never submits; typed content not drawn
Wi-Fi network contextSaved networkCloseForget confirmationMissing service failure remains visible
BluetoothConnectivity/Quick Settings; Power → Scan → Wired Output → devices → Codec/Audio Details → error detailInvoking parentPeer: Pair/Connect/Disconnect → Use for Audio → Forget → DetailsDisabled radio controls; Wired Output and details remain reachable
Bluetooth pairingAsync request over current view; Confirm → Cancel; starts at CancelReject and restore backgroundGlobals remain availableTimed-out request disappears with service observation
Codec PreferenceBluetooth Audio; Preference → SBC → Auto → Stop Playback → Active Codec/PCM → RefreshBluetooth AudioNo codec inferred from preferenceAuto/no eligible codec disabled; apply only stopped/connected
SettingsHome; Audio → Playback → Library → Connectivity → Storage → Display → Power → SystemHomeNoneStatic hierarchy
Audio SettingsSettings/Quick output; Output → ReplayGain → Audio InfoParentSelect cycles actual supported valuesNo fake gain/filter/EQ toggles
Playback SettingsSettings; Shuffle → Repeat → Gapless → CrossfadeSettingsSelect cycles stored settingsExisting playback model only
Library SettingsSettings; Internal → SD → Scan → Rebuild → Scan StatusSettingsRebuild opens distinct owner-maintenance scopeScan status explains partial/failure and retained rows
DisplaySettings/Quick; Screen TimeoutParentSelect cycles 15/30/60/120/offNo unimplemented brightness/theme
PowerSettings; Battery/Source → Power MenuSettingsPhysical long Power also opens menuNo battery percentage
SystemSettings/Quick; About → Update → Backup → Maintenance → Date/Time → DiagnosticsParentNoneStatic hierarchy
AboutSystem; Reborn → Y2Linux → Kernel → Output → Build Information → RefreshSystemSelect fact: full valueMissing observation explicitly unavailable
Build InformationAbout; release/build/output/compiled IDs/rootfs facts → RefreshAboutSelect fact: full valueNo guessed repository/package identity
StorageSettings/Library/Diagnostics/USB; internal state/capacity/fs → SD state/capacity/fs if mounted → root state/capacity/fs → RefreshInvoking parentFacts open detailsMissing SD collapses unused capacity rows; low space guidance
Power & BatteryPower/Diagnostics/Thermal; unavailable SOC explanation → actual supply/charging/voltage/source → low-battery policy → RefreshParentFacts open detailsCurrent/pack temperature explicitly unavailable
Date & TimeSystem; trust → sync source → timestamp only when valid → RefreshSystemFacts open detailsUntrusted clock guidance
PC TransferConnectivity/Backup/Diagnostics; protocol → cable → readiness → address → authentication → activity availability → Wi-Fi exclusion → storage → RefreshParentFacts open detailsDisconnected/unavailable states retained
Software UpdateSystem; release → state → Check → Stage → Install → available release → network → cancel → rollback → result → details → RefreshSystemInstall/cancel/rollback confirmationActions depend on capabilities, journal and operation state
Update DetailsUpdate/Diagnostics; journal/download/signature/result/scope/key/sequence/rollback facts and admitted actions → result → RefreshParentSame confirmation rulesAbsent key/progress remain unavailable
Install preparationConfirmed root apply/restoreTemporarily blockedNavigation/power/transport conflict suppression; wake/volume permittedFailure unlocks route; platform owns restart
Backup & ExportSystem/maintenance; purpose → included → excluded → Create Export → Result → PC Transfer → RefreshParentSafe platform exportNo archive path until actual completion
Reset & MaintenanceSystem; Settings → Network → Bonds → Library → Cache → Full User DataSystemNo destructive one-click effectsRequires authenticated USB stopped-service maintenance
Each reset scopeMaintenance/Library; owner requirement → exact scope → plan command → digest workflow → consequences → Backup → PC TransferParentFull user scope explains music removal separatelyNo false reset-success button
DiagnosticsSystem; Health → Result → Capabilities → CPU/Memory → Thermal/Power → Storage → Network → Bluetooth → Audio → USB → Update → Boot/Services → ChecksSystemNoneObservations remain explicitly unavailable
Platform HealthDiagnostics; overall → Refresh Health → observed subsystem checks → RefreshDiagnosticsSelect opens state/reasonQualification pending is not failure
CapabilitiesDiagnostics; observed capability rows → precision/codec/rate details → RefreshDiagnosticsSelect opens implemented/enabled/qualified summaryUnknown schema rejected upstream
CPU & MemoryDiagnostics; online/load/memory → frequency/governor → RSS/PSS → cache/slab → RefreshDiagnosticsSelect factNo invented utilization/residency
Thermal & PowerDiagnostics; sensor explanation → die zones → cooling → Battery/Source → RefreshDiagnosticsSelect factNever labels die temperature as battery
Network DetailsWi-Fi/Diagnostics; readiness/reason/IP/route/DNS/signal/RX/TX → passive Network Check → RefreshParentSelect factNo fabricated Online or credentials
Bluetooth AudioBluetooth/Diagnostics; peer → active codec → observed PCM format/rate/channels → preference → codec policy → adapter/trust/reconnect → RefreshParentCodec preference childNo active codec without observation
Audio InformationNow Playing/Audio/Diagnostics; source → decode/process → RG/EQ/crossfade → selected output → observed sink → hw params → RefreshParentSelect factInactive sink labeled last opened
Boot & ServicesDiagnostics; boot IDs/clean state/stage/reset cause/taint → observed readiness → RefreshDiagnosticsSelect factUnknown reset cause remains unknown
Advanced ChecksDiagnostics; Result → Health → Network → Storage Benchmark → Library Benchmark → RefreshDiagnosticsBenchmarks require confirmationBusy/capability gates skip disabled controls
Operation ResultUpdate/Backup/Diagnostics/Checks; actual result/error → available export/checksum/benchmark metrics → RefreshParentSelect factExplicit no completed operation; no fake progress
Value DetailAny fact; wrapped text → BackSame fact and scroll positionNo extra contextBounded text with ellipsis; unavailable is readable
Power MenuLong Power/Power Settings; Off → Restart → Cancel; starts at CancelCloseOff/Restart then confirmationNo recovery/partition controls
ConfirmationInvoking context; Cancel → Confirm; starts at CancelCloseFocus trapped, live admission recheckedInvalidated Confirm disabled
Notice / volume indicationNoninteractive top overlay; no focus targetUnderlying routeExpires with one final dirty redrawNever replaces persistent error/result authority
Screen off / wakeActual platform panel blank; retained route on wakeNavigation ignored while offPlayback/volume global under router; Power wakesNo persistent decorative lock view

The physical focus test is automated over every normal screen and platform page, with empty/populated variants. Every enabled row is reached deterministically by wheel-only traversal and Back returns to a parent/root. Hardware input timing, legibility and physical focus visibility require owner qualification.

Published by the SchulzCode/Y2Reborn project [1] [3]