https://github.com/ethansk/producer-player
Free, open-source music production companion — full mastering analysis with LUFS metering, vectorscope, stereo correlation, waveform display, platform normalization preview, reference A/B matching, and more.
https://github.com/ethansk/producer-player
audio audio-analysis desktop-app electron lufs mastering music-production playlist-management react stereo-correlation typescript vectorscope waveform
Last synced: 8 days ago
JSON representation
Free, open-source music production companion — full mastering analysis with LUFS metering, vectorscope, stereo correlation, waveform display, platform normalization preview, reference A/B matching, and more.
- Host: GitHub
- URL: https://github.com/ethansk/producer-player
- Owner: EthanSK
- License: other
- Created: 2026-03-07T20:44:54.000Z (4 months ago)
- Default Branch: main
- Last Pushed: 2026-05-24T02:07:34.000Z (30 days ago)
- Last Synced: 2026-05-24T04:35:30.049Z (30 days ago)
- Topics: audio, audio-analysis, desktop-app, electron, lufs, mastering, music-production, playlist-management, react, stereo-correlation, typescript, vectorscope, waveform
- Language: TypeScript
- Homepage: https://ethansk.github.io/producer-player/
- Size: 481 MB
- Stars: 12
- Watchers: 0
- Forks: 1
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- Changelog: CHANGELOG.md
- License: LICENSE
- Security: SECURITY.md
- Roadmap: docs/ROADMAP.md
- Agents: AGENTS.md
Awesome Lists containing this project
README
# Producer Player
**Finish music, not file management.**
[](https://github.com/EthanSK/producer-player/actions/workflows/ci.yml)
[](https://github.com/EthanSK/producer-player/actions/workflows/release-desktop.yml)
[](LICENSE)
A desktop app for producers who bounce a lot. Drag in a folder of exports and Producer Player auto-groups versions, organizes your album, and gives you a full mastering workspace -- all in one place.
[Website](https://ethansk.github.io/producer-player/) · [Download](https://github.com/EthanSK/producer-player/releases) · [Source](https://github.com/EthanSK/producer-player)
## Features
Production Checklist
Per-song notes with timestamps and version management. Click a timestamp to jump straight to that moment in playback.
Tutorials & AI Assistant
Every metric explained in plain language with curated video tutorials. Chat with Producey Boy, an AI mastering assistant, for personalised guidance.
Reference A/B Comparison
Load a reference track, auto-match loudness, and A/B compare. Loudness history and waveform visualization side by side.
Platform Normalization Preview
Hear what Spotify, Apple Music, YouTube, and TIDAL will do to your master before you upload. Headroom-aware gain limits included.
Mastering Workspace
Spectrum analyzer with band soloing, loudness metering (integrated, short-term, momentary LUFS), true peak detection, and stereo imaging.
Advanced Analysis
Dynamic range, crest factor, mid/side spectrum, loudness distribution, vectorscope, and stereo correlation -- with AI-powered insights.
### Version Management & Album Organization
The core workflow. Drop a folder of bounces and Producer Player groups them automatically (`Track v1`, `Track v2`, etc.). Drag songs into album order, attach album art, and link to your DAW project files. Order persists through rescans and restarts.
### Production Checklist & Notes
Per-song checklist with time-stamped notes -- add an item during playback and it captures the exact position. Click the timestamp to jump back. Rate tracks 1-10 to keep your album shortlist clear.
### AI Mastering Assistant
Producey Boy analyzes your track's loudness, spectrum, and stereo field, then gives you plain-language feedback and suggestions. Available throughout the app.
### Built-in Tutorials
Every metric in the app has a dedicated tutorial with clear explanations and curated video links. No more tab-switching to figure out what LRA means.
### Reference Track A/B
Load a reference alongside your master with automatic level matching so you're comparing tone, not volume. Playhead restores after auditioning.
### Platform Normalization Preview
Preview gain adjustments for Spotify (-14 LUFS), Apple Music (-16 LUFS), YouTube, TIDAL, and Amazon Music. Clips are flagged before you upload.
### Mastering Workspace
Full-screen spectrum analyzer with frequency band soloing, integrated/short-term/momentary LUFS, true peak (dBTP), sample peak, clip count, crest factor, DC offset, stereo correlation, vectorscope, K-metering (K-14, K-20), mid/side monitoring, and loudness history.
### Export & Handoff
Export the latest version of every song as numbered, album-sequenced files with ordering metadata. Ready for distribution or handoff to a mastering engineer.
## Download
Free and source-available. macOS, Windows, and Linux.
**[Latest release](https://github.com/EthanSK/producer-player/releases)**
Linux users should prefer the `.AppImage` build for automatic updates; `.deb` and portable `.zip` artifacts are also published.
> Current builds are unsigned preview releases. Signed/notarized macOS distribution is pending.
## Development
Electron + React + TypeScript monorepo with npm workspaces.
```
apps/electron -- main process + preload bridge
apps/renderer -- React UI
apps/e2e -- Playwright desktop tests
packages/contracts -- shared IPC types
packages/domain -- folder scanning, grouping, ordering logic
site/ -- GitHub Pages landing page
```
```bash
npm install # install deps + set up git hooks
npm run dev # development mode
npm run dev:hot # with renderer hot reload
npm run build # production build
npm run typecheck # full typecheck (all workspaces)
npm run e2e # smoke E2E tests
```
See [docs/RELEASING.md](docs/RELEASING.md) for packaging and release details.
## License
[PolyForm Noncommercial 1.0.0](LICENSE) -- free for noncommercial use.