Help:MixesDB userscripts

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

Features

The following userscripts help MixesDB contributors with their daily copy-paste work:

• 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 and useful
• 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.

⚠️ The userscripts are currently being overhauled. The screenshots below may be outdated and not match the current feature descriptions, which are updated automatically.

Quick overview

Userscript	Install / update	Target website type	Players		Copy-paste tracklist	Toolkit
			MixesDB supported	Multiple		Player usage	Hide used
Player Checker	Update	Websites with embedded players	yes		no	yes	no
1001 Tracklists	Update	Tracklist generation	yes		yes	yes	not possible
Apple Music	Update	Mix source	yes	no	yes, but not formatted	restricted
Apple Podcasts	Update	Mix source	yes	no	no	restricted
BBC	Update	Mix source	no		yes	no
Discogs	Update	Mix source	no		yes	no
hearthis.at	Update	Player site	yes	no	no	yes	no
Internet Archive	Update	Player site	yes	no	no	yes	no
Mixcloud	Update	Player site	yes	no	no	yes
MixesDB Userscripts Helper	Update	On MixesDB	no		no	no
NTS	Update	Mix source	no		yes	no
RA	Update	Mix source	yes	no	yes	yes	no
SoundCloud	Update	Player site	yes	no	no	yes
The Lot Radio	Update	Mix source	no		yes	no
TrackId.net	Update	Tracklist generation	yes		yes	yes	no, but indicated via "MixesDB integration"
Tracklist Merger (Beta)	Update	On MixesDB, on TrackId.net	no	no	no	no	no
Tracklist Cue Switcher	Update	On MixesDB, on TrackId.net	no		no	no
YouTube	Update	Player site	yes	no	no	yes	no

Private userscripts	Install / update	Description
Episodes Importer		For show or podcast websites this adds buttons on episode listings to view or create pre-filled mix pages. This is useful for shows and podcasts of which many episodes are still missing on MixesDB, not for adding 1 new mix per week. The episodes on the website need to be numbered or read the date we sue for the mix pages.
Hernan Cattaneo Resident	Update	Mix pages for Category:Resident (Show) from podcast.hernancattaneo.com README
IA MIX	Update	Mix pages for Category:IA MIX from inverted-audio.com/mix README
Player URLs		Adds missing player URLs from a pre-defined array of URLs and the episode number or date matching MixesDB mix pages. The mixesdb.com part does the auto-save and "Edit all pages" link on MixesDB:Explorer/Lists (query pages not the category for player site players). Matching IDs or date of the array with the MixesDB page titles happens with regex in the userscript. Adjust for each new category name.
Apple Podcasts	Update	The IDs are listed in the console log. Use that to build the ID array in the userscript. README
YouTube	Update	Does not run on youtube.com (Chrome not supported, Safari is a mess). Thus the ID array can be created using an .sh script with yt-dlp. The txt file tries to normalize the YouTube title keys to only the episode number or date, then sorts the items. For raw yt-dlp results use the script option cleanup=false. Copy the array to the userscript manually. README

Shared features

Tracklist box

Loading this section from GitHub…

Toolkit

Loading this section from GitHub…

Page creator

Loading this section from GitHub…

Site specific userscripts

Userscripts that target one specific website.

1001 Tracklists

👉 Click to install or update

• 

  Tracklist page with toolkit for various player sites and copy-ready tracklist [1]

Loading this section from GitHub…

Planned features

• Consider "Switch cue format" button
• Add link to Tracklist Merger

Apple Music

👉 Click to install or update

• 

  A mix page [2] with IDs. These are often used on live sets.
• 

  A Mix CD page [3].
• 

  A pre-release page [4] with missing durations (unavailable songs). No [CUE] minutes are added.

Loading this section from GitHub…

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).

Apple Podcasts

👉 Click to install or update

• 

  Episode page
• 

  Podcast page
• 

  Search results page

Loading this section from GitHub…

hearthis.at

👉 Click to install or update

• 

  Player page with used player URL [5]
• 

  Player page with unused player URL [6]

Loading this section from GitHub…

Internet Archive

👉 Click to install or update

• 

  Single file page [7]
• 

  Collection page with details for each file [8]
• 

  Dead page with no embed URL to check [9]

Loading this section from GitHub…

Mixcloud

👉 Click to install or update

• 

  Player page with several added elements like the original image URL [10]
• 

  Expanded "File details" table and API
• 

  Filter options to hide used players [11]

Loading this section from GitHub…

RA

👉 Click to install or update

• 

  Top section of a podcast page using toolkit, original artwork info and the tracklist moved up from the bottom [12]
• 

  Copy-paste tracklist on a podcast page [13]
• 

  Artist profile page with name action icons to copy the name or search it on MixesDB (sam functionality for venue pages)[14]
• 

  Event page with name action icons and flyer image info [15] [16]

Loading this section from GitHub…

SoundCloud

👉 Click to install or update

• 

  Player page with several added elements like the original image URL [17]
• 

  Expanded "File details" table and API
• 

  Toolkit: When the player URL is not used on MixesDB, a link to search the player title is added. [18]
• 

  Profile page with hiding and filter options on top, highlighted titles for favorited players and an remove icon for each player [19]
• 

  Feed page with hiding and filtering options to find new hot mixes [20]
• 

  Player links on playlists pages [21]
• 

  Player links in compact playlists (e.g. on playlists pages) [22]

Loading this section from GitHub…

Known issues

• On player pages
  • 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.

• 

  Mix page with embedded player, toolkit and copy-ready tracklist [23]
• 

  Mix page where the toolkit reads that the TID tracklist was integrated to the MixesDB mix page. [24]
• 

  Toolkit information that the page was created after the matched MixesDB page was last edited. This can also appear on tracklists marked as integrated, i.e. when the TID tracklist had no new tracks, thus no edit was made. [25]
• 

  Handling of hearthis.at players on mix pages [26]
• 

  In tables (search, "My Requests") a row is added to indicate which pages are marked as "tracklist integrated" and which do not. [27]

Loading this section from GitHub…

Planned features

• Search pages [44]: 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)

YouTube

👉 Click to install or update

• 

  Toolkit with used player URL and short embed URL for copy-paste [28]
• 

  TID playlist submit link on a playlist page [29]
• 

  TID playlist submit link in the sidebar of a playing video [30]

Loading this section from GitHub…

Combined userscripts

Userscripts that are working on multiple websites or small single purpose scripts that are grouped here.

MixesDB Userscripts Helper

👉 Click to install or update | README

• 

  TrackId.net links below every compatible player (auto fill in the request form requires the TrackId.net userscript)
• 

  Explorer result with Apple Podcasts and TID links under each compatible player
• 

  Apple Podcasts search icon in mix page title icons

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 TID compatible players + no or incomplete tracklist + 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

• mix page title icons
• result titles on MixesDB:Explorer/Mixes

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.

Player Checker

👉 Click to install or update

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

• 

  finn-johannsen.de: Toolkit and copy-paste tracklists on multiple posts pages and single page support [31]
• 

  groove.de: Podcast episode page [32]
• 

  ra.co: Podcast episode page [33]
• 

  ra.co: "Mix Of The Day" page [34]
• 

  toxicfamily.de: article with player [35]
• 

  wearesoundspace.com: podcast episode page [36] [37]

Loading this section from GitHub…

Supported websites

Websites	Applied page types	Known issues
finn-johannsen.de	Mix posts. incl. including copy-paste tracklists	On posts with multiple mixes, it cannot distinguish between "mixes" so all players belong to one check (example post).
groove.de	Podcast episodes
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.

• 

  Example: BBC returns an ugly format on copy-paste.
• 

  With our BBC userscript the tracklist gets added to a textarea on top from which you can copy it easily.

BBC	👉 Click to install or update	README [45]
Discogs	👉 Click to install or update	README Mix CDs: [46] [47] [48] [49] [50] [51] Albums and EPs: [52] [53] [54] [55] [56] [57]
The Lot Radio	👉 Click to install or update	README Feedback: OK, warnings
NTS	👉 Click to install or update Including timestamps for subscribed users	README [58]
radioeins	👉 Click to install or update	README [59]

Tracklist Cue Switcher

👉 Click to install or update

• 

  Click a cue to toggle between different cue formats. [38] [39] [40] [41] [42] [43]

Loading this section from GitHub…

Known issues

• It cannot forget last alternative format. I.e. once used, you cannot always load the page's original format by default.
• Might interfere with the track toggle feature caching (when cue is switched before cache saving current view)

Tracklist Merger (Beta)

👉 Click to install or update

Loading this section from GitHub…