Releases: themetaman/discat-script
Releases · themetaman/discat-script
DisCat v1.0 - First Release! 🐱
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 application1_download_collection.py- Download tool with caching2_sync_custom_fields.py- Metadata sync tool
Documentation:
README.md- Complete guideQUICKSTART.md- Quick referenceCACHING_GUIDE.md- Speed optimizationCUSTOM_FIELDS_GUIDE.md- Sync workflowsDROPDOWN_FIELDS_GUIDE.md- Validation guideSTART_HERE.txt- Welcome guideINSTALL.txt- Installation
Configuration:
config.env.example- Configuration template.gitignore- Git ignore fileLICENSE- MIT LicenseCONTRIBUTING.md- Contribution guidelines
🔧 Requirements
- Python 3.7+
requestslibrary (install withpip 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! 🎵