tayouvr / universal-np Goto Github PK

A now playing tool intended to be used with OBS.

Spiritual successor to EssentialNowPlaying

My reason for rewriting EssentialNowPlaying is because I still wanted to support it, but I no longer had much interest in C#. I know that Electron apps are somewhat controversial (this app takes up ~40MB whereas the C# app took ~10MB), but this is the version that I would rather maintain long-term. There were some nasty bugs in the C# version that I was just not willing to invest the time needed to fix.

The usage of the program remains very similar.

Currently supported:

• Desktop (Windows [tested], *NIX [untested]):
  • Spotify
  • iTunes
  • VLC
  • MPC-HC
  • MPC-QT (rip)
  • foobar2000
  • mpv
  • Google Play Music Desktop Player
• WebApps:
  • Mixcloud
  • Spotify web player (play.spotify.com)
  • Soundcloud
  • Tunein
  • YouTube
  • Pandora
  • Google Play (play.google.com)
  • Deezer
  • Bandcamp
  • Hype Machine
  • Plex
  • YouTube Music
  • Tidal

Pull requests welcome to add player support. I could also use some Mac/Linux testers.

Download the installer from the Releases page. Double click and away you go.

To use the WebApps, you'll need install the companion extension from the web store. Here's a link to it: https://chrome.google.com/webstore/detail/universal-now-playing-com/lljahlkpnhdopaegadghfjhhkcpdlijg.

Extension repo here: https://github.com/pendo324/universal-np-extension

To use the WebApps you need to do the following:

1. Open Universal Now Playing
2. Select the Player and set the file path in the Settings tab
3. Head to any supported web player
4. Click on the Now Playing Companion Extension and "Use on this page"
5. On the web pop-up click "Start"
6. Go back to Universal Now Playing app and hit "Start"

Be sure that the desktop application is running before activating the extension.

To build, just install the dependencies (npm i/yarn) and then run the build script, e.g. npm run electron:build.