Skip to content

Releases: themetaman/discat-script

DisCat v1.0 - First Release! 🐱

09 Feb 05:12
107f57c

Choose a tag to compare

DisCat v1.0 - GitHub Release Notes 🐱

First Release!

DisCat (Discogs Catalog) is a cross-platform tool for managing your Discogs music collection.

✨ Features

  • 📥 Download complete collection with all metadata
  • Smart caching - 5-10x faster incremental updates
  • 📅 Timestamped exports - Track collection changes over time
  • 📁 Folder support - Organize by your Discogs folders
  • 💰 Marketplace data - Price tracking and availability
  • 🔄 Sync to custom fields - Automate metadata management
  • 🖥️ GUI + CLI - Point-and-click or command-line
  • 🐱 Cross-platform - Windows, Mac, Linux

🚀 Quick Start

# Install
pip install requests

# Configure (choose one):
# 1. Copy config.env.example to config.env and edit
# 2. Use GUI: python discogs_gui.py
# 3. Edit scripts directly

# Run
python discogs_gui.py
# or
python 1_download_collection.py -c

📦 What's Included

Applications:

  • discogs_gui.py - GUI application
  • 1_download_collection.py - Download tool with caching
  • 2_sync_custom_fields.py - Metadata sync tool

Documentation:

  • README.md - Complete guide
  • QUICKSTART.md - Quick reference
  • CACHING_GUIDE.md - Speed optimization
  • CUSTOM_FIELDS_GUIDE.md - Sync workflows
  • DROPDOWN_FIELDS_GUIDE.md - Validation guide
  • START_HERE.txt - Welcome guide
  • INSTALL.txt - Installation

Configuration:

  • config.env.example - Configuration template
  • .gitignore - Git ignore file
  • LICENSE - MIT License
  • CONTRIBUTING.md - Contribution guidelines

🔧 Requirements

  • Python 3.7+
  • requests library (install with pip install requests)
  • Discogs account with API token

📊 Speed Comparison

Task Without Cache With Cache
First download 15-20 min N/A
Weekly update 15-20 min 2 min
No changes 15-20 min 30 sec

🐛 Known Issues

None yet! This is the first release.

🤝 Contributing

DisCat is fork-friendly and minimal-support. See CONTRIBUTING.md.

  • ✅ Forks encouraged
  • ✅ Pull requests welcome
  • ⚠️ Limited support
  • 📚 Documentation first

📄 License

MIT License - See LICENSE

🙏 Credits

Built with Python and the Discogs API.

Thanks to the Discogs community for maintaining the world's largest music database!


 /\_/\  
( ^.^ ) 
 > ^ <   

Happy collecting with DisCat! 🎵