navidrome/plugins/examples/wikimedia

Wikimedia Plugin for Navidrome

A Navidrome plugin that fetches artist metadata from Wikidata, DBpedia, and Wikipedia.

Features

• Artist URL: Fetches Wikipedia URL for an artist using Wikidata (by MBID or name), DBpedia, or falls back to a Wikipedia search URL
• Artist Biography: Fetches the introductory text from the artist's Wikipedia page
• Artist Images: Fetches artist images from Wikidata

Building

Prerequisites

• TinyGo (recommended) or Go 1.23+

Build using the Makefile (recommended)

cd plugins/examples
make wikimedia.wasm

Build manually with TinyGo

cd plugins/examples/wikimedia
tinygo build -target wasip1 -buildmode=c-shared -o ../wikimedia.wasm .

Build manually with Go

cd plugins/examples/wikimedia
GOOS=wasip1 GOARCH=wasm go build -buildmode=c-shared -o ../wikimedia.wasm .

Installation

Copy wikimedia.wasm from the examples folder to your Navidrome plugins folder:

cp plugins/examples/wikimedia.wasm /path/to/navidrome/plugins/

Then enable plugins in your navidrome.toml:

[Plugins]
Enabled = true
Folder = "/path/to/navidrome/plugins"

Add the plugin to your agents list:

Agents = "lastfm,spotify,wikimedia"

Testing with Extism CLI

Install the Extism CLI:

brew install extism/tap/extism  # macOS
# or see https://extism.org/docs/install for other platforms

Run these commands from the plugins/examples directory.

Test the manifest

extism call wikimedia.wasm nd_manifest --wasi

Expected output:

{"name":"Wikimedia","author":"Navidrome","version":"1.0.0","description":"Fetches artist metadata from Wikidata, DBpedia and Wikipedia","website":"https://navidrome.org","permissions":{"http":{"reason":"Fetch metadata from Wikimedia APIs","allowedHosts":["query.wikidata.org","dbpedia.org","en.wikipedia.org"]}}}

Test artist URL lookup

# With MBID (The Beatles)
extism call wikimedia.wasm nd_get_artist_url --wasi \
  --input '{"id":"1","name":"The Beatles","mbid":"b10bbbfc-cf9e-42e0-be17-e2c3e1d2600d"}' \
  --allow-host "query.wikidata.org"

Expected output:

{"url":"https://en.wikipedia.org/wiki/The_Beatles"}

Test artist biography

extism call wikimedia.wasm nd_get_artist_biography --wasi \
  --input '{"id":"1","name":"The Beatles","mbid":"b10bbbfc-cf9e-42e0-be17-e2c3e1d2600d"}' \
  --allow-host "query.wikidata.org" \
  --allow-host "en.wikipedia.org"

Test artist images

extism call wikimedia.wasm nd_get_artist_images --wasi \
  --input '{"id":"1","name":"The Beatles","mbid":"b10bbbfc-cf9e-42e0-be17-e2c3e1d2600d"}' \
  --allow-host "query.wikidata.org"

Expected output:

{"images":[{"url":"http://commons.wikimedia.org/wiki/Special:FilePath/Beatles%20ad%201965%20just%20the%20beatles%20crop.jpg","size":0}]}

API Endpoints Used

Service	Endpoint	Purpose
Wikidata	https://query.wikidata.org/sparql	SPARQL queries for Wikipedia URLs and images
DBpedia	https://dbpedia.org/sparql	Fallback SPARQL queries for Wikipedia URLs and short bios
Wikipedia	https://en.wikipedia.org/w/api.php	MediaWiki API for article extracts

Implemented Functions

Function	Description
nd_manifest	Returns plugin manifest with HTTP permissions
nd_get_artist_url	Returns Wikipedia URL for an artist
nd_get_artist_biography	Returns artist biography from Wikipedia
nd_get_artist_images	Returns artist image URLs from Wikidata

License

Same as Navidrome - GPL-3.0