← Back to Skills Marketplace
ricanwarfare

Monochrome

by ricanwarfare · GitHub ↗ · v1.1.0 · MIT-0
cross-platform ✓ Security Clean
126
Downloads
0
Stars
1
Active Installs
2
Versions
Install in OpenClaw
/install 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...
README (SKILL.md)

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

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

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

Usage Guidance
This skill appears coherent and low-risk from a supply/credential perspective, but check a few things before installing: 1) prefer the listed primary instance (https://eu-central.monochrome.tf) and avoid community instances you don't trust — they may host different content or behave differently; 2) review the linked GitHub repo (https://github.com/monochrome-music/monochrome) yourself if you want more assurance about the service; 3) be aware the skill returns streaming URLs which can be passed to players or downloaders — ensure you comply with copyright and usage rules in your jurisdiction; 4) if you do not want the agent to make network calls autonomously, consider disabling autonomous invocation for this skill or review calls before they are executed; and 5) do not supply any unrelated credentials to the skill (none are required).
Capability Analysis
Type: OpenClaw Skill Name: monochrome Version: 1.1.0 The skill provides documentation and API endpoints for interacting with Monochrome, a Tidal-based music streaming proxy. It includes standard search and metadata retrieval capabilities across several community-hosted instances (e.g., monochrome.tf, spotisaver.net) and lacks any indicators of data exfiltration, malicious execution, or prompt injection.
Capability Assessment
✓ Purpose & Capability
Name and description (browse/search music from monochrome.tf / Tidal proxy) match the SKILL.md: all endpoints, examples, and usage are consistent with a read-only HTTP API client for that service. There are no unrelated environment variables, binaries, or install steps requested.
ℹ Instruction Scope
The SKILL.md instructs the agent to make unauthenticated GET requests to monochrome instances and to return streaming manifests/URLs. It does not instruct the agent to read local files or env vars, nor to exfiltrate data. Note: it references multiple 'community' instances (spotisaver.net, geeked.wtf) in addition to the primary instance — those are additional external endpoints the agent may call if used, and the skill explicitly suggests using streaming URLs in players or downloaders (which could be used to download copyrighted content).
✓ Install Mechanism
There is no install spec and no code files; the skill is instruction-only. That minimizes on-disk risk and nothing is written or executed on install.
✓ Credentials
The skill declares no required environment variables, no primary credential, and no config paths. The runtime instructions do not reference additional secrets. This is proportionate for a public-API, read-only browsing skill.
✓ Persistence & Privilege
always is false and there is no install step that would create persistent artifacts or modify agent/system configuration. The skill can be invoked autonomously by the agent (platform default), but that is not combined here with broad credentials or install-level persistence.
How to Use
  1. Make sure OpenClaw is installed (local or Docker)
  2. Run the install command in chat: /install monochrome
  3. After installation, invoke the skill by name or use /monochrome
  4. Provide required inputs per the skill's parameter spec and get structured output
Version History
v1.1.0
Synced from openclaw-skills repo
v1.0.0
Monochrome Music Skill v1.0.0 - Initial release enabling music discovery and high-fidelity streaming from Monochrome (monochrome.tf). - Search and browse artists, albums, tracks, videos, playlists, and get streaming URLs. - Fetch detailed info: track data, album details, artist discographies, lyrics, recommendations, and cover art. - Supports primary and community API instances for reliability. - Comprehensive API endpoints documented for varied music queries and usage.
Metadata
Slug monochrome
Version 1.1.0
License MIT-0
All-time Installs 1
Active Installs 1
Total Versions 2
Frequently Asked Questions

What is Monochrome?

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... It is an AI Agent Skill for Claude Code / OpenClaw, with 126 downloads so far.

How do I install Monochrome?

Run "/install monochrome" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.

Is Monochrome free?

Yes, Monochrome is completely free, licensed under MIT-0. You can download, install and use it at no cost.

Which platforms does Monochrome support?

Monochrome is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).

Who created Monochrome?

It is built and maintained by ricanwarfare (@ricanwarfare); the current version is v1.1.0.

More Skills
self-improving agent
Captures learnings, errors, and corrections to enable continuous improvement. Use when: (1) A command or operation fails unexpectedly, (2) User corrects Clau...
⬇ 463283 · by pskoett
Skill Vetter
Security-first skill vetting for AI agents. Use before installing any skill from ClawdHub, GitHub, or other sources. Checks for red flags, permission scope, and suspicious patterns.
⬇ 259410 · by spclaudehome
Polymarket
Query Polymarket prediction markets. Check odds, find trending markets, search events, track price movements.
⬇ 232503 · by joelchance
Self-Improving + Proactive Agent
Self-reflection + Self-criticism + Self-learning + Self-organizing memory. Agent evaluates its own work, catches mistakes, and improves permanently. Use when...
⬇ 200423 · by ivangdavila
Github
Interact with GitHub using the `gh` CLI. Use `gh issue`, `gh pr`, `gh run`, and `gh api` for issues, PRs, CI runs, and advanced queries.
⬇ 191115 · by steipete
ontology
Typed knowledge graph for structured agent memory and composable skills. Use when creating/querying entities (Person, Project, Task, Event, Document), linkin...
⬇ 190156 · by oswalpalash

💬 Comments