HTTPS SSH

foo_discogs

foo_discogs is a highly-customizable audio file tagging component for the foobar2000 music player. Using this component, you can quickly and easily tag your music files with information pulled from the Discogs database.

Getting Started

Download

Get the component from the official foobar2000 components page.

Basic Usage

How to tag your music:

  1. Select the tracks in your foobar2000 playlist that you'd like to tag.
  2. Use the Find Release dialog to find the exact release you will to pull meta-data from.
  3. Use the Match Tracks dialog to ensure your files are correctly mapped to Discogs tracklist.
  4. Use the Preview Tags dialog to see what changes will be made to the tags. Edit tag mappings to customize them.

OAuth

Discogs.com requires OAuth authentication for anyone to access its API. To authenticate via OAuth, you'll need to have a Discogs account. When you first open the Find Release dialog without having configured OAuth, you will automatically be prompted to do so. Follow the instructions on the OAuth Identity tab.

Note: Your system clock must be set correctly for OAuth authentication to work.

TLS 1.2

As of mid-2018, Discogs requires TLS 1.2 support to access its API. Windows 10 should have TLS 1.2 support built in.

To enable TLS 1.2 on Windows 7, see these instructions.

Configuration

Click "Configure" on the Find Release dialog or find it in the context menu under Tagging > Discogs to open the Configuration dialog. On the Tagging tab, you'll find some basic options regarding how foo_discogs tags your files. On the OAuth Identity tab, you can configure OAuth if you haven't already. The Album/artist Art tab is described in more detail below.

Tag Mappings

Click "Edit tag mappings..." on the Preview Tags dialog or find it in the Configuration dialog. From this dialog you can add, remove, enable, disable, and customize your tag mappings. Check the Syntax help HTML file for detailed information on how the tag formatting strings work.

Keyboard Shortcuts

If you tag music frequently, you'll probably want to configure keyboard shortcuts for foo_discogs within foobar2000. To do so, open foobar2000's preferences and select Keyboard Shortcuts.

Press "Add new" and filter the Actions looking for the Discogs context:

foo_discogs_hotkeys1.png

Select whichever Action you're interested in ("Write Tags" to open the Find Release dialog for the selected tracks). In the Key box, type whatever hotkey you'd like to set for the action:

foo_discogs_hotkeys2.png

If you're an avid Discogs user you can configure keyboard shortcuts to open Discogs release/master/artist pages for the selected track in your browser.

About

Authors

  • Michael Pujos (aka bubbleguuum) (up until v1.32)
  • zoomorph (v1.33+)

Community

Check out the long thread about foo_discogs on hydrogenaudio forums.

Bug or Feature Request?

File it on the Issues tracker on BitBucket.

Development

foo_discogs is built with Microsoft Visual Studio. Feel free to get your hands dirty, add a feature, and submit a pull request.

Dependencies