# VinylPlayer: how I turned a Spotify library into a shelf of records

> Agent mode of the VinylPlayer case study by Oussama, product designer. This file has more detail than the visual page (/work/vinylplayer on the same site): every decision, the features and the small details inside them, the limits, the process and the sources. Product facts were checked against the live app and its code on 10 November 2026.

## At a glance

| | |
|---|---|
| Product | VinylPlayer, a record player for your Spotify library |
| Live | https://vinylplayer.app |
| Role | Product designer and solo builder: research, UX, UI and code |
| Timeline | Two months, September to November 2026 |
| Platforms | Web is live. Mac, Windows and Linux apps are built and sent directly to people Oussama knows; public downloads wait on a developer account. Updates come through GitHub for now, and on a Mac you replace the app to update. |
| Languages | 13 (English first; a few screens, Settings among them, are still English only) |
| Status | Live and public. I haven't marketed it yet, so there are no usage numbers worth showing. |

## The short version

- **The observation:** many people go a year without a full album. The albums are right there on Spotify, but it keeps pulling you to something else.
- **The idea:** albums you play one side at a time. Pick a record from your Spotify albums, play side A, then flip it. It can sit on a second screen while you work.
- **Where it stands:** it changed how I listen. I play whole albums now. The app is public, but I haven't marketed it yet.

## Why I built it

For seven years I played whatever Spotify said was trending and moved on. Then I'd fall for an older song and find out it was on an album I thought I knew. I knew the hits the algorithm picked, never the albums they came from.

While I worked, I played music on my second screen, and all it ever showed was a Spotify window. I kept picturing a turntable there instead. So I built it: my Spotify albums on a shelf, and a record player on the screen beside me.

## Research

People still buy albums. Fewer play them to the end.

| Figure | What it says | Source | Kind |
|---|---|---|---|
| 41% | of UK adults hadn't played a full album start to finish in over a year; 8% never have | National Rail's Track Reset poll, 2,000 UK adults, reported by Mixmag, July 2026. No polling firm or question wording was published, so treat it as a rough sign. | Marketing poll |
| 45% | of Finns play complete albums on streaming at least occasionally, 6 points fewer than in 2020; 43% prefer their own playlists, 16% one song at a time | IFPI Finland and Teosto, *Music Listening in Finland 2024* (1,000+ people aged 13–75) | Survey |
| ~50% | of streamed songs aren't heard to the end; a quarter are skipped in the first five seconds | Spotify researchers, PLOS ONE, 2020, on Spotify data from 2014 and 2018 | Peer-reviewed study |
| $1.04B | US vinyl revenue at wholesale in 2025, up 9.3%; 46.8 million records; the 19th year of growth in a row | RIAA 2025 Year-End Revenue Report, March 2026 | Industry report |

I see this in people around me too. A friend I grew up with still sends me songs he's hearing for the first time, from albums we both know. We followed Travis Scott and Swae Lee for years, and still only played the hits.

You can play a whole album on Spotify, but Spotify keeps offering something else: Discover, radio, podcasts. If it's hard for you to stick to one thing, it's easy to drift away before the album ends.

**Takeaway:** in VinylPlayer you pick an album first, and the app doesn't offer you anything else while it plays.

Links:
- https://www.epressi.com/tiedotteet/musiikki-ja-viihde/music-listening-in-finland-2024-finns-prefer-to-listen-to-their-self-created-playlists-and-to-radio.html
- https://mixmag.net/read/40-percent-people-uk-have-not-listened-to-full-album-year-according-to-new-poll-news
- https://journals.plos.org/plosone/article?id=10.1371/journal.pone.0239418
- https://www.riaa.com/wp-content/uploads/2026/03/RIAA-Year-End-Revenue-2025.pdf

## Principles the product follows

1. It's just a player: you connect, you play. People put an album on and leave it alone while they work or make art.
2. Real objects, real data: real covers, real tracklists, real sides. Nothing fake presented as real.
3. Honest about limits: say what Spotify doesn't allow; never show a dead button.
4. Light on the machine: still when nothing moves; nothing animates off screen.
5. Flat, filled controls: no drop-shadow buttons, no hollow outline buttons.
6. Black and white: the app has no colour of its own. Colour comes from the records.

## Key decisions

Four choices, and what I gave up for each.

### 1. The music stops until you flip the record

- **What pulled against it:** Spotify has no sides. An album comes as one list of songs, with nothing saying where side A ended on the record.
- **What I chose:** VinylPlayer works out where side A ends from the song lengths, then waits for you to flip the record. On a real record, a side ends, the music stops, and you flip it by hand. I wanted to keep that moment. Flip waits in the player, on the album page and beside the dock. Albums with two discs work the same way: when one record ends, you put on the next (sides A to D). A single Spotify disc of an hour or more is pressed as two records, three past 105 minutes, with sides as even as the songs allow. If you'd rather not, turn off "Flip sides by hand" in Settings and the album plays straight through.
- **What I gave up:** music that never stops. Every side ends with a pause, and you have to press a button to carry on. Shuffle breaks the idea too: songs from both sides mix.
- **How I checked it:** I checked where the app splits an album against the real vinyl of 80 well-known albums. Some albums come on more than one disc, which makes 98 records. Track lengths and side information come from MusicBrainz, an open music database.
  - My current rule, picking the gap between songs that leaves the two sides closest in length: **82 of 98 records (84%)** started side B at the same point as the real vinyl.
  - My first rule, starting side B at the first song after the halfway point: **55 of 98 (56%)**.
  - When the app's rule missed, it was off by one song every time, so that side ends one song early or late.
- **Limits of the test:** I picked the albums, and MusicBrainz lengths can differ slightly from Spotify's. Each record of a multi-record pressing was tested on its own. Single-record albums alone: 53 of 63 (84%) with the current rule, 35 of 63 (56%) with the first rule.

### 2. The player shows the record, and little else

- **What pulled against it:** music players keep every control in reach: the song list, the settings, the bar at the bottom.
- **What I chose:** people put an album on and leave it alone while they work or make art, so I took away what they don't need while it plays. Settings moved to their own page. On the turntable, the control bar stays hidden until you reach for it. In full mode, when the player fills the screen, you can go forward and back, but the song list stays out. To jump inside a record, you hold the needle and drop it where you want. The choice of colour stayed on the player, because real records come in colours. Artists choose how their vinyl looks, and people keep a special red or orange copy of an album they love. Spotify can't tell me what an album's vinyl looks like, so the record starts in the cover's colour and you can change it. You don't have to drag: a button opens the hidden bar, the arrow keys move through the song, and ? lists every key.
- **What I gave up:** a song list always in view. In full mode there's no button for it. You have to leave, or know the T key.

### 3. Your library opens as a shelf

- **What pulled against it:** a grid shows more album covers at once and is familiar from other music apps.
- **What I chose:** the shelf opens first, because it feels more like a collection. The spines stand in a row, and the record you pick comes out in front. Two more views are one tap away: Stack, and Wall for people who want the grid.
- **What I gave up:** seeing many albums at once. On the shelf you mostly see spines, and only one cover.
- **Details:** the room takes its light from the record in front; spines carry the title, artist and year in ink tinted by each cover, fitted to stay readable at 4.5:1 contrast.

### 4. Spotify's sign-in limit became a setup step

- **What pulled against it:** Spotify lets a small app sign in only a few invited people. That would have kept VinylPlayer to a handful of listeners. Opening it to everyone needs Spotify's extended access, which goes only to registered companies with a large user base.
- **What I chose:** everyone else makes their own Spotify key, a code that connects the app to Spotify. They do it once, in about two minutes, and a guide in the app walks them through it. The guide says why, checks the key's format before saving it and answers "Is this safe?".
- **What I gave up:** an easy start. I wanted people to connect and play, but most people have a setup step before they hear their first record.

## How it works

1. **Connect Spotify.** The setup step is decision 4. Before connecting, "Look around first" opens sample records with no sound.
2. **Find a record.** Every part of the library gets a shelf: Records (albums, singles, EPs, compilations), Crates, Liked songs, Playlists, Artists you follow, and Listening (Recently played, Heavy rotation, the diary and Your year, over this month, the past 6 months or all time). Sort, filter (released, as a slider over a chart of the shelf's years; added; listening; crates; artists; every option says how many records it would show) and switch between Shelf, Stack and Wall. One search covers every shelf at once and all of Spotify (Tab switches): words in any order, one typo forgiven, and it understands "70s", "1977", "single" and "ep"; songs find their records.
3. **Read the sleeve.** Turn a sleeve over for its back, printed like a real one: the songs side by side, then the release, label and catalogue number, with no song lengths (a real back doesn't print them). Open it for the album page: the songs under Side A and Side B with each side's running time, in light washed from the cover's colours, with Play, Open in the player, save, Add to crate, and More (Share, Add to queue, Create a playlist from this album, Make a print).
4. **Play a side.** The record turns on the deck as the side plays: "Side A · Track 1 of 14", the song, artists and album, a sleeve to read, Prev, Start/Stop, Next, Repeat, Flip and a volume knob. The bar adds shuffle, seek, the A–B loop, a sleep timer, another device, the mini player and mute. Tracks, Queue and About sit in a panel. Full mode shows the record alone, big.

### The turntable, by hand

- Drag the arm and drop the needle anywhere to play from there; put the arm on its rest to stop.
- Drag the vinyl to nudge back or forward.
- Flip turns the record over at the end of a side.
- The volume knob turns by dragging up or down, or scrolling.
- At the end of a record the big button says Stop while the needle circles the run-out; after four turns the arm returns to its rest and the platter stops.

### Sleep timer

Stop the music at the end of this song, at the end of Side A, or after 15, 30 or 60 minutes. The music fades out over its last few seconds, then the record stops.

### Keep the vibe going

When a record ends, Spotify can carry on with songs like it, marked "Spotify's pick" on the bar and the turntable (needs Autoplay on in Spotify). Switched off in Settings, the music stops when the record ends.

## Other features

These don't change what the app is. The diary, Your year and Print are just for fun, so they stay off the turntable.

### Crates

A library is one long list. Collectors sort their records into boxes called crates, so I let you do the same: group albums by region, language or theme. Save a crate to Spotify once as a private playlist. After that, adding or removing albums or renaming the crate updates the playlist. The crate is the source of truth: direct edits to the playlist are replaced the next time the crate syncs.

### A–B loop

Mark where the part you love starts (A) and ends (B), and it replays until you clear it (key: L). It goes against an app about whole albums, but on Spotify I'd skip back by hand or hunt for an edited clip on YouTube. I built an early version into my own Spotify setup. Sharing it meant extra extensions and setup for everyone, so I built the loop into VinylPlayer itself.

### Listening diary

Spotify shows a little of what you've played. I wanted to show more.

- The last 30 days, told through records: the most played record leads, then plays, records, sides flipped and how many of the last seven days had music; the week as covers; what's on repeat; the latest plays.
- The full list of plays and flips is one step away, newest first, by day.
- Turned off in Settings, nothing new is written down, and the diary says "The diary is off" with a Turn on button.
- Stored on VinylPlayer's server under the listener's Spotify ID; deleted with their crates from Account.

### Your year

On Discord, a friend saw me looking up print ideas and said they wanted to print a mosaic of their whole year. We couldn't find a tool for it, so I built one.

- Every album and liked song added this year ("183 added in 2026" on my own library), arranged by colour into a record, or laid out as a wall of covers in a square, portrait or landscape shape.
- Background and label in black, white, the year's own colour or any colour; your own title, name and label words (Side A by default); shuffle where the colours start.
- Save image or Share. Made from the library the app already keeps, so it makes no extra requests to Spotify.
- Opens from the diary and the account menu.

### Print (the back of the album as a poster)

Years ago I printed album posters from Pinterest, like a Travis Scott one.

- From the album page (More → Make a print, or P).
- Colours: Paper, White, Stone, Black or the cover's colour, swatches from the cover, or any two of your own (with the app's own colour picker: shade, hue, hex and a screen dropper).
- Type: Sans, Display, Serif or Mono, with names in capitals or as written. Switches for the cover, cover colours, release details (by-line, date and label), tracklist, sides and discs, featured artists, running time (with the song count), title and artist, and the VinylPlayer mark.
- Zoom in, out or to fit (+, −, 0, or pinch), then download a high-resolution picture. Wide screens get a poster layout; phones get the same print stacked.

### Look and sound

- Look shows the pressings as real records turning in a row; press one, swipe, or use ← → and it goes on your record at once.
- Six pressings: Album colour, Coloured (black or any colour you pick), Picture disc, Marble, Clear and Smoke.
- Player colours as swatches: the album's own, plain, lacquer and glass, metal, wood and fourteen colours.
- In Settings → Player: centre label (printed label or cover art), wear and dust, surface noise (off, soft crackle, dusty), needle sounds (the drop and the run-out click) and turning speed (16⅔, 33⅓ or 45 rpm, which changes only the record on screen). Sounds play softly under the music; Spotify's own sound is never changed.

### Mini player, menu bar and desktop apps

- **Mini player:** a small window that stays above other apps (on every Space and over full-screen apps on the Mac): the turning record with the cover as its label, the song, artists, shuffle, previous, play/pause, next, repeat, the heart, the queue and the position. Drag it anywhere; it remembers where. Opens from Playback → Mini Player (⇧⌘M, or Ctrl+Shift+M), the menu bar or tray panel, or the Dock or tray menu.
- **Volume (Mac 1.0.3):** a speaker that mutes and a slider under the controls, in the mini player and the menu bar panel; the square mini player brings the slider out in the timeline's place from a speaker beside the heart, and the scroll wheel turns it there too.
- **Menu bar (Mac):** a small record in the menu bar, with the song's name beside it if you want. Click for a panel with the cover, song, progress and controls (the record tucked in its sleeve while paused, sliding out as it plays), then Open VinylPlayer, Mini player and Quit. The Dock icon can become the playing record.
- **Windows:** the tray icon opens the same panel; previous, play/pause and next sit on the taskbar thumbnail. **Linux:** a tray icon with a menu.
- **Everywhere:** media keys, macOS Now Playing, the Windows media overlay and Linux MPRIS, with a progress bar you can drag to seek. The computer doesn't put the app to sleep while music plays.
- **On the web:** Chrome and Edge open the same mini player as a picture-in-picture window that stays on top. The browser tab's icon can become the playing record, with the song in its title.

### Settings

One page: sections down the left, the open one on the right, and every change saves the moment it's made (no Save button). Opened from the account menu, and ⌘, in the Mac app.

- **Appearance:** Light, Dark or System (the D key switches anywhere); the record in the browser tab.
- **Language:** 13 languages; picking one reloads the app in it.
- **Accessibility:** text size (Default, Large, Larger in the desktop apps); contrast (Match my computer or Higher); motion (Full, Calm or Still). Calm is picked for modest computers and tagged "Picked for this computer". The computer's Reduce motion always wins, and the page says so.
- **Player:** opens as Record or Turntable; turning speed; flip sides by hand; keep the vibe going; songs shown as bands on the record; centre label; wear and dust; match the album's colours; surface noise; needle sounds.
- **Library:** opens on Records, Crates, Liked songs or Where I left off; open on the playing record; keep a listening diary. Shelves keep up with Spotify on their own.
- **Account:** Spotify name, picture and plan with a status in words ("Ready to play in this browser"); remove VinylPlayer's access on Spotify; your own Spotify key; Delete my crates and diary (the app's only red button); sign out.
- **Mac app / desktop:** open at login, menu bar icon and song, record in the Dock, mini player kept on top, and updates checked every few hours.
- **Keyboard shortcuts:** every key and gesture, from flipping five records at a time (Page Up/Down) to dragging the arm. Press ? anywhere to see them.
- **About:** version, Send feedback, privacy and terms.

## Getting feedback

**Feedback, built into the app.** I make VinylPlayer alone, so I wanted anyone using it to be able to tell me what's broken or what they'd change. No listener has written yet.

- **A clear reply, not a tracker.** The first version showed a progress track after you sent a note. Nothing on it would ever move, so it was a small lie. Now it says what happens to that kind of note: I read it, and bugs come before new features.
- **A place to say what you love.** Bug reports tell you what to fix. I also wanted to know what people would hate to lose, so one kind of note is called Something I love.
- **A full page of its own.** Feedback started as a small pop-up. Now the music keeps playing while you write, and Back returns to your records.
- **Four kinds of note, each with its own question.** A blank box is hard to fill. "What happened?" gets the steps behind a bug, and "What should VinylPlayer do?" lets someone think bigger.

- **The page.** In the app it's called "Help shape VinylPlayer". In the Mac app it opens from Help → Send Feedback…:
  - Four kinds of note, each with its own question and sentence starters: Something's broken ("What happened?"), A feature request ("What should VinylPlayer do?"), Something I love, Something else.
  - Files and screenshots by paperclip, drop or paste: up to 3 files, 5 MB each. Files are checked by their first bytes, not their names, and every refused file is named with a reason. Photos are redrawn before sending so their location stays on the device.
  - The draft is kept on the device; every failure (offline, too slow, too many notes in an hour, signed out, a refused file) keeps the note and says what to do.
  - In the Mac app it offers a one-click screenshot of the app's own window.
  - A reply screen says what happens next for that kind of note: a person reads every note; bugs are fixed before anything new is built; feature requests are weighed with others.
  - Notes are emailed to the maker; files are never stored.
- **Get help** answers the common questions first (Premium, a record that won't play, other devices, crates, the diary, shortcuts, missing playlists, reconnecting, offline, what's kept) and ends in Report a problem, which opens the feedback page on Something's broken (a note already being written keeps its own topic).
- **What's new** lists every change by date, grouped into New, Improved and Fixed.
- **Counting use privately.** A Listeners page only I can open counts the days people open the app signed in, with their country, Spotify plan, app version and language, and who came back. Each listener is a scrambled ID; anyone else who opens the address is sent home as if it didn't exist.

## How I worked

**From a Pinterest board to a player you can leave alone.**

### Watching people play records

I saved pictures of vinyl on Pinterest (a private board, so there's no link) and kept seeing records in special colours. That became the colours you can pick. I watched DJs mix by hand for hours, pulling the next record from a shelf. That became my shelf (Aloha Got Soul: https://youtu.be/YO4VLJ9yLWU). And I watched long videos of a record just playing, Michael Jackson or Sade, with nobody touching it (The Best of Sade on vinyl, by Mr. Ferrum: https://youtu.be/H3ybw48_81o).

### Drawing it, with AI

I tried the interactions with Figma's AI first, before connecting any real music. When it didn't get what I meant, I drew that part on paper. Then I used a sketch skill I'm building for AI agents, a set of instructions they follow. It turns my drawing into a detailed sketch with notes on a canvas, so I could change the drawing, run it again and test an idea before designing a final screen. I'm packaging it to publish.

### Building it for myself

I built a first version with AI, using my own Spotify account. It wasn't meant to go public. Once my own albums were on it, the ideas kept coming, so I listed features and asked friends which ones they'd want. When people saw the loop I'd made for replaying part of a song, they asked to use it, so I added it. I tested it on my own computer, playing music on it for hours.

### Cutting it back

I built a card for sharing what you're playing, and planned a listening room like Spotify Jam. I dropped both, because neither helps when you've put an album on and left it playing. It's just a player: you connect, you play.

## Limitations

- It only plays from Spotify. If Spotify changes what apps can do, VinylPlayer has to change too.
- It comes in 13 languages, but a few screens, Settings among them, are still in English.
- Playing needs Spotify Premium (Spotify's rule for every player like it), and Spotify also requires Premium to make your own key. On a phone, the music plays on another Spotify device.
- Spotify's Development Mode lets a small app sign in only a few invited people, so everyone else connects with their own Spotify key. One-click sign-in for everyone needs Spotify's extended access, which it gives only to registered companies with a large user base.
- Spotify's audio can't be analysed or changed: there's no equaliser for the music, and the visuals follow playback, not the sound.
- Spotify doesn't expose crossfade, gapless playback or reordering the queue to apps; "Play next" works.
- Spotify only lists the songs of playlists you made or that are shared with you, so followed playlists can't be opened as records.
- Genres show only when Spotify provides them.

## Outcome

**Now I listen to the whole album, like a story.** That's why I built it. I can't say the same for anyone else yet. The app is public, but I haven't marketed it, so I have no numbers worth showing.

- Live on the web at https://vinylplayer.app. Mac, Windows and Linux apps are built and sent directly to people Oussama knows; public downloads wait on a developer account.
- Mac app updates 1.0.1 to 1.0.4 shipped after 1.0.0 (31 October 2026).

## What's next

- **Going to market.** This comes first. I'll plan how to market the app, make and publish videos about it and talk about it online, so more people find it.
- **More devices.** Apps for iPad, Android tablets and Android phones.
- **Apple Music.** A second service to play from. YouTube may follow.

## What I learned

1. **Know the limits before you design.** Spotify sets the rules for an app like this. I planned an equaliser before I learned that an app can't touch Spotify's audio.
2. **One version first.** I didn't try to get every device right at the start. I finished the web version first, then built the desktop apps.
3. **Test the rule on real records.** My first rule for where side B starts looked right on my own albums. Checked against real vinyl, it missed often (56% right), so I wrote a better one (84%).
