https://github.com/biancarosa/lastfm-last-played

Little lastfm widget to show your latest songs on your personal website.
https://github.com/biancarosa/lastfm-last-played

Last synced: 11 days ago
JSON representation

Little lastfm widget to show your latest songs on your personal website.

• Host: GitHub
• URL: https://github.com/biancarosa/lastfm-last-played
• Owner: biancarosa
• License: mit
• Created: 2020-07-16T22:20:59.000Z (over 4 years ago)
• Default Branch: main
• Last Pushed: 2024-04-17T01:50:17.000Z (7 months ago)
• Last Synced: 2024-04-17T07:24:13.741Z (7 months ago)
• Language: Python
• Homepage:
• Size: 109 KB
• Stars: 23
• Watchers: 1
• Forks: 1
• Open Issues: 5
• Metadata Files:
  • Readme: README.md
  • Contributing: CONTRIBUTING.md
  • License: LICENSE

Awesome Lists containing this project

README

        
![build-api](https://github.com/biancarosa/lastfm-last-played/workflows/build-api/badge.svg)

![deploy-api](https://github.com/biancarosa/lastfm-last-played/workflows/deploy-api/badge.svg)

[![codecov](https://codecov.io/gh/biancarosa/lastfm-last-played/branch/main/graph/badge.svg?token=SITY0HAB3T)](https://codecov.io/gh/biancarosa/lastfm-last-played)

# Last.fm Last Played Songs

# The Basics

## How it works

You can send a request to the API URL:

```bash

curl -s https://lastfm-last-played.biancarosa.com.br/{{your-lasfm-username}}/latest-song | jq

```

The query string `format` can receive the value `shields.io` for you to generate your own [Shields.io](https://shields.io/endpoint) markdown badge.

## Wanna use it?

### Markdown

[![Last.FM Last Played Song](https://img.shields.io/endpoint?color=blueviolet&url=https://lastfm-last-played.biancarosa.com.br/biahll/latest-song?format=shields.io)](https://github.com/biancarosa/lastfm-last-played)

```[![Last.FM Last Played Song](https://img.shields.io/endpoint?color=blueviolet&url=https://lastfm-last-played.biancarosa.com.br/{{your-lastfm-username}}/latest-song?format=shields.io)](https://github.com/biancarosa/lastfm-last-played)```

### JavaScript

There aren't any frontend packages written *yet* because I am not a very strong frontend developer, so pull-requests are welcome, but I've written an example using basic JavaScript [here](https://github.com/biancarosa/lastfm-last-played/blob/master/examples/index.html).

On my [own website](https://biancarosa.com.br/), it looks like this:

![Lastfm Last Played on my website](images/lastfm-last-played.png)

Code is [here](https://github.com/biancarosa/blog/blob/master/layouts/partials/extended_header.html).

## Like it?

Consider starring the repo, contributing to it and tweeting about it.

# Running the app

## Docker

[Docker](https://www.docker.com/) and [Docker Compose](https://www.docker.com/) make things easy!

```sh

docker-compose up

# or if you want to run detached

docker-compose up -d

```

## Natively

### The API

There is a comprehensive `Makefile` in the project that can be used.

```sh

# install dependencies

make

# runs the app

make run

# other commands

make lint

make test

make integration-test

make coverage

```