Getting Started

Run from source

Python 3.8 or higher
FFmpeg - required for audio processing

Install FFmpeg

OS	Command
Ubuntu/Debian	`sudo apt install ffmpeg`
macOS (Homebrew)	`brew install ffmpeg`
Windows	Download from ffmpeg.org

Clone and run

git clone https://git.vmn.su/max/audio_splitter.git
cd audio_splitter
python -m audio_splitter.main input.mp3 tracklist.txt

Installation

From Source

git clone https://git.vmn.su/max/audio_splitter.git
cd audio_splitter
pip install .
audio_splitter input.mp3 tracklist.txt

Using Docker Compose

Web version is also available with Docker Compose:

services:
  backend:
    image: git.vmn.su/max/audio_splitter_backend:latest
    ports:
      - "${BACKEND_PORT:-8000}:8000"
    volumes:
      # Bind mount for persistent data storage.
      # Set BACKEND_DATA_DIR in .env to point to your data directory.
      - "${BACKEND_DATA_DIR:-/var/lib/audio_splitter_data}:/tmp/audio_splitter_web"
    environment:
      - PYTHONUNBUFFERED=1
      - DEBUG=${DEBUG:-0}
    restart: unless-stopped

  frontend:
    image: git.vmn.su/max/audio_splitter_frontend:latest
    ports:
      - "${FRONTEND_PORT:-5173}:80"
    depends_on:
      - backend
    restart: unless-stopped

Now the fully functional web-interface should be accessible via http://localhost:5173