Skip to content

denis-g/userscript-discogs-submitter

Folders and files

NameName
Last commit message
Last commit date

Latest commit

Β 

History

53 Commits
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 

Make Draft Great Again Install Discogs Submitter Greasy Fork


Discogs Submitter

Description

Discogs Submitter is a userscript designed to automate the process of migrating music releases from popular digital stores to the Discogs database. It extracts metadata from the source page, normalizes it to meet Discogs formatting standards, and submits it directly as a "Draft".

Supported Digital Stores

Store Release page URL pattern Country Catalog Number BPM info 24-bit Hi-Res Cover Web Archive
Bandcamp *.bandcamp.com/album/* 🟑 🟑 🟑 βœ… βœ… βœ…
Qobuz *.qobuz.com/* ❌ ❌ ❌ βœ… βœ… ❌
Juno Download *.junodownload.com/* ❌ βœ… βœ… ❌ ❌ ❌
Beatport *.beatport.com/* ❌ βœ… βœ… βœ… βœ… ❌
7digital *.7digital.com/artist/*/release/* ❌ ❌ ❌ βœ… ❌ ❌
Amazon Music *.amazon.*/* ❌ ❌ ❌ ❌ ❌ ❌
Bleep bleep.com/* ❌ βœ… ❌ βœ… ❌ ❌
HDtracks *.hdtracks.com/* ❌ ❌ ❌ βœ… βœ… ❌
Bandcamp: Catalog number and BPM extraction relies on both the release credits and description. Country is extracted from the publisher location.
Juno Download: Cover art maximum size is 700x700.
7digital: Cover art maximum size is 800x800, definitely available for all releases.
Web Archive: Almost all sites had different designs and layouts in different years.

Screenshots

Discogs Draft

Bandcamp

Discogs Submitter - Bandcamp

Qobuz

Discogs Submitter - Qobuz

Juno Download

Discogs Submitter - Juno Download

Beatport

Discogs Submitter - Beatport

7digital

Discogs Submitter - 7digital

Amazon Music

Discogs Submitter - Amazon Music

Bleep

Discogs Submitter - Bleep

HDtracks

Discogs Submitter - HDtracks

Features

  • Metadata Extraction: Automatically parses artist names (VA normalization), release titles, label names (with Self-released support), catalog numbers, release dates, and complete tracklists with track artists. If a release is identified as a compilation (e.g., contains "Compiled by..." or "Selected by..."), the compiler is automatically prioritized as the primary release artist.
  • Credit Extraction: Automatically identifies and extracts credit roles from titles and descriptions, moving them to the "Extra Artists" section while keeping the original title text clean.
  • Smart Normalization: Automatically filters out technical tags, standardizes punctuation, and applies intelligent casing to all fields.
  • Cover Art & BPM: Automatically fetches and attaches cover art, ensuring BPM data is included in the Discogs release notes when available.

Normalization & Transformations

Smart Capitalization

The script applies a Unicode-aware Title Case to all fields, ensuring consistent formatting regardless of the source. It preserves stylistic casing (e.g., Sci-Fi, iPhone) and handles common abbreviations.

  • Standardization: yEt AnOtHeR tRaCk (sUpEr MiX) β†’ Yet Another Track (Super Mix), LIVE AT LONDON β†’ Live At London.
  • Preserved Abbreviations: DJ, VIP, EP, UK, I, II, III, etc.
  • Dotted Abbreviations: A.I., U.S.A. are preserved in uppercase.
  • Mixed Case: McDonald's, bOOm are preserved exactly as written.
  • Punctuation: Normalizes apostrophes (’, `, Β΄ β†’ ') and cleans whitespace around parentheses.

Title Cleaning

To meet Discogs standards, common technical suffixes and bracketed tags are removed from track titles:

  • Track Title (Original Mix) β†’ Track Title
  • Track Title [Explicit] β†’ Track Title
  • Album Name - 24 bit β†’ Album Name
  • Track Title (156 bpm) β†’ Track Title
  • Track Title - Bonus Track β†’ Track Title

And more...

Credit Extraction & Movement

The script scans track titles and release descriptions for artist credits. When found, it creates a Credit entry and (in most cases) removes the credit from the title to keep it clean.

  • Features: Track Title (feat. Artist Name) β†’ Title: Track Title, Featuring: Artist Name.
  • Remixes (Type A): Track Title (Remix By Artist Name) β†’ Title: Track Title (Remix By Artist Name), Remix: Artist Name.
  • Remixes (Type B): Track Title (Artist Name Remix) β†’ Title: Track Title (Artist Name Remix), Remix: Artist Name.
  • Remixes (Type C): Track Title (Artist Name's Remix) β†’ Title: Track Title (Artist Name's Remix), Remix: Artist Name.
  • Multiple Remixers: Track Title (Artist One & Artist Two Remix) β†’ Title: Track Title (Artist One & Artist Two Remix), Remix: Artist One & Artist Two.
  • Production: Track Title (prod. by Artist Name) β†’ Title: Track Title, Producer: Artist Name.

And more...

Artist Joiner Parsing

Artist strings are automatically split into individual artists using common joiners:

  • Artist One, Artist Two & Artist Three β†’ Artist One (join: ,), Artist Two (join: &), Artist Three.

Supported Credit Roles

The userscript parses track titles and release descriptions for the following credit roles, automatically mapping them to the correct Discogs format:

Featuring, Remix, DJ Mix
Compiled By, Artwork, Producer, Mastered By, Written-By

Usage Guide

  1. Open a music release page on any supported store.
  2. Click the Discogs Submitter button (usually located near the album buy/download controls).
  3. The floating widget will appear and parse the data automatically.
  4. Review the draft in the preview area.
  5. Select your preferred Format and Bit Depth if available.
  6. Click Submit to Discogs to create your draft.

Installation

Install a Userscript Manager

Install the Script

Install Discogs Submitter

Something got broken?

Found a bug or have a feature request?

Report a Bug Feature Request

Hall of Fame

Contributors


About

πŸ’Ώ Discogs Submitter is a userscript designed to automate the process of migrating music releases from popular digital stores (Bandcamp, Qobuz, Juno Download, Beatport, 7digital, Amazon Music, Bleep, HDtracks) to the Discogs database.

Topics

Resources

License

Code of conduct

Contributing

Security policy

Stars

Watchers

Forks

Sponsor this project

Contributors