Features and Platforms

Features and Platforms

A Playa Named Gus targets iOS, iPadOS, tvOS, visionOS, and macOS from a single SwiftUI app target, plus a watchOS companion (GusWatch).

Core Features

Area	Status
Manual server connect	Implemented
User-initiated local server discovery	Implemented
Username/password sign-in	Implemented
Quick Connect	Implemented
Multi-server and multi-user switching	Implemented
Home sections	Implemented
Library browsing with pagination	Implemented
Global search	Implemented
Item detail metadata	Implemented
Series, seasons, episodes	Implemented
AVKit video playback	Implemented (direct play at original quality where hardware supports it; HEVC-preferred HLS fallback)
Playback progress reporting	Implemented (pause/resume report immediately)
Audio and subtitle track selection	Implemented (instant in-place switching on direct-played files)
Streaming quality and auto-play settings	Implemented (Settings → Playback)
Chapters, next-up prompt, and episode auto-play	Implemented
Now Playing metadata	Implemented, device verification still matters
AirPlay and PiP surfaces	Implemented where supported, manual verification still matters
Music and audiobook playback	Implemented (queue, shuffle/repeat, speed, chapters)
Photo library browsing	Implemented
Live TV / DVR	Implemented
Books (EPUB reading on iOS/iPadOS)	Implemented
Offline downloads	Implemented on non-tvOS platforms
Customizable main navigation	Implemented
Deep links, Handoff, Spotlight, Siri/App Intents	Implemented
Content-aware tvOS Top Shelf	Implemented
CarPlay audio surface	Implemented, gated on the carplay-audio entitlement
Family-safety content gating	Implemented
SyncPlay / remote sessions	Implemented, Jellyfin-gated
watchOS companion	Implemented (on-device verification matrix pending)
visionOS Gus Cinema	Implemented
visionOS spatial/stereo playback	Implemented with direct-play requirements and graceful fallback

Platform Notes

iOS and iPadOS

• Native SwiftUI navigation and system controls.
• Background-capable downloads.
• AVKit playback, PiP/AirPlay surfaces, and Now Playing integration where supported.
• In-app EPUB reading via Readium (iOS/iPadOS only).
• CarPlay audio templates (inert until the carplay-audio entitlement is granted).
• Handoff, Core Spotlight, and Siri/App Intents integration.
• Dynamic Type and VoiceOver are part of the acceptance bar.

tvOS

• Native focus-driven layout.
• AVPlayerViewController playback surface.
• Content-aware Top Shelf surfacing Continue Watching plus Home/Search/Settings routes.
• Offline downloads are intentionally unavailable.

visionOS

• Split navigation and glass presentation surfaces.
• Gus Cinema immersive space.
• MV-HEVC spatial playback through AVKit direct play.
• SBS/TAB frame-packed playback through the RealityKit stereo screen.
• MVC and unavailable direct play fall back to 2D.

macOS

• Native split navigation.
• Menu commands and keyboard shortcuts.
• Downloads and AVKit playback.
• Video opens in a dedicated resizable player window (green-button fullscreen) rather than a sheet.
• Window sizing and sidebar state restoration.

watchOS (companion)

• Ships inside the iOS app archive (no separate store record) and is standalone-capable.
• Session status glance, Sessions-API remote control with live WebSocket updates and polling fallback.
• Quick resume to a chosen client, lightweight per-library browse.
• On-watch audio through the shared audio engine, with offline audio downloads under a watch-specific budget.
• Constrained on-watch video, standalone Quick Connect sign-in, and WatchConnectivity credential hand-off from the iPhone.

Unsupported or Deferred

• Expanded immersive environments for Gus Cinema are future work.
• An Apple Intelligence library assistant / generated artwork is future work.
• MVC 3D decoding is unsupported because Apple platforms do not provide a usable decoder.
• Offline subtitle sidecar downloads are not in the current download scope.
• Additional media-server backends (e.g. Emby) are deliberately out of the 1.0 scope; the provider boundary keeps the path open.