search

hmhrex / Grav-MusicCard

A plugin for Grav that pulls in metadata from music sources.
MIT License
14 stars 2 forks source link
bandcamp grav grav-plugin metadata music soundcloud spotify

readme

Music Card

Place a Spotify, SoundCloud or Bandcamp link to an album or track in a markdown file and it will beautifully pull in the necessary data.

This uses jwilsson's Spotify Web API PHP library to interface with the Spotify API,w and Lokesh's Color Thief to retrieve colors from the album artwork.

The plan is to eventually support MusicBrainz links for albums that aren't on Spotify.

Usage:

Spotify Album:

![music-card](https://open.spotify.com/album/0wB19rOCyof5vPv6pYnCDH)

Greys Greys - Hover

Spotify Track:

![music-card](https://open.spotify.com/track/3I50P6a8P4c9SxIYSeZUhS)

Thrice Thrice - Hover

SoundCloud Track:

![music-card](https://soundcloud.com/hearspeakhere/gates)

Speak Speak - Hover

Bandcamp Album:

![music-card](http://thehotelier.bandcamp.com/album/home-like-noplace-is-there-2)

The Hotelier The Hotelier - Hover

Installation

  1. Create a Spotify Application.

  2. Create a SoundCloud Application.

  3. Copy this whole directory to your user/plugins directory.

  4. In the plugins settings, fill in the Client ID, Client Secret, and Redirect URI from your Spotify Application.

Thanks

Thanks to the Grav Team for writing the MediaEmbed plugin. I used this as a template to get things running at first