Skill: ricanwarfare/monochrome (version 1.1.0)

--- name: monochrome description: Browse 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. license: Apache-2.0 --- # 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: | 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 ``` ## 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 ```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 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` | ## 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


Security scan verdicts — ClawScan: clean | static analysis: clean | VirusTotal: clean | SkillSpector: clean (LOW)