play-list

A feature rich API to manage song playlists and queues in specific and detailed ways.

I want to be able to do things like

• add a shuffled playlist to the queue
• add two playlists to queue with their songs interleaved
• reorder entire playlists within the queue
• convert the current queue to a playlist
• flatten the playlists in the queue
• shuffle the queue
  • keeping enqueued playlist order intact
  • deep shuffling playlists and their position
  • specify the type of shuffling
    • true random
    • psuedo-random
• saved queues
• multiple queues
• repeating queues
  • infinite repeat
  • finite repeat
  • shuffle queue on repeat

These features aren't normally available in music players and I want them to be.

Vision

I want to provide a standardized API and classes for interacting with playlists/queues/songs.

Eventually I'd like to be able to add songs from different services and have them play in their respective players (e.g. one playlist from Spotiy, one from YouTube Music).

Workspace Structure

• workspace
  • packages
    • api
    • types
  • apps
    • cli
    • server
    • web

Tech Stack

• Typescript
• Valibot
• cli
  • Bun
  • Commander
  • Chalk
• web
  • TanStack Start
    • React
    • SWR
  • Drizzle ORM
• server
  • Express
  • Postgres