1. Overview

The Dynamic Queue in SonicSyncSail is a real-time, editable playback queue that adapts to the selected listening mode: Music Mode, Radio Mode, or Pulse Sync Mode. It allows users to reorder, remove, and manage upcoming items, ensuring full control over playback flow.

While Music and Radio mode share the same interaction model, Pulse Sync Mode uses an internally generated queue controlled by the Pulse Mixer and offers minimal user interaction.

2. Accessing the Dynamic Queue

Users can access the dynamic queue from the Now Playing screen. In Music Mode and Radio Mode, a button labeled UpNext opens the queue. The queue appears as a scrollable list representing the current playback order.

Pulse Sync Mode also offers a button labeled Pulse Mixer opens the PulseMixer, that handles the dynamic queue internally.

3. Top Bar Actions

3.1 Focus Icon

Tapping the focus icon automatically scrolls the queue to the currently playing item. This ensures users can quickly locate their position in long or constantly changing queues.

3.2 Clear Queue Icon

Pressing the clear queue icon displays a confirmation dialog. If confirmed:

• All items are removed instantly
• Playback stops immediately
• The queue resets to an empty state

4. Item-Level Actions

4.1 Swipe to Remove

Users can remove individual items from the queue by swiping right-to-left on the desired item. The deletion occurs instantly and playback order updates immediately.

4.2 Drag-and-Drop Reordering

Each queue item includes a drag handle. Users can press and drag items to reorder them. The new order takes effect instantly in the playback engine without requiring a restart.

5. Queue Behavior by Mode

5.1 Music Mode

Music Mode offers the most flexible dynamic queue. Users may reorder items, remove songs, or append new content without restrictions. There is no limit on the number of items the queue can hold.

When shuffle is off, the queue plays strictly in the user’s defined order. When shuffle is enabled, playback uses the shuffle algorithm until the mode is turned off, after which the queue reverts to the user’s ordering.

5.2 Radio Mode

Radio Mode simulates a flowing broadcast. The dynamic queue in this mode has a strict limit of:

→ 50 items maximum

When users add new radio items and the queue is already full:

• The new item is appended to the end of the queue
• The first (oldest) item is removed automatically

This ensures the queue remains fresh, evolving, and within the fixed capacity limit. All item actions (swipe, reorder, focus, clear) function normally in Radio Mode.

5.3 Pulse Sync Mode

Pulse Sync Mode uses a queue generated internally by the Pulse Mixer. Because the mix is algorithmically built, the user cannot modify its order or contents. Thus:

• No reordering allowed
• No swipe-to-remove
• No drag-and-drop
• No item-level editing permitted

The only available action in Pulse Sync Mode is: Clear Queue.

Clearing also stops playback, exactly as in Music or Radio modes.

6. Playback Rules

• The queue always reflects live playback order.
• Removing an item adjusts the sequence immediately.
• Dragging to reorder updates playback in real time.
• When the queue becomes empty, playback stops.
• Shuffle mode temporarily overrides queue ordering.
• Turning shuffle off restores the user’s arrangement.

7. Edge Cases & Special Rules

• In Radio Mode, adding items beyond capacity triggers automatic FIFO removal.
• In Pulse Sync mode, queue is protected from modification.
• Clearing queue always terminates playback.
• Focus action always scrolls to currently playing item, regardless of mode.
• Queue respects Music or Radio mode behaviors even if user switches modes mid-session.

8. Known Limitations

• No undo/redo support for queue modifications.
• Radio queue FIFO removal cannot be disabled.
• Pulse Sync queue cannot be manually edited.
• Mixed-mode queue states are reset when switching playback modes.