Lightweight Musicbrainz database mirroring
  • Rust 94%
  • Nix 6%
Find a file
2026-03-16 22:09:52 +01:00
musicbrainz@ea1f50eb50 initial commit 2026-03-12 01:17:09 +01:00
src respond to clippy's pedantry 2026-03-16 22:09:52 +01:00
.gitignore initial commit 2026-03-12 01:17:09 +01:00
.gitmodules initial commit 2026-03-12 01:17:09 +01:00
Cargo.lock initial commit 2026-03-12 01:17:09 +01:00
Cargo.toml initial commit 2026-03-12 01:17:09 +01:00
flake.lock initial commit 2026-03-12 01:17:09 +01:00
flake.nix initial commit 2026-03-12 01:17:09 +01:00
readme.md add links to, reword, and fix details in readme 2026-03-12 02:38:35 +01:00

syncbrainz

Lightweight Musicbrainz database mirroring tool.

Usage

To set up a fully functional Musicbrainz database, there are two steps;

  1. initialise the database (syncbrainz init),
  2. import a full data export (syncbrainz import)

after which you'll have a database populated with fairly recent data — half a week old, at most.

Hourly replication

To get data as recent as the hour, there are two additional steps;

  1. sign up for a Metabrainz live data feed (and donate if possible!),
  2. run the sync command (syncbrainz replicate)

this downloads any missing replication packets, verifies their integrity and authenticity, then applies them to the database. When the program exits, you'll have a fully up to date Musicbrainz database.

Important

Running the replication step as an hourly cron-job is a great idea, but it's very important that only one syncbrainz instance is running at a time. Configure your scheduling system such that it does not stop already running processes.