Is vinyl still maintained?

Yes, active. Last change 3 days ago.

New, little track record. 123 stars, 1 months old. Look at the code and the owner before running it.

gitmanual

Reading the repo

Opening the box…

How to set up vinyl (rauchg/vinyl) · gitmanual

Assembly instructions

rauchg/vinyl

A record player simulated from the groove up

Node.js

Before you start

Is it free?: YesOpen source (MIT).
Still maintained?: Yes, activeLast change 3 days ago.
Can I trust it?: New, little track record123 stars, 1 months old. Look at the code and the owner before running it.

Difficulty: Easy
Time: about 5 min
Stars: ★ 123
Activity: Updated this month

Saved setup from 3 h ago

Will it work on macOS?

Yes, it runs on macOS

You'll build it yourself with Node.js.

Your system

macOS Windows Linux

Start here

Website ↗vinyl-gl.vercel.appThe project's own site.

4 steps on macOS

Download setup.sh

Then run bash setup.sh. It stops at the first error and is safe to run again. Servers and tests aren't started; it lists them at the end. Read it first.

1
Clone the repository
Needs Git: xcode-select --install
```
git clone https://github.com/rauchg/vinyl.git
cd vinyl
```

Install the required runtimes

Node.js >=22

# needs nvm: brew install nvm (or https://github.com/nvm-sh/nvm)
nvm install --lts

3
Install dependencies
```
npm install
```
4
Run the tests
```
npm test
```

From the README: Running it

$ vercel dev

That's it. vercel dev runs the same build as production (node build.mjs, which writes dist/) and serves it on localhost:3000. It builds once, so restart it after editing.

There's nothing to install. Node 22+ is enough for the build and the tests:

$ npm run build   # dist/: index.html, src/, assets/, records/
$ npm test        # offline checks of the physics: response, distortion, surface noise, cue, skip
$ npm run bench   # CPU cost of the engine per second of audio

Did you get it running?

No reports for macOS yet.

Still stuck? Get a written guide

GitManual AI Agent reads the 2 key files and writes a step-by-step guide for macOS. Once written, it's saved for everyone.