Help:MixesDB userscripts

From MixesDB
(Redirected from Help:Pimp scripts)
Jump to navigationJump to search

"MixesDB userscripts" are a collection of userscripts, that change the look and behaviour of certain websites or add additional information.

Some websites use tracklist formats which make it impossible to detect the artist, track and label after copy-pasting in the Tracklist Editor.

Therefor you can use a browser add-on that changes the website content using Javascript and CSS.

Features

The userscripts below add various things:

  • Copy-paste-ready formatted tracklists
  • URLs for highest resolution artwork
  • Player URLs in the format MixesDB embeds them with the player template
  • API information whenever available
  • On player sites and websites using widget players: Search if MixesDB uses these players as well and link to the mix page
  • Offer a link to submit a player URL to TrackId.net whenever possible
  • On player sites: Filter to find new mixes that are not used on MixesDB

Getting started

Before you can install a userscript you need to add a userscript addon for your browser. We had bad experiences with Greasemonkey so we stick with Tampermonkey as it's avaiable for all major browsers: tampermonkey.net

After installing the browser addon, you can install the userscripts by just clicking πŸ‘‰ Click to install or update below.

If you're running script blocker addons like "ScriptSafe" or "NoScript" and you see no changes or things don't seem to work:

  • Allow scripts from www.mixesdb.com (if tracklists or the toolkit are added).
  • Try allowing some major scripts from that website and reload the page.

Automatic updates: The scripts are under continuous development. Enable automatic script updates in your addon to get the latest version automatically.

We inform about updates on Discord where you can also report bugs, get support and request features.

Quick overview

Userscript Update Website type Players Copy-paste
tracklist
Toolkit Browser
support
MixesDB
supported
Multiple Player usage Hide used
Player Checker Update / yes no yes no All
1001 Tracklists Update Tracklist generation yes yes yes not possible All
Apple Music Update Mix source yes no yes, but not formatted restricted All
Apple Podcasts Update Mix source yes no no restricted All
BBC Update Mix source no yes no All
hearthis.at Update Player site yes no no yes no All
Internet Archive considered Player site yes no no considered All
Mixcloud Update Player site yes no no yes All
MixesDB Userscripts Helper Update / no no no All
NTS Update Mix source no yes no All
SoundCloud Update Player site yes no no yes All
TrackId.net Update Tracklist generation yes yes yes no, but indicated via
"MixesDB integration"
All
Tracklist Merger (Beta) Update / no no no no no All
YouTube Update Player site yes no no yes no All,
except Chrome

Planned features

  • Fix readability issues when the websites uses OS light mode design variants.

Player Checker

πŸ‘‰ Click to install or update

This userscript is activated on various blogs, podcast and radio show websites and looks for player widgets to search if these player URLs are used in MixesDB mix pages.

Features

Depending on the search result the toolkit will return:

  • A link to the MixesDB mix page that uses the player URL or links to the current page
  • A link to search the player title or current page title
  • Links to the player URLs alongside TrackId.net submit request links

Supported websites

Websites Applied page types Known issues
groove.de Podcast episodes
ra.co all pages
  • This userscript reloads the page on every URL change. This can happen a few milliseconds after the page already loaded initially. If this flickering annoys you: Enable the userscript only when needed.
toxicfamily.de articles
wearesoundspace.com podcast episodes, articles

Excluded are player websites from the dedicated userscripts below which have the toolkit integrated directly.

See the player comparison table for which player widget will work with the toolkit.

Please post on Discord …

  • if you see players being ignored on a supported website (post page link)
  • if your favorite blog or podcast page is not supported

Tracklist only websites

Podcast and radio show websites for which we only add the pre-formatted tracklist.

BBC

πŸ‘‰ Click to install or update

NTS

πŸ‘‰ Click to install or update

1001 Tracklists

πŸ‘‰ Click to install or update

Features

  • Remove the adblocker notice
  • Tracklist pages:
    • Copy-paste-ready formatted tracklists
    • Toolkit:
      • Each embedded player (iframe) and mirror link available on relevant pages is checked for player URL usage on MixesDB.
        Supported player sites from embedded iframes and links: hearthis.at, Mixcloud, SoundCloud, YouTube
        If you stumble upon players or links that are not reported in the toolkit, please post on Discord.
      • Add info when the page was created after the last edit of the matched MixesDB page. This is only rarely the case.

Apple Music

πŸ‘‰ Click to install or update

Features

  • On albums
    • Copy-paste-ready formatted tracklists 1
      If all tracks have durations, the [CUE] minutes are calculated. You can toggle a control version of the tracklist.
    • For max resolution artwork URLs use Image Max URL.

Planned features

  • On albums
    • Add a "File details" toggle for the total duration.
    • Fix dark textarea with OS light mode.
    • Instead of leading the tracklist area on all pages, add a user option to append a button to the header area (less flickering).

Known issues

  • This userscript reloads the page on every URL change. This can happen a few milliseconds after the page already loaded initially. If this flickering annoys you: Enable the userscript only when needed.
    The hard reload also collapses the playlist tree.
  • We cannot use the toolkit, because *.apple.com doesn't allow API calls to external websites (www.mixesdb.com).
  • 1 The tracklists cannot be pre-formatted with the Tracklist Editor API, because music.apple.com restricts calling external resources. Copy-paste it manually to the Tracklist Editor.

Apple Podcasts

πŸ‘‰ Click to install or update

Features

  • Make links draggable. Add an input with the URL and auto-select it.
    • Add episode URLs to each episode on show pages and search results (top result URL is selected)
    • Add the current page URL to podcast page headers and episode page headers
  • On search pages make the search input more usable for longer text (mix page titles)
  • Icon links to search episode titles on MixesDB

Known issues

  • We cannot use the toolkit, because *.apple.com doesn't allow API calls to external websites (www.mixesdb.com).

hearthis.at

πŸ‘‰ Click to install or update

Features

  • Toolkit:
    • A MixesDB usage link or title search link is added.
    • A TrackId.net submit link is added.
    • The embed URL is added for copy-paste.

Known issues

  • This userscript reloads the page on every URL change. This can happen a few milliseconds after the page already loaded initially. If this flickering annoys you: Enable the userscript only when needed.

Internet Archive

Considered for later.

Planned features

  • Add toolkit for audio detail pages and collections [23].

MixesDB Userscripts Helper

πŸ‘‰ Click to install or update

This userscript changes the look and behaviour of the MixesDB website, mainly to enable features usable by other MixesDB userscripts.

This userscripts uses user settings which can be enabled in variables on top of the script. After an update they're reset to their default value.

TrackId.net features

On MixesDB mix pages and on MixesDB:Explorer/Mixes a TrackId.net link is added below every compatible player. It's either a submit link or a page link with info if the tracklist has been integrated to MixesDB.
The submit link is highly effective when you have a TID premium account and want to submit many player URLs for the community. Example query: Newly added pages with players and no or incomplete tracklist and at least 1 hotness star

Inserting the keywords to search and the player URL into the form requires the userscript TrackId.net.
Submitting player URLs requires a TID premium account.

All this can be disabled in the user setting variables.

Apple Podcasts search

Apple Podcasts episode pages are not indexed on Google, only the show pages. This means the Player search on mix pages will not find Apple Podcast players.

So an icon to search the mix page title in Apple Podcasts directly is added to

All this can be disabled in the user setting variables.

Apple Music links in browser

An optional feature for those who prefer Apple Music results in tracklists to open in the browser instead of the Apple Music app. For example at work or when you use multiple local Music libraries on your Mac.

These features are all optional and enabled by a user setting on top of the userscript:

  • Open links in browser:

    var appleMusic_linksOpenInBrowser

    Remove the URL parameter &app=music from album links (search links don't have this by default).
    Using this also changes the URL from music.apple.com to beta.music.apple.com, which enforces bypassing the Music app and makes it actually usable in the browser with features like adding to playlists.

    You can always click with CMD+CLICK to bypass the Music app.
  • Force your country code:

    var appleMusic_countryCode_switch

    By default album results link to the US version (music.apple.com/us/album/...). But when you live somewhere else, you only can use previews (even if logged in). Then you'd always need to switch to your country manually. Set your own country code to avoid all this.

Example settings with links opening in the browser enabled, Germany as country code and browser links with Beta enabled:

var appleMusic_linksOpenInBrowser = 1;
var appleMusic_countryCode_switch = "de";

So with links opening in the Music app disabled, clicking an album link in a tracklist will open e.g.
https://beta.music.apple.com/de/album/double-standard/1741549977?i=1741550406 in a new tab instead of
https://music.apple.com/us/album/double-standard/1741549977?i=1741550406.

Planned features

  • On Explorer/Mixes: If query is "Mixes on TrackId.net but not yet integrated", make the TID icon link to the TID page, instead of submitting (API call needed).

Known issues

  • TrackId.net
    • Quicker "Submit Request": When you open the link in the background, the URL is not added to the submit form (TID has a poor user interface…).

Mixcloud

πŸ‘‰ Click to install or update

Features

  • On player pages
    • Link to search the page title on MixesDB
    • Artwork: Add a link to the original version (for MixesDB upload)
    • Link to toggle the full API details
    • Duration link to toggle the "File details" table
    • Toolkit:
      • A MixesDB usage link or title search link is added.
      • A TrackId.net submit link is added.
      • The embed URL is added for copy-paste.
  • On profile streams:
    • Add filter options on stream pages to hide used players

Known issues

  • This userscript reloads the page on every URL change. This can happen a few milliseconds after the page already loaded initially. If this flickering annoys you: Enable the userscript only when needed.

SoundCloud

πŸ‘‰ Click to install or update

Features

  • On player pages:
    • Large copy-ready title and creation date
    • Link to search the page title on MixesDB
    • Artwork: Add a link to the original version (for MixesDB upload)
      PNG artwork is limited to max. 500px
    • Indicator for available download in the dropdown menu
    • Action buttons:
      • Remove text from default buttons
      • Link to toggle the full API details
      • Duration link to toggle the "File details" table
      • Toolkit:
        • A MixesDB usage link or title search link is added.
        • A TrackId.net submit link is added.
        • The embed URL is added for copy-paste.
  • On feed and profile streams:
    • Add an [X] icon to remove players on streams
    • Filter options to hide:
      • "Playlists" / "Reposts": > Find just tracks / mixes
      • "Favs": Players you have favorited > Find unfavorited players
      • "Used": Players that are used on MixesDB > Find players that can be added to MixesDB
  • Highlight favorited players
    on feed stream, profile streams, playlist sets
  • Player links open in a new tab and without ?in= parameter
    on playlist pages, in compact playlists, in system playlists (user recommendations)

Planned features

  • On stream lists request the duration of players to e.g. hide short tracks (requires an API call for each track).

Known issues

  • This userscript reloads the page on every URL change. This can happen a few milliseconds after the page already loaded initially. If this flickering annoys you: Enable the userscript only when needed.
  • On player pages
    • The download button cannot be triggered so we only indicate that a download button exists in the regular dropdown.
      The download URL could be retrieved via an additional API call.
    • The audio file size is no more included in the API details. Theoretically it could be received by the same additional API call for the download URL.

TrackId.net

πŸ‘‰ Click to install or update

TrackId.net ("TID") is currently the best tool to retrieve automated tracklist generation via player URLs.

Unfortunately a premium account is required to submit new URLs (20 GBP / year). But there are over 230K existing pages and this userscript makes all tracklists copy-paste-ready.

See also MixesDB Userscripts Helper for more TID features on MixesDB.

Features

  • On TID mix pages:
    • Copy-paste-ready formatted tracklists
      • Country codes in artist names are removed (e.g. Artist (US)).
      • Pointless versions like "Radio Edit" and "Album Version" are removed.
    • Toolkit:
      • A MixesDB usage link or title search link is added for the page player.
      • "TID tracklist is integrated" marker to reflect that a mix is compared and integrated to the MixesDB tracklist.
        In detail: A green checked icon means, that he tracklist has been copied or new tracks / duration / label names have been added to the MixesDB mix page. So other users can simply ignore checked pages on TrackId.net. In tables (search, "My Requests") an indicator column is added.
        Only TID pages can be marked whwn the player is used on a MixesDB mix page.
      • Add info when the page was created after the last edit of the matched MixesDB page.
  • On the page "Submit Request": Insert the player URL from the URL parameter provided by the userscript MixesDB Userscripts Helper after clicking the TrackId.net page icon on a mix page.
    After "validating" the player URL:
    • If a TID page exists for that player URL, you are redirected to that page (where you can copy the tracklist).
    • Else you directly submit the player URL (which is what you came for).
  • Shorter menu and quick links to request pages

Planned features

  • Search pages [24]: Option to show the regular table instead (only the regular results are sortable) (fixes the current workaround of showing both)
  • Default tracklist tables: Link to search each track title on YouTube
  • Check if the "change history" tab has new tracks since last check marking (requires undo function / or refresh marking to generate new timestamp)

Known issues

  • This userscript reloads the page on every URL change. This can happen a few milliseconds after the page already loaded initially. If this flickering annoys you: Enable the userscript only when needed.
  • "Quicker Submit Request": The "Validate" button cannot be triggered via script.

YouTube

πŸ‘‰ Click to install or update

Features

  • On video player pages:
    • Duration link to toggle the "File details" table
    • Toolkit:
      • A MixesDB usage link or title search link is added.
      • A TrackId.net submit link is added.
      • The embed URL is added for copy-paste.
    • Add the video thumbnail as linked image. Please note these are rarely useful as artwork upload for MixesDB.

Known issues

  • The script does not work in Chrome (they block external requests on YouTube, as viewable in the console error "This document requires 'TrustedHTML' assignment.").
  • This userscript reloads the page on every URL change. This can happen a few milliseconds after the page already loaded initially. If this flickering annoys you: Enable the userscript only when needed.