hyper-spotify

Spotify plugin for Hyper.
Display currently playing song on Spotify at the bottom of the terminal and allows you to control your favourite music

Installation

Simply add this plugin inside ~/.hyper.js and enjoy your music 🎵

module.exports = {
  ...
  plugins: ['hyper-spotify']
  ...
}

Configuration

In your ~/.hyper.js you can define the following parameters to customize hyper-spotify appearance

modules.exports = {
  config: {
    ...
    hyperSpotify: {
      position: 'top', // or 'bottom'
      margin: 'default', // or 'double' or custom value
      controlsPosition: 'default', // or 'left' or 'right'
    },
    ...
  },
  ... 
};

Position

hyper-spotify bar supports 2 different positioning:

• top
• bottom (default)

Margin

hyper-spotify bar supports 3 margin options:

• default, should work most of the times
• double, when using other bar plugins (such as hyper-statusline or hyperline)
• custom value, specify a custom margin value as an interger (e.g. 30)

Controls position

hyper-spotify controls support 3 different positioning:

• default, controls appears just before the song details
• left, controls are fixed to the left side of Hyper window
• right, controls are fixed to the right side of Hyper window

Theme

hyper-spotify support different themes:

• default, A light theme with a Spotify Green (#1ED760) Spotify icon
• light, An white theme suitable for dark hyper themes
• dark, A deep-black theme suitable for light hyper themes
• special event themes (look for them if you really want to 😜)
• custom, A customizable theme (see below for more options)

Custom Theme

If you'd like to give a personal touch to hyper-spotify, you can use a custom theme and specify one or more of the theme colors

• overlayColor, the color to apply to hyper-spotify bar background, defaults to white (#FFF)
• iconColor, the color for every actionable icon, defaults to white (#FFF)
• spotifyIconColor, the color for the Spotify icon (visible when Spotify app is not running), defaults to iconColor (if specified) or to Spotify Green (#1ED760)
• textColor, track info color, defaults to white (#FFF)

Custom theme sample configuration, edit your ~/.hyper.js

modules.exports = {
  config: {
    ...
    hyperSpotify: {
      ...
      theme: 'custom', // important!
      overlayColor: '#000',
      iconColor: '#D75C1B',
      spotifyIconColor: '#1ED760',
      textColor: '#FFF'
    },
    ...
  },
  ... 
};

Limitations

Currently works only on macOS, Linux (Tested on Ubuntu 17.04), and Windows (with limited support).

Troubleshooting

Can't load hyper-spotify

Unfortunately this seems to be a common issue with Hyper plugins (see here zeit/hyper#191)

After installing hyper-spotify if Hyper complains about an error while enabling the plugin:

• do a full restart of Hyper app

if even after restaring the issue persists try running the following command

$ cd ~/.hyper_plugins && npm install

Related Projects

If you found this plugin of your interest or if you need to control other media players be sure to check out hyper-media-control by @OrionNebula

Credits

This plugin is inspired by atom-spotify2 and relies on

• spotify-node-applescript on macOS
• node-dbus on Linux
• spotilocal on Windows

to interact with Spotify client

Special Thanks

• @OrionNebula for Windows support initial implementation.