VinylValueCheck

Overview

VinylValueCheck is a specialized web application designed for vinyl collectors and enthusiasts. It leverages the Discogs API to fetch and display the lowest market prices for vinyl records. Users can input a list of songs, and the app retrieves corresponding data from Discogs, presenting it in an easily readable table format.

Features

• Song Price Lookup: Input a list of songs to find the lowest price for each on the Discogs market.
• Dynamic Table Display: Results are displayed in a table with sortable columns for song name, master ID, and lowest price.
• Efficient Search: Utilizes the Discogs API for fast and accurate vinyl record price checks.

Installation

1. Clone the repository to your local machine.
2. Navigate to the project directory.
3. Install dependencies (if any).

Usage

1. Run npm install
2. Run npm run dev
3. Open the local Vite URL in a web browser
4. Enter a list of songs in the provided text area. Each song should be on a new line.
5. Click the 'Search' button to initiate the search.
6. The results will be displayed in the table below the search area.

Playlist pricing

To price a YouTube playlist from the command line:

node scripts/price-playlist.mjs "https://www.youtube.com/playlist?list=PLYapdvbx1R5hDvJyGgGt1g9x-uSOu0C0Q" playlist-prices.tsv

The script uses yt-dlp for playlist titles and Discogs for release prices.

YouTube liked videos to Discogs Wantlist

This can be done programmatically, but run it as a dry run first because YouTube video titles do not always map cleanly to Discogs release IDs.

Prerequisites:

• Install yt-dlp.
• Be signed in to YouTube in Chrome, or set YTDLP_BROWSER=firefox, safari, etc.
• Create a Discogs personal access token at https://www.discogs.com/settings/developers.
• Add these to .env:

DISCOGS_USER_TOKEN=your_discogs_user_token
DISCOGS_USERNAME=your_discogs_username

Preview matches without changing Discogs:

npm run wantlist:liked

Add confident matches to your Wantlist:

npm run wantlist:liked:apply

The report is written to liked-youtube-discogs-wantlist.tsv. Rows marked needs_review are deliberately not added automatically.

Configuration

• API Key & Secret: Before using the app, you must obtain a Consumer Key and Consumer Secret from Discogs. Copy .env.example to .env, then set VITE_KEY and VITE_SECRET.

Dependencies

• Discogs API: For fetching record data.
• A modern web browser with JavaScript enabled.

Contributing

Contributions to VinylValueCheck are welcome. Please follow the standard fork-and-pull request workflow.

License

This project is licensed under the MIT License - see the LICENSE file for details.

Support

For support, please open an issue in the GitHub repository.

Author

Jack Schofield