Tanner
65 lines
1.7 KiB
Markdown
65 lines
1.7 KiB
Markdown
# Qotplayer
|
|
|
|
A lightweight, headless Python audio player designed as a fast drop-in replacement for `mpv`.
|
|
|
|
This player is specifically built to act as a backend player for **Navidrome** (in Jukebox mode) feeding into **Snapcast**. It avoids the overhead of full `mpv` while maintaining compatibility with its IPC protocol.
|
|
|
|
This removes about 5 seconds of audio playback lag and UI seeking lag.
|
|
|
|
## What it does
|
|
|
|
- Decodes and resamples common audio formats to `48000Hz`, `stereo`, `s16` PCM.
|
|
- Outputs raw PCM audio directly to a FIFO pipe (`/tmp/snapfifo`).
|
|
- Provides a JSON IPC server over a Unix socket for real-time playback control (pause, volume, seek, quit).
|
|
- Maps 0-100 volume levels to 25-100 and applies log scale (for human hearing).
|
|
|
|
## Setup
|
|
|
|
docker-compose.yml:
|
|
|
|
```
|
|
services:
|
|
navidrome:
|
|
build: .
|
|
user: 1000:1000 # should be owner of volumes
|
|
ports:
|
|
- "4533:4533"
|
|
restart: unless-stopped
|
|
environment:
|
|
ND_JUKEBOX_ENABLED: true
|
|
ND_MPVCMDTEMPLATE: '/opt/qotplayer/env/bin/python /opt/qotplayer/main.py %f --input-ipc-server=%s'
|
|
ND_LOGLEVEL: info
|
|
volumes:
|
|
- "./data:/data"
|
|
- "/mnt/music-combined:/music:ro"
|
|
- "/tmp/snapfifo:/tmp/snapfifo"
|
|
```
|
|
|
|
Dockerfile:
|
|
|
|
```
|
|
FROM deluan/navidrome:latest
|
|
|
|
RUN apk add --no-cache git curl && \
|
|
curl -LsSf https://astral.sh/uv/install.sh | sh
|
|
|
|
ENV PATH="/root/.local/bin:$PATH"
|
|
|
|
WORKDIR /opt
|
|
RUN git clone https://git.tanner.vc/tanner/qotplayer.git
|
|
|
|
WORKDIR /opt/qotplayer
|
|
RUN uv venv --python=3.12 env && \
|
|
. env/bin/activate && \
|
|
uv pip install -r requirements.txt
|
|
|
|
RUN chmod 755 /root
|
|
```
|
|
|
|
Build and run with:
|
|
|
|
```
|
|
$ sudo docker compose build --no-cache
|
|
$ sudo docker compose up
|
|
```
|