Tidal Neptune Plugins

This is a repository containing plugins I have made for the Tidal Neptune Client.

Want to chat, ask questions or hang out? Join the discord! discord.gg/jK3uHrJGx4

If you like the project, and want to support me can to throw some bits at my Sponsor Page ❤️

To install any of these plugins you need to have the Tidal Neptune Client installed.

Then just paste the Install Url into the plugins page and hit enter.

My Public Plugins

You can see a list of all plugins including unreleased ones under the plugins directory

• TidalTags
• DiscordRPC
• Last.fm
• ListenBrainz
• RealMAX
• VolumeScroll
• CoverTheme
• NativeFullscreen
• Themer
• Always Exclusive
• Shazam Files
• NoBuffer
• Small Window
• Downloader

Other Plugin Repositories

• twnlink/neptune-plugins

Contributing

Contributing is super simple and really appreciated!

1. Ensure you have node and pnpm installed.
   Install NVM (https://github.com/nvm-sh/nvm?tab=readme-ov-file#installing-and-updating)

nvm install latest
nvm use latest
npm i -g pnpm

2. Clone the repo

git clone github.com/Inrixia/neptune-plugins
cd neptune-plugins

3. Install the packages

pnpm i

4. Start dev environment

pnpm run watch

5. Install dev plugins
   You can now install dev plugins in Neptune with the url http://localhost:3000/PluginName
   Changes will automatically rebuild so all you need to do is hit refresh in the Neptune plugins menu.

Plugins

Tidal Tags

Install Url:

https://inrixia.github.io/neptune-plugins/TidalTags

Adds

• Track Quality Tags next to song titles
• Sample Rate/Bit Depth/Bitrate information for currently playing track in the bottom right.
• Sample Rate/Bit Depth/Bitrate information for previously played tracks in library.

DiscordRPC

Install Url:

https://inrixia.github.io/neptune-plugins/DiscordRPC

Exactly what you think! Show off what you are listening to in your Discord status.

Last.fm

Install Url:

https://inrixia.github.io/neptune-plugins/LastFM

Scrobbles and sets currently playing for last.fm. Tidals default last.fm implementation can be very inaccurate, this tries to fix that with a focus on accuracy.

ListenBrainz

Install Url:

https://inrixia.github.io/neptune-plugins/ListenBrainz

Scrobbles and sets currently playing for ListenBrainz.

RealMAX

Install Url:

https://inrixia.github.io/neptune-plugins/RealMAX

Tidal oftern has multiple versions of the same song at different qualities. With RealMAX when playing a song if there is a version available at a higher quality it will automatically be added as the next song in the queue and skipped to. This ensures you are always listening to the best quality of a song

Volume Scroll

Install Url:

https://inrixia.github.io/neptune-plugins/VolumeScroll

Lets you scroll on the volume icon to change the volume by 10%. Can configure the step size, including different amounts for when you hold SHIFT.

Cover Theme

Install Url:

https://inrixia.github.io/neptune-plugins/CoverTheme

Theme Tidal based on the current playing songs cover art. Also adds CSS variables for the cover art to be used in custom themes.

Native Fullscreen

Install Url:

https://inrixia.github.io/neptune-plugins/NativeFullscreen

Add F11 hotkey for fullscreen to either make the normal UI fullscreen or tidal native fullscreen in a window!

Themer

Install Url:

https://inrixia.github.io/neptune-plugins/Themer

Create your own theme with a built-in CSS editor, powered by Monaco Editor. Press CTRL + E to open the editor, or go to Themer's plugin settings.

Always Exclusive

Install Url:

https://inrixia.github.io/neptune-plugins/AlwaysExclusive

While enabled will ensure that audio output is set to exclusive mode

Shazam Files

Install Url:

https://inrixia.github.io/neptune-plugins/Shazam

When enabled any files you drag onto your client will be run through Shazam and added to the current playlist!

NoBuffer

Install Url:

https://inrixia.github.io/neptune-plugins/NoBuffer

Kicks the Tidal cdn if the current playback stalls to make it stop so you never have to deal with constant stuttering or stalling again!

Small Window

Install Url:

https://inrixia.github.io/neptune-plugins/SmallWindow

Removes the minimum width and height limits on the window. Causes some UI bugs but can be useful if you want a smaller window.

Downloader

Install Url:

https://inrixia.github.io/neptune-plugins/SongDownloader

Adds a Download button to Songs, Playlists & Albums context menus. Supports selecting multiple songs.

Embeds full metadata including Lyrics & AlbumArtwork!

General
Complete name          : Pink Floyd - Wish You Were Here - Shine On You Crazy Diamond (Pts. 1-5).flac
Format                 : FLAC
Format/Info            : Free Lossless Audio Codec
File size              : 525 MiB
Duration               : 13 min 32 s
Overall bit rate mode  : Variable
Overall bit rate       : 5 416 kb/s
Album                  : Wish You Were Here
Album/Performer        : Pink Floyd
Track name             : Shine On You Crazy Diamond (Pts. 1-5)
Track name/Position    : 1
Track name/Total       : 5
Performer              : Pink Floyd
Recorded date          : 1975-09-15
ISRC                   : GBN9Y1100085
Copyright              : (P) 2016 The copyright in this sound recording is owned by Pink Floyd Music Ltd., marketed and distributed by Sony Music Entertainment
Cover                  : Yes
Cover type             : Cover (front)
Cover MIME             : image/jpeg
Lyrics                 : Remember when you were young? (Ha-ha-ha-ha) / You shone like the sun /  / Shine on, you crazy diamond /  / Now there's a look in your eyes / Like black holes in the sky /  / Shine on, you crazy diamond /  / You were caught in the crossfire / Of childhood and stardom / Blown on the steel breeze / Come on, you target for faraway laughter / Come on, you stranger / You legend, you martyr, and shine /  / You reached for the secret too soon / You cried for the moon /  / Shine on, you crazy diamond /  / Threatened by shadows at night / And exposed in the light /  / Shine on, you crazy diamond /  / Well, you wore out your welcome / With random precision / Rode on the steel breeze / Come on, you raver, you seer of visions / Come on, you painter / You piper, you prisoner, and shine
Comment                : http://www.tidal.com/track/55391798

Audio
Format                 : FLAC
Format/Info            : Free Lossless Audio Codec
Duration               : 13 min 32 s
Bit rate mode          : Variable
Bit rate               : 5 414 kb/s
Channel(s)             : 2 channels
Channel layout         : L R
Sampling rate          : 192 kHz
Bit depth              : 24 bits
Compression mode       : Lossless
Replay gain            : -2.90 dB
Replay gain peak       : 0.710358
Stream size            : 525 MiB (100%)
MD5 of the unencoded content: 1401A5C520F16BADDEA6670EFF08200B

Filename format values use tags. Available values you can use are found here:

neptune-plugins/plugins/_lib/makeTags.ts

Lines 68 to 87 in 0ca5ba6

	export const availableTags: (keyof FlacTags)[] = [
	"title",
	"trackNumber",
	"date",
	"copyright",
	"REPLAYGAIN_TRACK_GAIN",
	"REPLAYGAIN_TRACK_PEAK",
	"comment",
	"isrc",
	"upc",
	"musicbrainz_trackid",
	"musicbrainz_albumid",
	"artist",
	"album",
	"albumArtist",
	"genres",
	"organization",
	"totalTracks",
	"lyrics",
	];