Bulk Import

The plugin allows you to import your preexisting media collection and upgrade it to Media DB entries in bulk. This is useful when you have an existing collection of media notes that you want to enhance with metadata.

Prerequisites

Before starting the bulk import process, ensure that:

1. Your media notes are in a folder: All the notes you want to import must be inside a folder in your vault
2. Notes have a title field: Each note needs one metadata field that contains the title of the media
   • This can be achieved by using a CSV import plugin to import an existing list from outside of Obsidian

Importing

To start the import process:

1. Right-click on the folder containing your media notes
2. Select the Import folder as Media DB entries option
3. A dialog will open with the following options:
   • Select which API to use for searching
   • Choose whether to keep the current note content and metadata
   • Specify the name of the metadata field that contains the media title or id

The plugin will go through every file in the folder and:

1. Read the title from the specified metadata field
2. Search the selected API for matches
3. Prompt you to select from the search results
4. Update the note with the metadata

After all files have been imported (or the import was canceled), you will find:

1. All successfully imported notes with enhanced metadata
2. A report containing:
   • Any errors that occurred
   • Skipped files
   • Canceled files

The error report will be saved in the folder specified in the plugin settings.

Tips

• Start with a small test folder to ensure your settings are correct
• Backup your vault before performing a large bulk import
• Review the error report to identify any issues with your notes