Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

https://github.com/aldaviva/discogstagscanner

💿 Click a button on a Discogs release page to load that release in TagScanner's Online tab
https://github.com/aldaviva/discogstagscanner

chrome-extension discogs music-metadata music-tagging native-messaging tagscanner uiautomation

Last synced: 20 days ago
JSON representation

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

Host: GitHub
URL: https://github.com/aldaviva/discogstagscanner
Owner: Aldaviva
License: apache-2.0
Created: 2022-03-12T22:19:30.000Z (almost 3 years ago)
Default Branch: master
Last Pushed: 2024-09-10T02:28:37.000Z (4 months ago)
Last Synced: 2024-12-09T12:06:57.171Z (25 days ago)
Topics: chrome-extension, discogs, music-metadata, music-tagging, native-messaging, tagscanner, uiautomation
Language: C#
Homepage:
Size: 301 KB
Stars: 1
Watchers: 3
Forks: 0
Open Issues: 0
Metadata Files:
- Readme: Readme.md
- License: License.txt

Awesome Lists containing this project

README

         DiscogsTagScanner

===

[![Build status](https://img.shields.io/github/actions/workflow/status/Aldaviva/DiscogsTagScanner/dotnet.yml?branch=master&logo=github)](https://github.com/Aldaviva/DiscogsTagScanner/actions/workflows/dotnet.yml)

[ Discogs](https://www.discogs.com/) is an online database of music release metadata. [ TagScanner](https://www.xdlab.ru/en/) 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](#screenshots)

- [Requirements](#requirements)

- [Installation](#installation)

    - [Browser extension](#browser-extension)

    - [Native program](#native-program)

- [Usage](#usage)

- [Developing](#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](https://dotnet.microsoft.com/en-us/download/dotnet/8.0) or later

- Chromium-based browser, such as [Vivaldi](https://vivaldi.com/download/) or [Chrome](https://www.google.com/chrome/)

- [TagScanner](https://www.xdlab.ru/en/download.htm)



## Installation

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



### Browser extension

1. Download [`DiscogsTagScanner.crx`](https://github.com/Aldaviva/DiscogsTagScanner/releases/latest/download/DiscogsTagScanner.crx) from the [latest release](https://github.com/Aldaviva/DiscogsTagScanner/releases/latest).

1. In your browser, open the Extensions page by going to `chrome://extensions/`.

1. Temporarily enable **Developer mode**.

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

1. Accept the confirmation prompt to install the extension.

1. You can now delete `DiscogsTagScanner.crx` and turn off Developer mode if you wish.



### Native program

1. Download [`NativeMessagingHost.exe`](https://github.com/Aldaviva/DiscogsTagScanner/releases/latest/download/NativeMessagingHost.exe) from the [latest release](https://github.com/Aldaviva/DiscogsTagScanner/releases/latest) and save it somewhere, such as `C:\Program Files\DiscogsTagScanner\NativeMessagingHost.exe`.

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

1. Go to the Discogs release page of the files' release in your browser.

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

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

    ```powershell

    .\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`.

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

    ```powershell

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

    ```