8000 GitHub - KaeruCT/music-collab-explorer: Discover collabs between musical artists using a graph visualization
[go: up one dir, main page]
More Web Proxy on the site http://driver.im/
Skip to content

KaeruCT/music-collab-explorer

Repository files navigation

Music Collab Explorer

Preview screenshot of the app

The Music Collab Explorer is a web app for discovering collabs between musical artists.

Using data from the excellent MusicBrainz project, you can search for any artist and visualize their collabs in a dynamic graph.

Features

  • Search for an artist, and click one of the results to add them to the artist list.
  • Artists in the list will be shown in the graph.
    • Their collaborators will be shown in the graph as well, if the "Show only selected" checkbox is not checked.
  • Double-click on any artist in the graph to view their collabs.
  • All artists who have collabed are connected.
  • Click on any graph node or edge to view more information.
    • Clicking a node will list all the collab songs of that artist.
    • Clicking an edge will list all the collab songs between the artists connected by the edge.

Getting Started

Prerequisites

  • Deno installed.
  • A PostgreSQL database v16.1 or greater (a script is provided to help populate it with a dump from the MusicBrainz database).

Installation

Clone the repository:

git clone git@github.com:KaeruCT/music-collab-explorer.git
cd music-collab-explorer

Set up env vars:

cp .env.example .env

Modify .env as needed to configure database credentials.

Running the Application

Development Mode

deno task dev

Building for Production

deno task build

Starting the Server

deno task start

Database Setup

This application requires a local copy of the MusicBrainz database.

  1. Navigate to the setup/ directory:
    cd setup/
  2. Run the database initialization script. The credentials must be edited in the script if they differ.
    ./init_db.sh
  3. (Optional) Remove superuser privileges from the MusicBrainz user:
    ALTER USER musicbrainz WITH NOSUPERUSER;

Future Improvements

  • Improve artist images by using additional sources, only Wikimedia is used at the moment and it's missing many artists.
  • Allow to play tracks within the visualization. Currently, the tracks are only Youtube search links.

Acknowledgments

  • MusicBrainz for providing open music metadata. This project would be impossible without them. Please contribute!
  • vis-network for the excellente graph visualization.

About

Discover collabs between musical artists using a graph visualization

Resources

License

Stars

Watchers

Forks

0