yoink
Providers

Tidal

Configure Tidal for metadata and hi-res downloads via hifi-api.

Tidal serves as both a metadata provider and a download source. It uses hifi-api proxy, not the official Tidal API.

Setup

If you want to self host your own hifi-api instance for better performance and reliability, follow the steps below. Otherwise, you can use publicly available hifi-api instances, but they may have rate limits or downtime.

Deploy hifi-api

Follow the hifi-api setup guide to get a running instance. By default it listens on port 8000.

Point yoink to your hifi-api instance

Tidal is enabled by default (TIDAL_ENABLED=true). Set the API URL to point to your hifi-api instance:

TIDAL_API_BASE_URL=http://host.docker.internal:8000

If hifi-api is running on the same Docker network, use the service name instead:

TIDAL_API_BASE_URL=http://hifi-api:8000

Capabilities

  • Artist search and metadata
  • Album listing with release dates and cover art
  • Track listing with durations and ISRCs
  • Hi-res audio downloads (quality depends on your Tidal subscription tier)

Environment Variables

VariableDescriptionDefault
TIDAL_ENABLEDEnable or disable Tidaltrue
TIDAL_API_BASE_URLURL of your hifi-api proxy

Providers

How yoink's multi-provider architecture works.

Deezer

Use Deezer as a metadata enrichment source.

On this page

SetupDeploy hifi-apiPoint yoink to your hifi-api instanceCapabilitiesEnvironment Variables