🎶 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 artist
• ⚙️ Configuration
  • Configuration file
  • Environment variables
  • Command Line

📥 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.

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

➕ Adding artist

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

• 💡 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 ablums and songs of the artists, as well as all information about the artists themsleves will be added to the database 🎉!

⚙️ Configuration

Configuration file

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

WIP

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 an available environment variables in the .env template and the help command of the command line.

Command Line

If you use the app with the command line, you can also use parameters to add the notion key, database IDS, fanart.tv API key, etc.

Use the --help command for more information

python src/musicbrainz2notion/main.py --help