ListenFrame is a web application that provides a personalized overview of your listening habits, pulling data directly from ListenBrainz. Simply enter your ListenBrainz username, select a time range, and explore your top artists and releases.

Idea#

The core idea behind ListenFrame is to offer a clean and interactive interface to visualize your listening statistics from ListenBrainz. It allows users to quickly see their most listened-to artists and albums over various periods, providing insights into their musical journey.

Data Fetching#

ListenFrame aggregates data from several sources to provide a rich user experience:

ListenBrainz API (https://api.listenbrainz.org): This is the primary data source for fetching your personal listening statistics, including top artists and releases.
Cover Art Archive (https://coverartarchive.org): Used to retrieve album cover art for your top releases.
MusicBrainz API (https://musicbrainz.org): Utilized to fetch artist metadata and link to external resources like Wikidata.
Wikidata API (https://www.wikidata.org): Helps in finding image information for artists.
Wikimedia Commons API (https://commons.wikimedia.org): Provides the actual image URLs for artist thumbnails.

Deno Integration#

This project utilizes Deno for dependency management and as a runtime environment.

To run the application, you would typically use Deno tasks.

Running the application with Deno#

To start the development server, use the following command:

deno task start

This will run the app in development mode, and you can view it in your browser, usually at http://localhost:3000.

Building the application with Deno#

To build the application for production, use:

deno task build

This will create a production-ready build in the dist folder.

Clone this repository