Enum PlayerCommand 

pub enum PlayerCommand {
    Play(QueueItemId),
    Pause,
    Resume,
    Stop,
    Seek(u64),
    NextTrack,
    PrevTrack,
    AddToPlaylist(Vec<PlaylistItem>),
    RemoveFromPlaylist(QueueItemId),
    RemoveFromPlaylistBatch(Vec<QueueItemId>),
    MoveInPlaylist {
        id: QueueItemId,
        target: QueueItemId,
        after: bool,
    },
    MoveItemsInPlaylist {
        ids: Vec<QueueItemId>,
        target: QueueItemId,
        after: bool,
    },
    UpdatePaths(Vec<(QueueItemId, PathBuf)>),
    InsertInPlaylist {
        items: Vec<PlaylistItem>,
        after: QueueItemId,
    },
    ClearPlaylist,
    ReplacePlaylist {
        items: Vec<PlaylistItem>,
        start: usize,
    },
    TrackReady(QueueItemId),
    TrackStreamReady(QueueItemId),
    TrackFailed(QueueItemId),
    DecodeFinished,
    Undo,
    Redo,
    BeginUndoBatch,
    EndUndoBatch,
    SetOutputDevice(String),
    ClearOutputDevice,
}

Commands from the UI layer to the audio engine.

Variants

Play(QueueItemId)

Set cursor + start playback. Replaces Play/SkipTo/SkipBack/PlayInterrupt.

Pause

Resume

Stop

Seek(u64)

NextTrack

PrevTrack

AddToPlaylist(Vec<PlaylistItem>)

RemoveFromPlaylist(QueueItemId)

RemoveFromPlaylistBatch(Vec<QueueItemId>)

Batch remove: delete multiple items as a single undoable operation.

MoveInPlaylist

Fields

id: QueueItemId

target: QueueItemId

after: bool

MoveItemsInPlaylist

Batch move: extract ids and reinsert them at target position.

Fields

ids: Vec<QueueItemId>

target: QueueItemId

after: bool

UpdatePaths(Vec<(QueueItemId, PathBuf)>)

Update file paths for playlist items after an organize operation. On Unix, rename() doesn’t invalidate open FDs so playback continues.

InsertInPlaylist

Insert items after a specific queue item (for drag/drop at cursor position).

Fields

items: Vec<PlaylistItem>

after: QueueItemId

ClearPlaylist

Clear the entire playlist (stop + remove all items).

ReplacePlaylist

Replace the playlist and start playing at start, as one operation.

Doing this as ClearPlaylist + AddToPlaylist + Play sends three commands down a bounded channel, and the player acts on each as it arrives: the first track starts, then the cursor jumps. Clicking track nine of an album visibly flashed track one as playing first. It is also three undo entries for one user action.

start past the end starts at the beginning.

Fields

items: Vec<PlaylistItem>

start: usize

TrackReady(QueueItemId)

Download complete — check if cursor is waiting on this item.

TrackStreamReady(QueueItemId)

Enough data buffered for streaming playback — check if cursor is waiting.

TrackFailed(QueueItemId)

Download failed — a cursor parked on this item must stop waiting.

Without it the player sits on a Pending item forever: Ready is the only thing it listens for, and a track that cannot be fetched never becomes Ready. That is the offline-library stall.

DecodeFinished

Decode thread exhausted the playlist — auto-advance or stop.

Undo

Undo the last reversible playlist operation.

Redo

Redo the last undone operation.

BeginUndoBatch

Begin collecting undo entries into a single batch (e.g. drag operations).

EndUndoBatch

End the batch — collapse collected entries into one undo step.

SetOutputDevice(String)

Switch output audio device by name. Restarts engine on current track.

ClearOutputDevice

Clear the configured output device, reverting to system default.

Trait Implementations

impl Debug for PlayerCommand

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.