Skip to content

🎧 A collection of browser UserScripts that check track/album regional availability on music platforms (currently TIDAL + Qobuz) and show it in a sleek in-page panel β€” πŸ”Ž search, πŸ“‹ copy, 🏁 progress, 🧷 floating/minimize, ⭐ saved preferred countries.

Notifications You must be signed in to change notification settings

zxcvresque/Music-Availability

Folders and files

NameName
Last commit message
Last commit date

Latest commit

Β 

History

7 Commits
Β 
Β 
Β 
Β 

Repository files navigation

🎧 Music Availability β€” Various Platforms (Web Browser UserScripts)

Check whether a track/album is available in other regions on supported music platforms β€” directly on the official site, with a clean in-page panel (search, copy, progress bar, floating/minimize, persistent preferences).

Install TIDAL Β Β  Install Qobuz Β Β  Install Spotify


πŸ“š Table of Contents (click to expand)

πŸ“Έ Showcase

TIDAL

TIDAL Availability Panel

Qobuz

Qobuz Availability Panel

Spotify

Spotify Availability Panel


πŸ’‘ Why this exists

Licensing differs by country, so the same link can be available in one region and blocked in another.

This helps you quickly answer:

  • 🌍 β€œWhich countries have this track/album?”
  • 🚫 β€œWhere is it unavailable?”
  • 🧩 β€œWhich storefront/region should I check next?”
  • πŸ“‹ β€œGive me the region list so I can share it / document it.”

Perfect for curators, archivists, collectors, and anyone comparing catalogs across countries.


✨ Core UI/UX features

Shared across supported platforms for consistency:

  • ⚑ Auto-start scan after a short delay (page mounts first)
  • πŸ”Ž Search filter: Search (JP / Japan / United...) (ISO or country name)
  • πŸ“‹ Copy icons next to section titles (copies only visible results after filtering)
  • 🏁 Thin scanning progress bar + live Scanning… X/Y
  • 🧷 Floating panel toggle (bottom-right) + Minimize/Expand
  • πŸ’Ύ Remembers UI state globally (floating on/off + minimized)
  • ⭐ Advanced β†’ Preferred countries (choose default country(s) to always highlight; saved globally)
  • 🏳️ Flags + ISO chips with graceful fallback (flags auto-hide if blocked)
  • 🧠 Live results while loading, then final output is alphabetically sorted (Aβ†’Z) where applicable
  • πŸ“¦ Compact scroll containers for long country lists (especially Spotify)

🎡 Platforms

TIDAL

βœ… What it does

Checks TIDAL track/album availability across regions using TIDAL’s API (countryCode).

🌐 Supported URLs

  • tidal.com
  • www.tidal.com
  • listen.tidal.com

🌍 Region coverage

  • Scans 61 TIDAL-supported regions

πŸ” Login

  • βœ… No login required (guest-friendly token capture + fallback token)

βœ… What β€œavailable” means

A region is available if TIDAL’s API returns a valid response for that track/album under the given countryCode.

⬇️ Install (TIDAL)

Install TIDAL Β  View on Greasy Fork


Qobuz

βœ… What it does

Checks Qobuz track/album availability across official Qobuz storefront countries by loading localized product pages.

🌐 Supported URLs

  • qobuz.com
  • www.qobuz.com
  • open.qobuz.com
  • play.qobuz.com

🌍 Region coverage

  • Scans 26 official Qobuz storefront countries

πŸ” Login

  • βœ… No login required

βœ… What β€œavailable” means

A region is available if the localized Qobuz storefront page loads and looks like a valid product page (not an error / β€œnot available” page).

πŸ”— Bonus

  • βœ… Available chips open the matching Qobuz storefront page

⬇️ Install (Qobuz)

Install Qobuz Β  View on Greasy Fork


Spotify

βœ… What it does

Checks Spotify track/album availability across countries using the item’s available_markets.

🌐 Supported URLs

  • open.spotify.com

πŸ” Login

  • βœ… Works on the web player (guest mode is fine; token is fetched from Spotify web)

βœ… What β€œavailable” means

A country is available if it appears in Spotify’s available_markets list for that track/album.

⬇️ Install (Spotify)

Install Spotify Β  View on Greasy Fork


🧩 Requirements

You need a userscript manager:

Supported browsers:

  • βœ… Chrome / Chromium (Chrome, Edge, Brave, Opera, Vivaldi)
  • βœ… Firefox

▢️ How to use

General

  1. Install the script for your platform
  2. Open any track or album page
  3. The panel auto-starts after a short delay
  4. Use:
    • πŸ”Ž Search to filter
    • πŸ“‹ Copy to export region lists
    • 🧷 Floating/Minimize to keep it out of the way
    • ⭐ Advanced β†’ Preferred countries to highlight your defaults

πŸ› οΈ Troubleshooting

  • ❓ Panel not showing: ensure you’re on a real track/album page (not home/search).
  • 🏳️ Flags missing: your network may block flag hosts β€” ISO codes still work.
  • ⏳ Slow scan / occasional unknowns (TIDAL): rate limits happen; rerun by reloading the page.
  • 🧱 UI moved on SPA navigation: scripts auto-re-mount on navigation; if layout changes, open an issue/PR.

🀝 Contributing (PRs welcome)

Contributions are welcome β€” especially:

  • βž• adding more platforms (Deezer / Apple Music / Amazon / etc.)
  • 🧼 UI consistency improvements (keep it clean + compact)
  • πŸš€ performance optimizations that don’t reduce correctness
  • πŸ§ͺ edge-case fixes for new layouts / endpoints

🧡 How to contribute

  1. Fork the repo
  2. Create a branch: feature/your-change
  3. Commit your changes
  4. Open a PR with a clear description (screenshots appreciated for UI changes)

🧾 Credits

Made by Zxcvr.

About

🎧 A collection of browser UserScripts that check track/album regional availability on music platforms (currently TIDAL + Qobuz) and show it in a sleek in-page panel β€” πŸ”Ž search, πŸ“‹ copy, 🏁 progress, 🧷 floating/minimize, ⭐ saved preferred countries.

Topics

Resources

Stars

Watchers

Forks