Help:MixesDB userscripts
|
"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.
- groove.de: Podcast episode page [1]
- ra.co: Podcast episode page [2]
- ra.co: "Mix Of The Day" page [3]
- toxicfamily.de: article with player [4]
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 |
|
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.
BBC |
π Click to install or update |
NTS |
π Click to install or update |
1001 Tracklists
π Click to install or update
- Tracklist page with toolkit for various player sites and copy-ready tracklist [7]
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.
- Each embedded player (iframe) and mirror link available on relevant pages is checked for player URL usage on MixesDB.
Apple Music
π Click to install or update
- A mix page [8] with IDs. These are often used on live sets.
- A Mix CD page [9].
- A pre-release page [10] with missing durations (unavailable songs). No [CUE] minutes are added.
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.
- Copy-paste-ready formatted tracklists 1
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
- TrackId.net links below every compatible player (auto fill in the request form requires the TrackId.net userscript)
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
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.
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
- Player page with several added elements like the original image URL [13]
- Filter options to hide used players [14]
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
- Player page with several added elements like the original image URL [15]
- Player links on playlists pages [16]
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.
- The download button cannot be triggered so we only indicate that a download button exists in the regular dropdown.
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 [17]
- Mix page where the toolkit reads that the TID tracklist was integrated to the MixesDB mix page. [18]
- 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. [19]
- Handling of hearthis.at players on mix pages [20]
- In tables (search, "My Requests") a row is added to indicate which pages are marked as "tracklist integrated" and which do not. [21]
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.
- Copy-paste-ready formatted tracklists
- 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
- Toolkit with used player URL and short embed URL for copy-paste [22]
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.