OPEN SOURCE. SHARED SOUND.

Good music.
Everyone gets
a turn.

Turn Spotify into a jukebox for the whole room. Request a song, vote for a favourite, and let a fair queue keep the soundtrack moving.

Try the demo ↗View on GitHub ↗

Run locally with Node.js and SQLite.
No Azure account required.

INTERFACE PREVIEW

UP NEXT

Your next favourite.

Requested by someone in the room

02A little discoveryAnother guest. Another good song.
03One more for the mixFair queueing gives everyone a turn.
Spotify-poweredMIT licensedLocal or cloudOne room. A shared queue.

LESS PASSING THE PHONE. MORE PLAYING THE ROOM.

A little democracy.
A lot of good music.

vibeQ brings requests and voting into one browser-based Spotify player. The host links an account; guests help shape what comes next.

Find it. Add it.

Search songs and artists with live dropdown results, album art, and keyboard navigation. Add a request directly to the room’s queue.

Votes with balance.

Votes lift favourites while recent requests and plays count toward each guest’s fair share. One person’s long list doesn’t get every turn.

The host stays in control.

Password-protected host controls manage playback, volume, devices, and pending requests. Guests can request and vote without a host password.

FROM A REQUEST TO THE NEXT TRACK

One account.
A room full of taste.

  1. 01

    The host connects Spotify.

    Link an eligible Spotify Premium account and start Spotify on a playback device. The host’s device plays the audio.

  2. 02

    Everyone joins the mix.

    Guests open the player, search, request, and vote. They use the host’s connection rather than signing into separate Spotify accounts.

  3. 03

    The fair queue takes over.

    A background worker sends upcoming requests to Spotify. Closing a guest’s tab doesn’t stop the worker or the host’s Spotify device.

MAKE THE EXPERIENCE YOURS

Keep the good nights.
Go beyond the queue.

Start with the Spotify player, then choose the optional extras you want. The demo enables archives; AI features need your own compatible provider settings.

OPTIONAL · NO AI REQUIRED

Session archives

Save completed requested tracks as a named session. Revisit the night, copy Spotify track URIs, or send a saved session back into the fair queue.

OPTIONAL · AI PROVIDER REQUIRED

Original AI artwork

Add a visual interpretation inspired by a track, displayed separately from its Spotify album art. Generated images are cached for reuse.

OPTIONAL · AI PROVIDER REQUIRED

Behind-the-music trivia

Bring context into the room with web-researched trivia and clickable sources. Source links help you explore and check the generated information.

YOUR MACHINE. YOUR ROOM.

Run it locally.
Host it your way.

The player runs on Node.js and SQLite without Azure Functions, Docker, or a cloud account. Spotify access still requires an internet connection.

Read the complete setup guide ↗
LOCAL QUICK START
git clone https://github.com/vibeQ-player/v1.git
cd v1
npm ci
cp .env.example .env
# Configure Spotify and host credentials
npm run dev

Use Node.js 22.13+ and your own Spotify developer app. On Windows, use Copy-Item .env.example .env. The README explains secret generation, redirect URLs, and connecting playback.

READY FOR A SHARED LINK?

An Azure path, too.

The same application can use Azure Static Web Apps, Functions, and Cosmos DB. Deployment scripts and Microsoft documentation are linked in the repository. Azure resources and AI providers may incur charges.

Deployment guide ↗

BEFORE YOU PRESS PLAY

A few useful answers.

Do guests need Spotify accounts?

No. Guests search, request, and vote through the host’s Spotify connection. The host needs an eligible Premium account and access to the configured developer app.

Does vibeQ play audio in the browser?

Normally, vibeQ controls a Spotify Connect device such as the desktop app. Browser audio is an optional Spotify Web Playback SDK feature that the host must enable and configure. Closing that browser-player tab stops that playback device.

Can I run vibeQ without Azure?

Yes. The local Node.js server uses SQLite and runs its own background workers. Azure is an optional hosting route, not a dependency for local users.

How does the queue stay fair?

Requests are scored using votes and each guest’s recent queue/play history. Lower scores play first. Votes reorder pending requests; tracks already sent to Spotify keep their order. Guest IDs are browser-based, so this is fairness for a shared room rather than a strong identity system.

Are artwork and trivia included in the demo?

The code includes both as optional add-ons, but this demo leaves them disabled. Enable them with supported models and your own provider credentials. AI calls can incur charges, and generated trivia can contain mistakes even when sources are linked.

Is this an official Spotify app?

No. vibeQ is an independent, MIT-licensed project. Spotify’s account, developer-app, and playback restrictions apply. A public demo does not automatically grant every host account permission to connect to a development-mode Spotify app. Read Spotify’s quota-mode guidance ↗

What does the green “Spotify linked” light mean?

It means a host account has been linked to the room. It does not mean audio is playing. The player’s Now playing card shows playback and device status.

THE NEXT FAVOURITE COULD BE YOURS.

Give the room
its soundtrack.

Open the demo ↗Build your own ↗

The public demo shares one host connection and queue. Playback depends on the host’s active Spotify device.