Latest release

Installation Guide

Professional vinyl track splitting with accurate metadata and modern cue editing.

Click & Run (Recommended) Docker (Stable) Manual Python

Desktop App Click & Run

1 Download

No installation required. Everything (including Python and FFmpeg) is bundled inside.

Windows (.exe) x64 Architecture
macOS (Apple Silicon) ARM64 for M1/M2/M3
macOS (Legacy) Intel 10.15 (Catalina)
Linux (AppImage)
Linux Lite (Browser)

Note: The Apple Silicon build is ARM64 and distributed as VINYLflowplus-macOS-Universal.zip. Intel legacy builds use a separate artifact.

2 Run & Digitize

  • - Windows: Download the .exe and double-click to start. Everything is pre-configured.
  • - macOS: Unzip and drag the .app to your Applications folder.
  • - Linux: Download the .AppImage, make it executable (chmod +x), and run.

Current in v1.1.0: undo stack, minimap overlay, autoscroll, settings in step 3, full track names with per-track artists, success screen redesign, and open-folder shortcut.

Docker Setup (Stable)

1 Get the Code

Download the latest version and navigate to the folder.

git clone https://github.com/flarkflarkflark/VINYLflowplus.git
cd VINYLflowplus

2 Start VINYLflowplus

Run the following command. Docker will download all dependencies and start the server.

docker compose up -d

3 Access UI

Open your browser and navigate to:

http://localhost:8000

Manual Python Setup

Ideal for developers or users who want to run the software natively on Linux or macOS without Docker.

Prerequisites

Install Python 3.11+, FFmpeg, and Flac.

# macOS (Homebrew)
brew install python@3.11 ffmpeg flac

Setup Environment

python -m venv venv
source venv/bin/activate
pip install -r requirements.txt

Launch

python -m uvicorn backend.api:app --host 0.0.0.0 --port 8000

Discogs API Setup

To fetch metadata and cover art, VINYLflowplus needs a free Discogs Personal Access Token.

  1. 1. Log in to your account at Discogs Developers Settings.
  2. 2. Click "Generate New Token" and copy it.
  3. 3. Open Settings → Discogs in VINYLflowplus and paste the token.
  4. 4. Save the settings. You can search Discogs immediately after saving.

Current highlights (v1.1.0)

  • -Undo stack in the waveform editor — undo/redo track boundary edits
  • -Minimap overlay — waveform overview panel for fast navigation across long recordings
  • -Autoscroll — waveform follows playback cursor automatically
  • -Settings accessible in step 3 — format and output settings available directly in the processing step
  • -Full track names with per-track artists throughout the processing view
  • -Success screen redesign with one-click open-folder shortcut
  • -Top queue bar — upload queue visible throughout the workflow
  • -Multi-artist filenames and tags — proper & separator with spacing
  • -Sub-track / medley support — Discogs sub-positions collapsed into one vinyl segment with joined title
  • -Interactive cue / hotcue editor with up to 32 slots
  • -Realtime processing updates and bundled FFmpeg in all desktop builds