hifi-download

Original：🇺🇸 English
Translated
28 scripts

Discover music, get personalized recommendations, and download high-fidelity audio files. Use when user wants to find new music based on their taste, search for songs/albums/artists, get recommendations similar to artists they like, or download lossless audio (FLAC/Hi-Res) from Qobuz or TIDAL. Trigger phrases include "find music like", "recommend songs", "download album", "lossless", "Hi-Res", "FLAC", "music discovery", "similar artists", "setup music".

4installs
Sourcepsylch/media-master
Added on

NPX Install

npx skill4agent add psylch/media-master hifi-download

Tags

Translated version includes tags in frontmatter
music-discoveryhi-res-audio-downloadcli-toolspotify-integrationqobuz-tidal-support

SKILL.md Content

View Translation Comparison →

MusicMaster

Music discovery (Spotify, Last.fm) and Hi-Res audio downloads (Qobuz, TIDAL) through a unified CLI.
All commands use 
bash ${SKILL_PATH}/run.sh <script> [args...]
, which activates the venv and runs the corresponding Python script. Output is human-readable by default; use 
--json
where supported for structured output.

First-Time Setup

Step 1: Check Dependencies

bash
bash ${SKILL_PATH}/scripts/setup.sh check
Output is key=value pairs. If 
VENV=missing
, run install first.

Step 2: Install

bash
bash ${SKILL_PATH}/scripts/setup.sh install [--with-qobuz] [--with-tidal]
Creates 
.venv
, installs core dependencies (
spotipy
, 
pylast
, 
requests
, 
python-dotenv
), and optionally installs download backends.

Step 3: Configure Credentials

IMPORTANT: Do NOT ask the user for credentials in chat. Instead:
  1. Create 
    .env
    from template if not exists: 
    cp ${SKILL_PATH}/.env.example ${SKILL_PATH}/.env
  2. Tell user to edit 
    ${SKILL_PATH}/.env
    with their credentials
  3. Wait for confirmation, then verify
Alternatively, use the config script:
bash
bash ${SKILL_PATH}/run.sh setup_config --lastfm-key=KEY [--spotify-id=ID --spotify-secret=SECRET] [--qobuz-email=EMAIL --qobuz-password=PASS]
Where to get credentials:

Step 4: Verify

bash
bash ${SKILL_PATH}/run.sh status
Shows which services are READY, DISABLED, or need setup. Only use services marked READY.

Service Types

TypeServicesPurpose
DiscoverySpotify, Last.fmSearch, recommendations, similar artists
DownloadsQobuz, TIDALHigh-quality audio (FLAC, Hi-Res)

Discovery Commands

Last.fm — Similar Artists

bash
bash ${SKILL_PATH}/run.sh lastfm_artists "Radiohead"
Returns a list of similar artists with match scores.

Last.fm — Similar Tracks

bash
bash ${SKILL_PATH}/run.sh lastfm_tracks "Karma Police" "Radiohead"
Arguments: track name, then artist name.

Last.fm — Taste Profile

bash
bash ${SKILL_PATH}/run.sh lastfm_taste
Returns the user's top artists and tracks from listening history.

Spotify — Search

bash
bash ${SKILL_PATH}/run.sh spotify_search "OK Computer"
Searches Spotify catalog for tracks, albums, and artists.

Spotify — User Library

bash
bash ${SKILL_PATH}/run.sh spotify_user tracks|artists
Gets the user's saved tracks or followed artists (requires OAuth).

Spotify — Track/Album Info

bash
bash ${SKILL_PATH}/run.sh spotify_info SPOTIFY_URI_OR_ID

Download Commands

Search Platform Catalog

bash
bash ${SKILL_PATH}/run.sh platform_search "Album Name" -p qobuz|tidal
Searches the download platform's catalog. Returns IDs for use with download command.

Download (async — returns immediately)

bash
bash ${SKILL_PATH}/run.sh platform_download ID -p qobuz|tidal -t album|track
Queues the download in a background process and returns a 
download_id
immediately. The agent is free to continue other work. Use 
download_status
to poll progress.
To block until the download completes (legacy behavior):
bash
bash ${SKILL_PATH}/run.sh platform_download ID -p qobuz -t album --sync

Check Download Status

bash
bash ${SKILL_PATH}/run.sh download_status DOWNLOAD_ID
bash ${SKILL_PATH}/run.sh download_status --all
bash ${SKILL_PATH}/run.sh download_status --active
bash ${SKILL_PATH}/run.sh download_status --json
Poll the status of a specific download or list all downloads. Use 
--active
to show only pending/in_progress tasks. Use 
--json
for structured output.

Open Download Dashboard

bash
bash ${SKILL_PATH}/run.sh download_ui
Opens a web dashboard at 
http://localhost:8765
showing real-time download status with progress bars. Auto-refreshes every 3 seconds.

Service Management

Disable a Service

bash
bash ${SKILL_PATH}/run.sh disable_service spotify --reason "No account"

Enable a Service

bash
bash ${SKILL_PATH}/run.sh enable_service spotify

Workflow — Music Discovery

  1. Run 
    status
    to check available services
  2. Use 
    lastfm_artists
    or 
    lastfm_tracks
    to find similar music
  3. Use 
    spotify_search
    to look up specific tracks/albums
  4. Present results to user in a clear table format
  5. If user wants to download, use 
    platform_search
    → 
    platform_download

Workflow — Download Hi-Res Audio

  1. Run 
    status
    to confirm download service is READY
  2. Search: 
    platform_search "Album Name" -p qobuz
  3. Present results with quality info
  4. Download: 
    platform_download ID -p qobuz -t album
    (returns download_id immediately)
  5. Tell user download is queued, optionally open 
    download_ui
    for visual monitoring
  6. Poll with 
    download_status DOWNLOAD_ID
    until completed
  7. Report download path and file size to user

Error Handling

ErrorDetectionResolution
Venv missing
run.sh
exits with 
venv_missing
Run 
bash ${SKILL_PATH}/scripts/setup.sh install
Service not configured
status
shows 
NOT CONFIGURED
Guide user to edit 
.env
or run 
setup_config
Spotify OAuth expiredSpotify commands fail with auth errorRun 
bash ${SKILL_PATH}/run.sh spotify_auth
to re-authorize
TIDAL token expired
status
shows 
ERROR
for TIDAL		Run 
tiddl auth refresh
or 
tiddl auth login
in venv
Service disabled by user
status
shows 
DISABLED
Run 
enable_service
if user wants to re-enable
No resultsSearch returns emptyTry different keywords or check service availability

Important Notes

  • Spotify requires OAuth browser flow on first use (
    spotify_auth
    script handles this)
  • TIDAL auth is managed by 
    tiddl
    CLI tool, not stored in 
    .env
  • Qobuz credentials are stored in 
    .env
    (sensitive — ensure file is in 
    .gitignore
    )
  • Download paths default to 
    ~/Music/Qobuz
    and 
    ~/Music/TIDAL
  • Quality settings: Qobuz 27=Hi-Res 24-bit (highest), TIDAL HiFi=lossless