{"id":47282645,"url":"https://github.com/ethansk/producer-player","last_synced_at":"2026-06-15T01:02:04.944Z","repository":{"id":342887116,"uuid":"1175528402","full_name":"EthanSK/producer-player","owner":"EthanSK","description":"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.","archived":false,"fork":false,"pushed_at":"2026-05-24T02:07:34.000Z","size":504049,"stargazers_count":12,"open_issues_count":0,"forks_count":1,"subscribers_count":0,"default_branch":"main","last_synced_at":"2026-05-24T04:35:30.049Z","etag":null,"topics":["audio","audio-analysis","desktop-app","electron","lufs","mastering","music-production","playlist-management","react","stereo-correlation","typescript","vectorscope","waveform"],"latest_commit_sha":null,"homepage":"https://ethansk.github.io/producer-player/","language":"TypeScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"other","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/EthanSK.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":"SECURITY.md","support":null,"governance":null,"roadmap":"docs/ROADMAP.md","authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":"AGENTS.md","dco":null,"cla":null}},"created_at":"2026-03-07T20:44:54.000Z","updated_at":"2026-05-24T01:55:14.000Z","dependencies_parsed_at":null,"dependency_job_id":"4a968dd1-1d30-411b-baf7-cb9ae2dc7b12","html_url":"https://github.com/EthanSK/producer-player","commit_stats":null,"previous_names":["ethansk/producer-player"],"tags_count":581,"template":false,"template_full_name":null,"purl":"pkg:github/EthanSK/producer-player","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/EthanSK%2Fproducer-player","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/EthanSK%2Fproducer-player/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/EthanSK%2Fproducer-player/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/EthanSK%2Fproducer-player/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/EthanSK","download_url":"https://codeload.github.com/EthanSK/producer-player/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/EthanSK%2Fproducer-player/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":33716339,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-05-26T15:22:16.424Z","status":"online","status_checked_at":"2026-05-31T02:00:06.040Z","response_time":95,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["audio","audio-analysis","desktop-app","electron","lufs","mastering","music-production","playlist-management","react","stereo-correlation","typescript","vectorscope","waveform"],"created_at":"2026-03-16T02:26:29.995Z","updated_at":"2026-05-31T02:00:50.770Z","avatar_url":"https://github.com/EthanSK.png","language":"TypeScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Producer Player\n\n**Finish music, not file management.**\n\n[![CI](https://github.com/EthanSK/producer-player/actions/workflows/ci.yml/badge.svg)](https://github.com/EthanSK/producer-player/actions/workflows/ci.yml)\n[![Release](https://github.com/EthanSK/producer-player/actions/workflows/release-desktop.yml/badge.svg)](https://github.com/EthanSK/producer-player/actions/workflows/release-desktop.yml)\n[![License: PolyForm Noncommercial 1.0.0](https://img.shields.io/badge/License-PolyForm%20Noncommercial%201.0.0-purple.svg)](LICENSE)\n\nA 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.\n\n[Website](https://ethansk.github.io/producer-player/) \u0026#183; [Download](https://github.com/EthanSK/producer-player/releases) \u0026#183; [Source](https://github.com/EthanSK/producer-player)\n\n\u003cp align=\"center\"\u003e\n  \u003cimg src=\"site/assets/screenshots/main-view.png\" alt=\"Producer Player — scan folders, auto-group versions, drag to reorder, album art, version history, mastering metrics\" width=\"100%\" /\u003e\n\u003c/p\u003e\n\n## Features\n\n\u003ctable\u003e\n  \u003ctr\u003e\n    \u003ctd align=\"center\" width=\"50%\"\u003e\n      \u003cimg src=\"site/assets/screenshots/checklist.png\" alt=\"Production Checklist\" width=\"100%\" /\u003e\u003cbr /\u003e\n      \u003cstrong\u003eProduction Checklist\u003c/strong\u003e\u003cbr /\u003e\n      \u003csub\u003ePer-song notes with timestamps and version management. Click a timestamp to jump straight to that moment in playback.\u003c/sub\u003e\n    \u003c/td\u003e\n    \u003ctd align=\"center\" width=\"50%\"\u003e\n      \u003cimg src=\"site/assets/screenshots/tutorials.png\" alt=\"Built-in Tutorials \u0026 AI Assistant\" width=\"100%\" /\u003e\u003cbr /\u003e\n      \u003cstrong\u003eTutorials \u0026 AI Assistant\u003c/strong\u003e\u003cbr /\u003e\n      \u003csub\u003eEvery metric explained in plain language with curated video tutorials. Chat with Producey Boy, an AI mastering assistant, for personalised guidance.\u003c/sub\u003e\n    \u003c/td\u003e\n  \u003c/tr\u003e\n  \u003ctr\u003e\n    \u003ctd align=\"center\" width=\"50%\"\u003e\n      \u003cimg src=\"site/assets/screenshots/waveform-loudness.png\" alt=\"Reference Matching\" width=\"100%\" /\u003e\u003cbr /\u003e\n      \u003cstrong\u003eReference A/B Comparison\u003c/strong\u003e\u003cbr /\u003e\n      \u003csub\u003eLoad a reference track, auto-match loudness, and A/B compare. Loudness history and waveform visualization side by side.\u003c/sub\u003e\n    \u003c/td\u003e\n    \u003ctd align=\"center\" width=\"50%\"\u003e\n      \u003cimg src=\"site/assets/screenshots/platform-normalization.png\" alt=\"Platform Normalization\" width=\"100%\" /\u003e\u003cbr /\u003e\n      \u003cstrong\u003ePlatform Normalization Preview\u003c/strong\u003e\u003cbr /\u003e\n      \u003csub\u003eHear what Spotify, Apple Music, YouTube, and TIDAL will do to your master before you upload. Headroom-aware gain limits included.\u003c/sub\u003e\n    \u003c/td\u003e\n  \u003c/tr\u003e\n  \u003ctr\u003e\n    \u003ctd align=\"center\" width=\"50%\"\u003e\n      \u003cimg src=\"site/assets/screenshots/spectrum-mastering.png\" alt=\"Mastering Workspace\" width=\"100%\" /\u003e\u003cbr /\u003e\n      \u003cstrong\u003eMastering Workspace\u003c/strong\u003e\u003cbr /\u003e\n      \u003csub\u003eSpectrum analyzer with band soloing, loudness metering (integrated, short-term, momentary LUFS), true peak detection, and stereo imaging.\u003c/sub\u003e\n    \u003c/td\u003e\n    \u003ctd align=\"center\" width=\"50%\"\u003e\n      \u003cimg src=\"site/assets/screenshots/midside-analysis.png\" alt=\"Advanced Analysis\" width=\"100%\" /\u003e\u003cbr /\u003e\n      \u003cstrong\u003eAdvanced Analysis\u003c/strong\u003e\u003cbr /\u003e\n      \u003csub\u003eDynamic range, crest factor, mid/side spectrum, loudness distribution, vectorscope, and stereo correlation -- with AI-powered insights.\u003c/sub\u003e\n    \u003c/td\u003e\n  \u003c/tr\u003e\n\u003c/table\u003e\n\n### Version Management \u0026 Album Organization\n\nThe 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.\n\n### Production Checklist \u0026 Notes\n\nPer-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.\n\n### AI Mastering Assistant\n\nProducey Boy analyzes your track's loudness, spectrum, and stereo field, then gives you plain-language feedback and suggestions. Available throughout the app.\n\n### Built-in Tutorials\n\nEvery 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.\n\n### Reference Track A/B\n\nLoad a reference alongside your master with automatic level matching so you're comparing tone, not volume. Playhead restores after auditioning.\n\n### Platform Normalization Preview\n\nPreview gain adjustments for Spotify (-14 LUFS), Apple Music (-16 LUFS), YouTube, TIDAL, and Amazon Music. Clips are flagged before you upload.\n\n### Mastering Workspace\n\nFull-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.\n\n### Export \u0026 Handoff\n\nExport the latest version of every song as numbered, album-sequenced files with ordering metadata. Ready for distribution or handoff to a mastering engineer.\n\n## Download\n\nFree and source-available. macOS, Windows, and Linux.\n\n**[Latest release](https://github.com/EthanSK/producer-player/releases)**\n\nLinux users should prefer the `.AppImage` build for automatic updates; `.deb` and portable `.zip` artifacts are also published.\n\n\u003e Current builds are unsigned preview releases. Signed/notarized macOS distribution is pending.\n\n## Development\n\nElectron + React + TypeScript monorepo with npm workspaces.\n\n```\napps/electron    -- main process + preload bridge\napps/renderer    -- React UI\napps/e2e         -- Playwright desktop tests\npackages/contracts -- shared IPC types\npackages/domain  -- folder scanning, grouping, ordering logic\nsite/            -- GitHub Pages landing page\n```\n\n```bash\nnpm install          # install deps + set up git hooks\nnpm run dev          # development mode\nnpm run dev:hot      # with renderer hot reload\nnpm run build        # production build\nnpm run typecheck    # full typecheck (all workspaces)\nnpm run e2e          # smoke E2E tests\n```\n\nSee [docs/RELEASING.md](docs/RELEASING.md) for packaging and release details.\n\n## License\n\n[PolyForm Noncommercial 1.0.0](LICENSE) -- free for noncommercial use.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fethansk%2Fproducer-player","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fethansk%2Fproducer-player","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fethansk%2Fproducer-player/lists"}