Monochrome

Monochrome Music Skill

Browse and stream music from Monochrome (monochrome.tf) — a minimalist, high-fidelity music streaming client powered by Tidal.

Capabilities

• Search for artists, albums, tracks, videos, and playlists
• Get track info and streaming URLs
• Browse artist discographies
• Get album details and track lists
• Fetch lyrics for tracks
• Get artist recommendations

API Instances

Monochrome uses the Hi-Fi API (Tidal proxy). Available instances:

Use the primary instance for best reliability:

https://eu-central.monochrome.tf

Usage

Search for Music

Search for tracks, artists, albums, videos, or playlists:

Track Search:

GET /search/?s={query}&limit={limit}&offset={offset}

Artist Search:

GET /search/?a={query}&limit={limit}

Album Search:

GET /search/?al={query}&limit={limit}

Video Search:

GET /search/?v={query}&limit={limit}

Playlist Search:

GET /search/?p={query}&limit={limit}

ISRC Search (exact track match):

GET /search/?i={isrc}

Get Track Info

GET /info/?id={track_id}

Get Track Streaming URL

GET /track/?id={track_id}&quality={quality}&immersiveaudio={bool}

Quality options: LOW, HIGH, LOSSLESS, HI_RES, HI_RES_LOSSLESS

Get Album Details

GET /album/?id={album_id}&limit={limit}&offset={offset}

Get Artist Info

GET /artist/?id={artist_id}

Get Artist Albums & Tracks

GET /artist/?f={artist_id}

Get Similar Artists

GET /artist/similar/?id={artist_id}

Get Similar Albums

GET /album/similar/?id={album_id}

Get Lyrics

GET /lyrics/?id={track_id}

Get Playlist

GET /playlist/?id={playlist_id}&limit={limit}&offset={offset}

Get Mix

GET /mix/?id={mix_id}

Get Recommendations

GET /recommendations/?id={track_id}

Get Cover Art

GET /cover/?id={track_id}
GET /cover/?q={search_query}

Cover URLs follow the pattern:

https://resources.tidal.com/images/{uuid}/{size}.jpg

Sizes: 80x80, 320x320, 640x640, 1280x1280, 750x750

Implementation

Step 1: Search for Music

curl "https://eu-central.monochrome.tf/search/?s=Linkin%20Park&limit=10"

Returns JSON with track items including:

• id — Track ID
• title — Track title
• artists — Artist list
• album — Album info
• duration — Duration in seconds
• audioQuality — Quality tier

Step 2: Get Streaming URL

curl "https://eu-central.monochrome.tf/track/?id=12345678&quality=HI_RES_LOSSLESS"

Returns streaming manifest URL.

Step 3: Play/Download

The streaming URL can be used directly in audio players or downloaders.

Example Queries

Notes

• API is rate-limited; use appropriate delays for bulk requests
• Quality HI_RES_LOSSLESS requires compatible streaming setup
• All endpoints return JSON with version and data fields
• Default countryCode is US

Related Skills

• music-downloader — Download tracks from monochrome.tf
• mcp-vision — Analyze album covers

Links

• Monochrome Web: https://monochrome.tf
• GitHub: https://github.com/monochrome-music/monochrome
• API Status: https://tidal-uptime.jiffy-puffs-1j.workers.dev