Search and Play

Search is navigation in spotuify: local cache when possible, Spotify when needed, and pipeable IDs for everything else.

Search the catalog

spotuify search "burial archangel" --type track

What you get: a ranked table of tracks, episodes, shows/podcasts, albums, artists, or playlists depending on --type.

Search in the TUI is grouped by media kind so tracks, artists, albums, playlists, podcasts, and episodes do not collapse into one undifferentiated list.

The selection preview shows artwork for albums, playlists, shows, and episodes when the selected row has an image URL.

spotuify search "design matters" --type show

Pick the source

spotuify search "quiet storm" --source local --format jsonl
spotuify search "quiet storm" --source spotify --format jsonl
spotuify search "quiet storm" --source hybrid --format jsonl

Use local when you want cached library/search results only. Use spotify when discovery matters. hybrid is the normal default.

spotuify search "quiet storm" --source hybrid --format jsonl

Play a result directly

spotuify search "luther vandross" --type track --play --index 1

The index is 1-based. Keep it visible in scripts:

spotuify search "luther vandross" --type track --limit 5

Pipe IDs

spotuify search "luther vandross" --type track --format ids \
  | head -n 1 \
  | xargs spotuify play-uri

What you get: one stable Spotify URI per line. That is the easiest format for fzf, xargs, and agents.

spotuify search "luther vandross" --type track --format ids

Queue from search

spotuify queue add --search "never too much"

Or queue many:

spotuify search "luther vandross" --type track --format ids \
  | spotuify queue add --format json

In the TUI, press e on a track, playlist, or album. Tracks append directly; playlists and albums expand to their tracks and append without wiping the existing queue.

spotuify queue

In real life

Coding and you need energy:

spotuify play "upbeat focus playlist" --type playlist

You remember a song title badly:

spotuify search "that one song about homecoming" --type track --source spotify

You want only your cache:

spotuify search "joni" --source local --format jsonl