Skip to content

Album/Track search #14

@boldandbrad

Description

@boldandbrad

Describe the problem
Users often can't remember exact track or album names, making CLI input tedious or impossible for long/cryptic titles. There's no interactive way to search last.fm directly within spin.

Describe the solution you'd like
Add a TUI mode search command that allows users to interactively search last.fm for albums and tracks using a fuzzy-finding algorithm as they type. From the search results, users can:

  • Select a track/album to begin the relevant scrobble flow (TUI mode)
  • Add it as a favorite (requires Favorites #7 - Favorites)

Example:

spin search
[search input field with live results below]
> Comfortably Numb
  Pink Floyd - Comfortably Numb (track)
  Pink Floyd - The Wall (album)
  Numb - Linkin Park (track)
  
  [select with arrow keys, enter to confirm]

Describe alternatives you've considered

  • Typing out full names manually (error-prone for long/cryptic titles)
  • Leaving the terminal to search last.fm in a browser, then returning to scrobble
  • Using --exact-match flags if they existed (they don’t)

Additional context/considerations

  • This feature depends on Favorites #7 (Favorites) being implemented first, as users should be able to save search results as favorites
  • Consider debouncing API calls to avoid rate limiting. If rate limits are still a concern or if the last.fm api doesn’t provide an elegant way to implement this. We may need to look into integrating with Discogs or other data providers.
  • Fuzzy matching should prioritize relevance over simple substring matching
  • Should support both album and track search with optional flag (--album, --track) or unified results

Metadata

Metadata

Assignees

No one assigned

    Labels

    newRecently submitted issue

    Projects

    Status

    Backlog

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions