aldaviva / discogstagscanner

💿 Click a button on a Discogs release page to load that release in TagScanner's Online tab

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 6 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

discogstagscanner's Issues

Update TagScanner icon

TagScanner changed their icon in 6.1.14 (2022-11-09).

Fails to activate Online tab starting in TagScanner 6.1.15

• UI hierarchy seems to have changed, possibly as a consequence of the "Improved: On Windows10 and later program now use native border drawing" change in 6.1.15, so our UI descendent indices need to be updated now
• When trying to get the n^th child of an element that actually has no children, a divide by zero exception is thrown from NativeMessagingHost.TagScannerController.findDescendantElementByIndex, which does not show a useful error message and crashes the program