Now Playing API

A small API using Deno that will get the currently playing information for a user from Last fm and return it. It is designed to be easily deployed to Deno Deploy.

Getting Started

The easiest and only supported way to deploy this is to use Deno Deploy.

Magic

• Get your last.fm API Key from https://www.last.fm/api/accounts
• click the "Deploy on Deno" button above
• Click the "Add Environment Variables" button
• Add the following
  • add LASTFM_API_KEY with your API Key from Last.fm
  • add CONFIG_USER with the last.fm username
• Click "Create App"
• execute a get request to the URL to make sure it is working
• Party

Manual

• fork this repo
• create an account on and/or login to https://console.deno.com/
• Get your last.fm API Key from https://www.last.fm/api/accounts
• on the Deno Deploy dashboard click "New App"
• Connect Deno deploy to your GitHub account
• Select the fork of this repo you made
• Click the "Add Environment Variables" button
• Add the following
  • add LASTFM_API_KEY with your API Key from Last.fm
  • add CONFIG_USER with the last.fm username
• Click "Create App"
• execute a get request to the URL to make sure it is working
• Party

Developing

• Install Deno from https://deno.com/
• Get a Last.fm API Key from https://www.last.fm/api/accounts
• Clone this repo
• Created a .env file in the root of the project
  • add LASTFM_API_KEY with your API Key from Last.fm
  • add CONFIG_USER with the last.fm username
• run deno run dev

API

The only endpoint is

GET /

Arguments: none

Response:

Success:

application/json

{
    state: "success",
    data: {
      images: { src: string, size: "small" | "medium" | "large" | "extralarge" }[];
      artist: string;
      album: string;
      track: string;
      user: string;
      nowPlaying: boolean;
  }
}

Error:

application/json

{
    state: "error",
    data: string
}