Labstream

Labstream is a native Apple-platform media client for a Plex Media Server, Jellyfin server, or Emby server that you administer or are authorized to access. It connects to the server you choose; the app does not bundle or sell media. A separate optional project-operated review/demo service hosts licensed sample content; see the Privacy Policy.

The repository contains four coordinated pre-release targets: Apple Vision Pro, one universal iPhone/iPad target, a streaming-only Apple TV target, and a native Mac target. Labstream is available as public source for local builds. The repository records invitation-only internal TestFlight binaries, but there is no public App Store release. The release and App Store status page is the single source of truth for the current source version, processed binaries, platform gates, and submission readiness.

Labstream does not automatically upload app analytics or diagnostic reports. If you select the project-operated review/demo server, it receives normal server requests and retains operational records separately from app diagnostics. A diagnostic report leaves the device only after you explicitly copy, export, share, or open a bug report.

flowchart TD
  accTitle: Labstream service topology
  accDescr: Labstream has pre-release targets for Apple Vision Pro, iPhone, iPad, Apple TV, and Mac; it connects directly to a user-selected Plex, Jellyfin, or Emby server, including the optional project-operated Jellyfin demo with retained operational records, and makes a diagnostic report available only after the user chooses to copy, export, or share it.
  Spatial[Apple Vision Pro] --> App[Labstream]
  Mobile[iPhone / iPad] --> App
  TV[Apple TV] --> App
  Mac[Mac] --> App
  App --> Plex[Plex Media Server]
  App --> Jellyfin[Jellyfin server]
  App --> Emby[Emby server]
  App --> Demo[Optional project-operated Jellyfin demo]
  Demo --> Records[Server records, logs and backups]
  App --> Report[User-initiated diagnostic report]
  Report --> Destination[Destination chosen by user]
  Destination --> Issue[Optional GitHub bug report]

Choose a path

Users

• Support and troubleshooting — requirements, sign-in, playback, and diagnostics.
• Report a bug — reproducible steps and the redacted report workflow.
• Privacy policy — local storage, server communication, and user-initiated reports.
• Release and App Store status — current source version, processed builds, and open acceptance gates.

Contributors

• Contributing — workflow, architecture boundaries, documentation lanes, and privacy rules.
• Development setup — platform builds, exact-product smoke checks, and cleanup.
• Testing strategy — native matrix, hosted tests, evidence tiers, and physical-device gates.
• Agent playback troubleshooting — bounded playback fixtures, admitted live scenarios, and evidence interpretation.
• Manual validation checklist — the repository's current cross-platform acceptance matrix.

Platform and architecture readers

• iOS and iPadOS target, tvOS target, and macOS target.
• Architecture overview, code map, and backend model.
• Playback, downloads and offline, music, persistence, and system integration.
• Diagnostics and privacy and App Store screenshot automation.

Project policies

• Security policy — private vulnerability reporting.
• Code of conduct.
• GPLv3 App Store additional permission.

What this site contains

These pages describe the current source tree: how to build it, how to report problems safely, and how the major subsystems fit together. Repository-internal material stays outside the published navigation in explicit lanes: active plans under docs/plans/, unresolved investigations under docs/research/, immutable observations under docs/evidence/, and completed or superseded context under docs/archive/. The repository-root manual checklist remains a deliberate operational exception and is linked above from GitHub.

Repository

Source lives at github.com/jlipworth/Labstream.