Install
openclaw skills install @ricanwarfare/monochromeBrowse and search music from monochrome.tf (Tidal-based Hi-Fi streaming). Search for artists, albums, tracks, and get streaming URLs. Use for music discovery and high-fidelity audio streaming.
openclaw skills install @ricanwarfare/monochromeBrowse and stream music from Monochrome (monochrome.tf) — a minimalist, high-fidelity music streaming client powered by Tidal.
Monochrome uses the Hi-Fi API (Tidal proxy). Available instances:
| Instance | Version | Status |
|---|---|---|
eu-central.monochrome.tf | 2.8 | Primary |
us-west.monochrome.tf | 2.8 | Secondary |
hifi-one.spotisaver.net | 2.8 | Community |
hifi-two.spotisaver.net | 2.8 | Community |
hifi.geeked.wtf | 2.7 | Community |
Use the primary instance for best reliability:
https://eu-central.monochrome.tf
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 /info/?id={track_id}
GET /track/?id={track_id}&quality={quality}&immersiveaudio={bool}
Quality options: LOW, HIGH, LOSSLESS, HI_RES, HI_RES_LOSSLESS
GET /album/?id={album_id}&limit={limit}&offset={offset}
GET /artist/?id={artist_id}
GET /artist/?f={artist_id}
GET /artist/similar/?id={artist_id}
GET /album/similar/?id={album_id}
GET /lyrics/?id={track_id}
GET /playlist/?id={playlist_id}&limit={limit}&offset={offset}
GET /mix/?id={mix_id}
GET /recommendations/?id={track_id}
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
curl "https://eu-central.monochrome.tf/search/?s=Linkin%20Park&limit=10"
Returns JSON with track items including:
id — Track IDtitle — Track titleartists — Artist listalbum — Album infoduration — Duration in secondsaudioQuality — Quality tiercurl "https://eu-central.monochrome.tf/track/?id=12345678&quality=HI_RES_LOSSLESS"
Returns streaming manifest URL.
The streaming URL can be used directly in audio players or downloaders.
| User Request | API 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 |
HI_RES_LOSSLESS requires compatible streaming setupversion and data fieldscountryCode is US