MusicBrainz Scripts

This repository contains a collection of user scripts for MusicBrainz.

Installation

To install a user script from this repository, follow your user script manager's instructions.

See https://musicbrainz.org/doc/Guides/Userscripts#Userscript_manager for more information.

Scripts

setlist.fm event importer

This scripts allows you to import set lists from setlist.fm as MusicBrainz events.

See the script README for more information.

ACUM work importer

This scripts allows you to import works from the database of the Israeli rights management society ACUM.

See the script README for more information.

Change All Artists Default

Sets the default value of "Change all artists" check box in the track list edit page.

See the script README for more information.

Single Language Tracklist

Keeps one language of a double language tracklist (like often seen in Discogs).

See the script README for more information.

Scaffold festival days

Scaffolds day, venue, and single-day place sub-events for festival event hierarchies.

See the script README for more information.

Add Sub-event

Adds an Add sub-event link on event pages and opens a prefilled sub-event create form.

See the script README for more information.

Expand events

Expands and collapses child sub-events inline on event pages, with recursive details and global controls.

See the script README for more information.

Development

This is a TypeScript monorepo using Yarn workspaces and Turbo for build orchestration.

Prerequisites

• Node.js >= 18
• Yarn (v4.3.1)

Setup

yarn install

Available Scripts

• yarn build - Build all userscripts
• yarn watch - Build in watch mode
• yarn test - Run tests across all packages
• yarn lint - Run linting and spell checking
• yarn check-types - Type-check all TypeScript files
• yarn ci - Run full CI pipeline (type-check, build, lint)
• yarn create-script - Scaffold a new userscript from template

Project Structure

• scripts/ - Individual userscript packages
• lib/ - Shared libraries and utilities
• Each script is built with Vite and bundled for browser userscript managers

Contributing

Pull requests are welcome.

License

This project is licensed under the Boost Software License - Version 1.0. See the LICENSE file for more information.