advanceTo: Move a VIDEO queue to another item because playback moved there: the next one when an item ends, or the player's next / previous. The queue ARRIVES at that item, so it starts from the beginning on the viewer's explicit version pick (nodeHelpers.startFresh): a position saved on it belongs to an earlier session, and the viewer is watching in order. Resume is the Resume button's job; jellyfin-web's nextTrack also plays with no start position. Without this only a multi-version item resumed (its version chooser reads positions) while every other item started at 0.

Not an arrival: the item behind a Cinema Mode intro (followsIntro), which is the one the viewer launched, and Live TV, which has no position to start from.

Audio moves with moveForward / moveBack / setPosition and is untouched.

Opens the wait for a playback start (appWaits, LoadingKind.PLAYBACK_START) and holds it until the player that mounts for it takes it (takePlaybackStart). Every start passes through here (the launchers below, the details screen, a channel switch), so the spinner, its stages and its label are the same for all of them. A start pressed while another is pending replaces it.

Stop, unobserve, and drop the in-flight QuickPlayTask if one exists. Safe to call when none is active. The single teardown path for m.activeQuickPlayTask (reused by onQuickPlayTaskOutput).

The single teardown path for m.shuffleTask. Safe to call when none is active.

Clear all content from play queue

A QuickPlayTask found nothing to play. A playback start fails; a photo-album run, which has no start and uses the plain spinner (launchPhotoAlbum), stops that spinner. Then the viewer is told why (showNothingToPlay).

Ends the pending start, which will not reach a player (reason, for the log).

Return the number of items in the play queue

Return the item currently in focus from the play queue

Return whether or not shuffle is enabled

Return the item in the passed index from the play queue

getItemType: Returns the media type of the passed item

Returns current playback position within the queue

Return the current play queue

Return the types of items in current play queue

Return the unique types of items in current play queue

Return original, unshuffled queue

getVersionPreference: The explicit version pick for this queue, or invalid when there is none.

insertAfterCurrent: Put an item directly after the one playing, so the queue reaches it next.

The Cinema Mode intro queues the item it plays in front of. Appending that copy to the END plays the rest of the queue first: measured 2026-09-19 on 10.11, a Play All queue became [e1, e2, e3, e4, e1] and the intro was followed by e2, with e1 played last. With one item queued (every other intro path), the end IS the next slot, which is why it went unnoticed.

Return isPrerollActive status

Single-tap playback launcher. Routed views (Home rows / library grids / search / details extras) call this directly. Synchronous types build the queue inline via the quickplay.* helpers + playQueue (which routes to PlayerHostView); async types (need an API call to expand into a queue) go through QuickPlayTask.

Launch a PhotoAlbum slideshow. isRandom = true is the Shuffle button (random slideshow); false is the Slideshow button (sequential). Sets the shuffle mode the onQuickPlayTaskOutput photo branch reads, then runs the loadPhotoAlbum task.

Start playback of an async action (the details screen's Play all / trailer / instant mix, and their deep links): opens its playback start, then runs the QuickPlayTask.

Shuffle-play a Series / Season / Person via GetShuffleItemsTask (the API resolves the randomized item set off the render thread). Owns the task on this node. PhotoAlbum shuffle does not come here: it launches a random slideshow through launchPhotoAlbum instead.

Move queue position back one

Move queue position ahead one

A start ended. One that failed before any player took it (the viewer left the screen it was pressed on, or its time limit ran out) stops the queue build still working for it, so playback does not begin on whatever screen the viewer went to. Both builds only read, so stopping them loses nothing.

QuickPlayTask finished: build the queue from its output and play (ported from main.bs's handleQuickPlayOutput). Photo output routes the slideshow to the /photo view through m.global.photoLaunchRequest.

GetShuffleItemsTask finished: set the resolved items as the queue and play. The task already randomizes server-side; toggleShuffle applies the Fisher-Yates client shuffle on top when there's more than one item.

Play items in queue.

QueueManager has no router chain, so it can't navigateTo. It sets m.global.playbackLaunchRequest and JRScene.onPlaybackLaunchRequested turns that into the route: audio -> /audio (AudioPlayerView), every video-family type -> the play route (/details/:type/:id/play, PlayerHostView). The view reads this same queue on mount. In-view queue advancement (next-item / Live TV restart / channel switch) does not come back through here: the video host remounts its child; the audio view reloads in place.

Push new items to the play queue

Reset queue items back to original, unshuffled order

Reset shuffle to off state

Run a QuickPlayTask for an async action and route its output to the queue. Used by launchQuickPlayAction, launchItem's async branch (item taps that expand into a queue) and the photo-album slideshow. Owns the task on this node's render thread. Clears the queue up front so the QuickPlayTask output (which appends via pushToQueue / set) starts from empty.

Replace play queue with passed array

Set starting point for the current item in the queue

before a reload), false for a saved resume position (see nodeHelpers.setExactStart / setResumeStart)

Set the queue position

Set prerollActive status

setVersionPreference: Record an explicit version pick for the rest of this queue: the details screen's Video menu at launch, or a switch in the player. invalid forgets it.

Tells the viewer that a launch found nothing to play: try again when a read failed, nothing there when every read answered, can't when nothing here builds it (quickplayOutcome). Only a build whose output arrived gets here, and that means the viewer still waits on it. Back, leaving the screen and a start's time limit end the start, which stops the Task (onPlaybackStartEnded); a newer press of the same launcher stops its own Task first (runQuickPlayAction, launchShuffle); and a slideshow's plain spinner holds the remote until it ends. So none of those ever shows a message.

Save a copy of the original queue and randomize order of queue items

startCurrentFresh: Start the current item from the beginning: the first item of a queue the viewer did not launch to resume, such as Play All or shuffle.

startFresh: nodeHelpers.startFresh for anything with a position to start from, not Live TV.

Hands the pending start to the player mounting for it, which ends it from then on (on its stream, a failure, or teardown). invalid when none is pending: a queue advance or a Live TV restart remounts the player without one.

Toggle shuffleEnabled state