Nitro Type - Universal Music Player

Play music from Spotify, YouTube & Apple Music while you race on Nitro Type. Paste any playlist, album, or track URL — playback is bridged through YouTube with album art, shuffle, session resume, and more.

You will need to install an extension such as Tampermonkey, Greasemonkey or Violentmonkey to install this script.

You will need to install an extension such as Tampermonkey to install this script.

You will need to install an extension such as Tampermonkey or Violentmonkey to install this script.

You will need to install an extension such as Tampermonkey or Userscripts to install this script.

You will need to install an extension such as Tampermonkey to install this script.

You will need to install a user script manager extension to install this script.

(I already have a user script manager, let me install it!)

You will need to install an extension such as Stylus to install this style.

You will need to install an extension such as Stylus to install this style.

You will need to install an extension such as Stylus to install this style.

You will need to install a user style manager extension to install this style.

You will need to install a user style manager extension to install this style.

You will need to install a user style manager extension to install this style.

(I already have a user style manager, let me install it!)

Author
[NTPD1] Captain.Loveridge
Daily installs
1
Total installs
63
Ratings
0 0 0
Version
2.1.1
Created
2026-02-28
Updated
2026-03-27
Size
299 KB
License
GPL-3.0-or-later
Applies to

Nitro Type - Universal Music Player

Play music from Spotify, YouTube, and Apple Music while you race on Nitro Type. Paste any playlist, album, or track URL and the script handles the rest — no accounts, logins, or API keys required.


How It Works

The script adds a custom music station to Nitro Type's existing music selector. Select it, paste a URL, and your music plays through YouTube in the background while you race.

Spotify and Apple Music tracks are automatically matched to YouTube equivalents using a multi-source search pipeline that strongly prefers studio-quality audio, especially Topic-channel results when available.


Supported Sources

Platform Tracks Albums Playlists
Spotify
YouTube
Apple Music

Features

Playback Controls

  • Play / Pause — toggle playback at any time
  • Next / Previous — skip forward or back through your queue
  • Shuffle — toggle shuffle mode on or off, with state remembered across sessions

Now Playing Display

  • Album art — shown inline next to the transport controls
  • Track title & artist — updated in real time as each track changes
  • Platform icon — shows the Spotify, YouTube, or Apple Music icon for the active source

Session Resume

Your playback session is saved as you listen. When you enter a new race or refresh the page, the script restores the same track, position, and shuffle state.

Smart YouTube Matching

When playing from Spotify or Apple Music, the script searches for the best YouTube match using multiple sources:

  1. YouTube Music
  2. Google fallback search
  3. YouTube search and alternate resolver fallbacks

Matches are ranked using channel quality, title similarity, artist match, and duration accuracy. Resolved video IDs are cached locally so repeat plays load much faster.

Error Recovery

  • Embed-blocked videos (Error 150 / 101) — automatically retries with an alternate match when possible
  • Background pre-resolution — resolves upcoming tracks ahead of time for smoother transitions
  • Large playlist support — supports long Spotify playlists through automatic pagination

Station Integration

The player integrates directly into Nitro Type’s built-in music selector. Your custom station appears alongside the native stations with matching inline controls.

Toast Notifications

Brief, non-intrusive notifications appear for key events like shuffle changes, source loads, and playback errors.

Mod Menu Integration

When installed alongside Nitro Type - Mod Menu, player settings are available from /settings/mods.


How to Use

  1. Install the script in Tampermonkey or another compatible userscript manager.
  2. Open any Nitro Type race page.
  3. Open the music selector in the race header.
  4. Select the custom music station.
  5. Click the link button in the transport controls.
  6. Paste a Spotify, YouTube, or Apple Music URL and save it.
  7. Start racing.

To change your source, open the link input again and paste a new URL. To stop playback completely, use Clear.


Console Commands

Open your browser console and use any of these:

Command Description
NTMusic.queue() Print the full queue with the current track highlighted
NTMusic.now() Print the current track, playback position, and YouTube video ID
NTMusic.status() Print version, active state, queue size, playback mode, and debug status
NTMusic.debug() Toggle verbose debug logging
NTMusic.debug(true) Enable verbose debug logging
NTMusic.debug(false) Disable verbose debug logging

Requirements

  • A userscript manager such as Tampermonkey or Violentmonkey
  • A modern browser such as Chrome, Edge, or Firefox
  • No account login or API key is required

Privacy & Permissions

The script makes direct requests to services needed to fetch source metadata and resolve YouTube playback candidates, including:

  • open.spotify.com / api.spotify.com
  • www.youtube.com / music.youtube.com
  • www.google.com
  • noembed.com
  • itunes.apple.com / music.apple.com

These requests are used only to read public track, playlist, and search data needed for playback. Preferences, cached matches, and session state are stored locally through your userscript manager and browser storage.


Troubleshooting

Music doesn't start playing?

  • Click somewhere on the page first. Browsers usually require a user interaction before allowing audio playback.
  • Try saving the URL again if the first resolution attempt stalls.

Wrong song is playing?

  • The script tries to find the best available YouTube match, but obscure, region-locked, or poorly labeled tracks may not always resolve perfectly.

Playlist won't load?

  • Private or restricted playlists may not be readable.
  • Apple Music playlist support depends on public page data being available.