musicbrainz2notion 0.5.0

A tool to sync artists and music databases from MusicBrainz to Notion.

🎶 MusicBrainz2Notion

A tool for syncing artist and music data from MusicBrainz to Notion databases. Simply add artist MusicBrainz IDs in a Notion database, and the app will automatically fetch and update their data, including albums and songs.

Contents

• 📥 Download
• 🏃 Getting Started
• ➕ Adding artists
• ⚙️ Configuration
  • Configuration file
  • Environment variables
  • Command Line
• ⚠️ Current Limitations

📥 Download

Find the latest release for your OS here.

🏃 Getting Started

1. Duplicate the Notion template to your Notion workspace.

   💡 Keep note of the url of the duplicated page (cmd/ctrl + L to copy to clipboard), you will need it when using the app for the first time.

2. Set up a Notion integration:

   • Create the integration and obtain the Notion API key. Don't forget to grant the permissions to the integration for your newly duplicated page.

3. Run the app.

   • You will be prompted for your notion API key and the url of the main page you duplicated.
   • ❗ The first time you run the app, it will download a small part of MusicBrainz dataset so you need around free 10GB in the app's folder. But don't worry, after processing the data, it only take only around 200MB.

4. Discover who is the mystery artist in the template and enjoy your new music database 🎶!

➕ Adding artists

First, look up the MusicBrainz IDs (MBIDs) of the artists you want to sync to Notion.

💡 MBIDs are universal unique identifiers for artists, releases and songs. You can find the MBIDs in the URL of the artist's page: https://musicbrainz.org/artist/<MBID> or in the details tab of the artist's page (e.g. here: 5b11f4ce-a62d-471e-81fc-a69a8278c7da).

Once you have the artist IDs, create new pages in the Artist database and enter the MBIDs in the mbid field.

💡 Make sure that the To update field is toggled on so that the app knows which artists to sync.

The next time you will run the app, all albums and songs of the artists, as well as all information about the artists themselves will be added to the database 🎉!

⚙️ Configuration

Configuration is loaded from three sources, from lowest to highest priority:

1. Configuration file
2. Environment variables
3. Command-line arguments

Configuration file

Edit the settings.toml file to set the database IDs and API keys or personalize your database.

💡 When you are prompted for the notion API key and the link of the database, the configuration file is automatically updated.

Environment variables

Default settings and settings from the configuration file can be overridden by environment variables. Environment variables can also be read from the .env file in the app folder.

You can find more information about available environment variables in the .env template and the --help command of the command line app.

Command Line

If you run the app via the command line (after cloning the repo and installing dependencies), you can pass parameters such as the Notion API key, database IDs, or your Fanart.tv API key.

Use the --help command to see all available options:

musicbrainz2notion --help

⚠️ Current Limitations

• Large Databases: The app isn’t fully optimized for very large databases yet, so the startup may slow down as the number of pages grows.
• Notion API: The Notion API can sometimes be unreliable, and not every scenario is covered yet—occasional crashes may occur.