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:

InstanceVersionStatuseu-central.monochrome.tf2.8Primaryus-west.monochrome.tf2.8Secondaryhifi-one.spotisaver.net2.8Communityhifi-two.spotisaver.net2.8Communityhifi.geeked.wtf2.7Community

Use the primary instance for best reliability:

text

https://eu-central.monochrome.tf

Usage#

Search for Music#

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

Track Search:

text

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

Artist Search:

text

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

Album Search:

text

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

Video Search:

text

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

Playlist Search:

text

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

ISRC Search (exact track match):

text

GET /search/?i={isrc}

Get Track Info#

text

GET /info/?id={track_id}

Get Track Streaming URL#

text

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

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

Get Album Details#

text

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

Get Artist Info#

text

GET /artist/?id={artist_id}

Get Artist Albums & Tracks#

text

GET /artist/?f={artist_id}

Get Similar Artists#

text

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

Get Similar Albums#

text

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

Get Lyrics#

text

GET /lyrics/?id={track_id}

Get Playlist#

text

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

Get Mix#

text

GET /mix/?id={mix_id}

Get Recommendations#

text

GET /recommendations/?id={track_id}

Get Cover Art#

text

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

Cover URLs follow the pattern:

text

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

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

Implementation#

Step 1: Search for Music#

bash

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#

bash

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#

User RequestAPI Call"Search for Linkin Park"/search/?a=Linkin%20Park"Find the album Hybrid Theory"/search/?al=Hybrid%20Theory"Get track info for 12345"/info/?id=12345"Get lyrics for track 12345"/lyrics/?id=12345"Similar artists to Eminem"/artist/similar/?id=12345

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