DiscogsTagScanner

Discogs is an online database of music release metadata. TagScanner is a program that edits music file metadata.

This browser extension and native program help you quickly load Discogs releases in TagScanner with one click, without having to manually copy and paste the release ID or name from your browser, or use TagScanner's limited search feature.

• Screenshots
• Requirements
• Installation
  • Browser extension
  • Native program
• Usage
• Developing

Screenshots

Discogs		TagScanner
	⇨
Click the new Send to TagScanner button		The release loads in the Online pane

Requirements

• Windows
• .NET Desktop Runtime 8 x64 for Windows or later
• Chromium-based browser, such as Vivaldi or Chrome
• TagScanner

Installation

You must install both the browser extension and the native program.

Browser extension

1. Download DiscogsTagScanner.crx from the latest release.
2. In your browser, open the Extensions page by going to chrome://extensions/.
3. Temporarily enable Developer mode.
4. Drag and drop DiscogsTagScanner.crx into the Extensions page.
   • If drag and drop does not work, try entering chrome://extensions/ into the URL bar once again.
5. Accept the confirmation prompt to install the extension.
6. You can now delete DiscogsTagScanner.crx and turn off Developer mode if you wish.

Native program

1. Download NativeMessagingHost.exe from the latest release and save it somewhere, such as C:\Program Files\DiscogsTagScanner\NativeMessagingHost.exe.
2. Run NativeMessagingHost.exe once, which registers the native messaging host with Chromium-based browsers on your computer.

Usage

1. Open TagScanner and highlight the files you want to edit.
2. Go to the Discogs release page of the files' release in your browser.
3. At the top of the right column, next to the Release heading, click Send to TagScanner.
   • TagScanner will load the Discogs release in the Online pane. You can click the Preview button to see the pending changes.
4. Click the Save button to write the changes to the files.

Developing

The following steps are for developers only. You don't need to follow these steps to use this extension.

1. Build the browser extension CRX by running the PowerShell script

   .\Extension\build.ps1

   The build script depends on Vivaldi for packing the CRX (you can replace this with Chrome) and a private key saved in Extension\PackExtensionPrivateKey.pem.
2. Build the native messaging host by publishing NativeMessagingHost.csproj in Visual Studio Community 2022 or later, which produces NativeMessagingHost\bin\Release\net6.0-windows\publish\win-x64\NativeMessagingHost.exe. You can alternatively run

   dotnet publish -c Release -p:PublishSingleFile=true -r win-x64 --self-contained false .\NativeMessagingHost\NativeMessagingHost.csproj