This script allows you to import albums into Discogs from a CSV file, ensuring that your collection is accurately transferred while avoiding duplicates.

• Imports albums into a specific Discogs collection folder.
• Uses Discogs release IDs for precise importing.
• Avoids duplicates by checking if the album already exists.
• Supports CSV input via command-line arguments.
• Retrieves the latest version of discogs_client from GitHub.

• Python 3.13+ is required.
• A Discogs API token (see configuration section).
• pip and venv installed.

git clone https://github.com/guroot/discogs-import.git
cd discogs-import

python3 -m venv venv
source venv/bin/activate  # On Windows: venv\Scripts\activate

pip install -r requirements.txt

👉 This will install the latest discogs_client from GitHub, as well as pandas for CSV handling.

1. Create a config.ini file in the project directory:

   [Discogs]
   user_agent = DiscogsImporter/1.0
   token = YOUR_DISCOGS_TOKEN_HERE
   username = YOUR_USER_NAME_HERE
   collection_folder = YOUR_FOLDER_HERE

2. Replace YOUR_DISCOGS_TOKEN_HERE YOUR_USER_NAME_HERE YOUR_FOLDER_HERE with your own information.

   • You can generate an API token on Discogs Developer Portal.

python3 import.py

👉 This will use discogs_export.csv by default.

python3 import.py my_collection.csv

👉 Replace my_collection.csv with your own CSV export.

python3 import.py --help

👉 Displays:

usage: import.py [csv_file]

Import albums into Discogs from a CSV file.

positional arguments:
  csv_file   Path to the CSV file (default: discogs_export.csv)

The script requires a CSV file with at least the following columns:

Example CSV content:

release_id,Label,Title
123456,Blue Note,Kind of Blue
789012,Columbia,The Wall

Feel free to submit pull requests or open an issue if you find bugs or want to suggest improvements. 🎵

This project is open-source under the MIT License.

• Discogs API - Discogs Developer Portal
• Python Libraries - discogs_client, pandas
• Developed by: Jonathan Fleury ---(https://github.com/guroot)