Music Spider - a selfhosted tool for finding concerts based on your listening history (Plex, Spotify, etc.)

Music Spider is a tool I made that finds your most-listened-to artists from Plex (via Tautulli) and/or Spotify, searches event APIs to find upcoming shows near you, and (optionally) notifies you by email, calendar, or a generic webhook. It finds concerts of your favorite artists.

This incarnation of the project is about a month old as of writing. I wrote the first incarnation of it in Google Apps Script in 2023. It came about because I almost missed out on a concert I would've regretted missing - and I don't want to use some service that's going to sell my data and send me spam mail. This version is the same idea adapted as a selfhosted tool. Obviously there are services out there that do this so this is just meant to be a version of that which you control.

At the time of writing, it has just been me testing this. So If you have suggestions or questions let me know. Create an issue or reply here.

Features

• Top Artists tracking: from Plex (via Tautulli), Spotify, both, or manual-only (no API fetching, just artists added to custom list); ranks your top artists in short term, medium term, and long-term windows; optional scheduled auto-refresh.

• Custom list: manually pin artists to always include

• Ignore list: exclude specific artists from top-artists and event search entirely (e.g. artists who are not alive, not touring, or you're just not going to see them live)

• Event search: Ticketmaster and/or Resident Advisor matched against your list of artists - schedule weekly event searches to update the list or start the search manually

• Events UI: Peruse the discovered events in card and list views, sortable columns, per-event delete/ignore

• Notification Methods:

  • Weekly event digest email

  • Google Calendar sync - via a connected Google account (OAuth) or a GCP service account (no OAuth consent screen or HTTPS needed),

  • generic JSON webhook (e.g. Discord, Home Assistant)

• Settings UI: Supply API keys, set your location, and set up any notification methods

• Theming: Grayscale and Catppuccin Mocha themes

Tech Stack

• Framework: Next.js 16 (App Router) with React 19

• Styling: Tailwind CSS 4

• Runtime: Node 20, packaged as a Docker image

• Storage: flat JSON files on disk (no database) - settings, event store, artist lists, and caches, managed through a small file-store module

• Auth: OAuth flows for Spotify and Google, using popup windows for the consent step

• External APIs:

  • Tautulli API,

  • Spotify Web API,

  • Ticketmaster Discovery API,

  • Resident Advisor's public GraphQL API,

  • Google Gmail/Calendar APIs

• Deployment: Docker / Docker Compose, instructions for Unraid as well

Requirements

• Docker

• Artists Source Options:

  • Tautulli: API key (from Tautulli settings)

  • Spotify: create an API key from developer.spotify.com (and an HTTPS connection for OAuth if not viewing WebUI from 127.0.0.1)

• Event Search options:

  • Ticketmster: API key from developer.ticketmaster.com

• Options for Notifications:

  • Weekly email events digest (connect using SMTP, Google OAuth)

  • Add events to a calendar (connect to calendar using CalDAV, Google OAuth, Google Cloud Project service account)

  • Custom webhook - can be used to send event summary to Discord, Slack, etc.

Installation

• Unraid: It is not in CA yet so follow these to get the :latest from the Docker Hub repository

• Docker Compose

Configuring the app

• Configuration

Edited 46 minutes ago46 min by vxlx