Pinchflat

Self-Hosted

Self-hosted media downloader for streaming platforms

Overview

Pinchflat is a self-hosted tool for downloading music, podcasts, and videos from supported streaming services (Spotify, YouTube Music, Deezer) to local storage. It automatically tags files with metadata (album art, artist info, track details) and integrates with Plex/Jellyfin for media library management. Deployed via Docker for simplified setup, it includes a web UI to manage downloads and configurations, giving you full control over your media without relying on third-party servers.

Self-Hosting Resources

Find Official Image on Docker Hub View Source & Docs

Below is a reference structure for docker-compose.yml. ⚠️ Do NOT run blindly. Replace placeholders with official values.

docker-compose.template.yml TEMPLATE


version: '3'
services:
  pinchflat:
    image: <OFFICIAL_IMAGE_NAME>:latest
    container_name: pinchflat
    ports:
      - "8080:<APP_INTERNAL_PORT>"
    volumes:
      - ./data:/app/data
    restart: unless-stopped

Key Features

Multi-platform media downloading (Spotify, YT Music, Deezer)
Auto-metadata tagging (album art, artist, track info)
Dockerized deployment & web UI management

Frequently Asked Questions

? Is Pinchflat hard to install?

Pinchflat uses Docker for deployment, simplifying setup for most users. You’ll need to configure API keys for supported streaming services, but official documentation provides clear steps for this process.

? Is Pinchflat a good alternative to Spotify Premium’s offline mode?

Yes—unlike Spotify’s offline mode (locked to the app), Pinchflat lets you download media as local files you own, playable on any device or integrated into Plex/Jellyfin.

? Is Pinchflat completely free?

Pinchflat is open source and free to use. However, some streaming services require a paid subscription to access content for downloading (e.g., Spotify Premium for certain tracks).

Top Alternatives

4K Video Downloader Search Google

Any Video Converter Search Google

Spotify Premium (offline mode) Search Google

Tool Info

Pricing Open Source

Category Media Management

Platform Self-Hosted

Pros

⊕ Privacy-focused (no third-party data sharing)
⊕ No subscription fees
⊕ Integrates with Plex/Jellyfin media servers

Cons

⊖ Requires API keys for some streaming services
⊖ Technical setup for API integration
⊖ Limited to supported streaming platforms