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,
    TrackReady(QueueItemId),
    TrackStreamReady(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).

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.

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.