Webhook Scrobbler Plugin (Rust)

A Navidrome plugin written in Rust that sends HTTP webhook notifications when tracks are scrobbled. This is useful for integrating with external services like home automation systems, Discord bots, monitoring tools, or any service that can receive HTTP requests.

Features

Sends HTTP GET requests to configured URLs on every scrobble event
Includes track metadata (title, artist, album, username, timestamp) as query parameters
Supports multiple webhook URLs (comma-separated)
All users are automatically authorized (no external service authentication required)
Now playing events are ignored (webhooks fire only on completed scrobbles)

Prerequisites

Rust toolchain
WebAssembly target: rustup target add wasm32-unknown-unknown

Building

From the plugins/examples directory:

bash

make webhook-rs.ndp

Or build directly with cargo:

bash

cd webhook-rs
cargo build --release
zip -j webhook-rs.ndp manifest.json target/wasm32-unknown-unknown/release/webhook_rs.wasm

Installation

Copy webhook-rs.ndp to your Navidrome plugins folder (configured via Plugins.Folder in your config).

Configuration

Configure in the Navidrome UI (Settings → Plugins → webhook-rs):

Key	Description	Example
`urls`	Comma-separated list of webhook URLs	`https://example.com/hook1,https://example.com/hook2`

Webhook Request Format

When a scrobble occurs, the plugin sends an HTTP GET request to each configured URL with the following query parameters:

Parameter	Description
`title`	Track title
`artist`	Track artist
`album`	Album name
`user`	Username who scrobbled
`timestamp`	Unix timestamp when the track started playing

Example request:

GET https://example.com/webhook?title=Song%20Name&artist=Artist%20Name&album=Album%20Name&user=john&timestamp=1703270400

Use Cases

Home Automation: Trigger lights or displays when music starts playing
Discord/Slack Notifications: Post currently playing tracks to a channel
Logging/Analytics: Track listening history in an external system
IFTTT/Zapier Integration: Connect to thousands of services via webhook triggers

Development

The plugin is built using the Extism Rust PDK. Key exports:

nd_manifest - Returns plugin metadata and permissions
nd_scrobbler_is_authorized - Always returns true (all users authorized)
nd_scrobbler_now_playing - No-op (returns success without action)
nd_scrobbler_scrobble - Sends webhooks to configured URLs