Skip to content

amsdams/discogs-scraper

Repository files navigation

Discogs Collection Scraper

A browser extension that allows you to scrape your Discogs collection and search for albums on YouTube Music.

Features

  • 🎵 Scrape your entire Discogs collection with one click
  • 🔍 Direct links to search each album on YouTube Music
  • 💾 Export collection as JSON file
  • 🎨 Clean, user-friendly interface
  • ⚡ Fast and lightweight

Installation

Chrome / Edge / Brave

  1. Download or clone this repository
  2. Open your browser and navigate to:
    • Chrome: chrome://extensions/
    • Edge: edge://extensions/
    • Brave: brave://extensions/
  3. Enable Developer mode (toggle in the top-right corner)
  4. Click Load unpacked
  5. Select the discogs-scraper folder
  6. The extension is now installed!

Firefox

  1. Download or clone this repository
  2. Rename manifest-firefox.json to manifest.json (backup the original first)
  3. Navigate to about:debugging#/runtime/this-firefox
  4. Click Load Temporary Add-on
  5. Select the manifest.json file from the extension folder
  6. The extension is now installed!

Note: Firefox temporary add-ons are removed when you close the browser. For permanent installation, you need to sign the extension through Mozilla's AMO.

Usage

  1. Navigate to your Discogs collection page:

    https://www.discogs.com/user/YOUR_USERNAME/collection
    
  2. Click the "Scrape Collection" button in the top-right corner

  3. A popup will appear showing:

    • Artist name
    • Album title
    • YouTube Music search link
  4. Your collection will also be automatically downloaded as a JSON file

  5. Click on "Search" next to any album to find it on YouTube Music

  6. Close the popup by:

    • Clicking the × button
    • Clicking outside the popup

Screenshots

The extension adds a scrape button to your Discogs collection page and displays results in a clean table with direct YouTube Music links.

File Structure

discogs-scraper/
├── manifest.json           # Chrome/Edge configuration
├── manifest-firefox.json   # Firefox configuration
├── content.js             # Main extension logic
├── styles.css             # Styling
├── icons/                 # Extension icons
│   ├── icon16.png
│   ├── icon48.png
│   └── icon128.png
└── README.md              # This file

Development

Making Changes

  1. Edit the files in the extension folder
  2. Reload the extension:
    • Chrome/Edge: Click the refresh icon on the extension card
    • Firefox: Click the Reload button

Customization

You can customize the appearance by editing styles.css:

  • Change colors (currently Discogs orange: #ff6600)
  • Adjust popup size
  • Modify table styling

Technical Details

  • Manifest Version: V3 (Chrome/Edge), V2 (Firefox)
  • Permissions: Runs only on Discogs collection pages
  • No external dependencies: Pure vanilla JavaScript
  • Privacy: No data is sent to external servers

Compatibility

  • ✅ Chrome (Manifest V3)
  • ✅ Edge (Manifest V3)
  • ✅ Brave (Manifest V3)
  • ✅ Firefox (Manifest V2 - use manifest-firefox.json)
  • ✅ Opera (Manifest V3)

Contributing

Feel free to submit issues and pull requests!

License

MIT License - feel free to use and modify as needed.

Changelog

Version 1.0.0

  • Initial release
  • Scrape Discogs collection
  • Export to JSON
  • YouTube Music integration
  • Responsive popup interface

Known Issues

  • The extension relies on Discogs' CSS class names which may change
  • Currently uses [class*="titleAndArtist"] selector which should be relatively stable

Future Enhancements

  • Add Spotify search links
  • Add Apple Music search links
  • Filter and sort options
  • Export to CSV format
  • Dark mode support
  • Multiple collection support

Support

If you find this extension useful, please star the repository! ⭐

About

A browser extension that allows you to scrape your Discogs collection and search for albums on YouTube Music.

Resources

License

Contributing

Stars

Watchers

Forks

Packages

 
 
 

Contributors