🚀 Stardust Distro CLI

Open-source, npm-installable music distribution software for the modern age.

Stardust Distro enables artists, labels, and distributors to deploy a fully functional, DDEX-compliant distribution system with enterprise-grade features and global delivery capabilities.

Introduction

Stardust Distro is a production-ready music distribution platform, built with an open-source core and MIT license. You get a fully functional system with catalog management, DDEX ERN generation with lifecycle tracking, all delivery protocols, and comprehensive testing tools — everything needed to run a global distribution platform.

✅ Complete Distribution Platform

• Full catalog management system with unlimited releases
• DDEX ERN generation (3.8.2, 4.2, 4.3) + Apple Music XML (5.3.23)
• All delivery protocols built-in (FTP, SFTP, S3, API, Azure)
• 200+ genre classifications with visual mapping
• DDEX MEAD 1.1 implementation for enhanced metadata
• Mobile-first UI that works on any device

✅ Enterprise-Grade Features

• Smart catalog migration with API-enhanced bulk imports
• App Security: DOMPurify XSS prevention and Zod schema validation
• Modern Authentication: Firebase Auth with RBAC
• Idempotency protection and delivery retry logic
• Audio fingerprinting with MD5, SHA-256, and similarity detection
• Powered by Google Cloud for 99.95% uptime SLA

✅ Zero Setup Hassles

• Pre-configured Firebase backend (free tier available)
• Auto-save drafts & version control
• Built-in production testing suite
• Professional UI with light/dark themes
• Comprehensive documentation included

⚡ Quick Start

# Create your distribution platform
npx @stardust-distro/cli create my-music-platform

# Navigate to your new platform
cd my-music-platform

# Start local development
npm run dev
# Visit http://localhost:5173

# Deploy to production (requires Firebase account)
npm run deploy
# Your platform is live at https://my-music-platform.web.app 🚀

That's it! You now have a fully functional music distribution platform.

🛠️ CLI Commands

# Project Management
stardust-distro create <name>    # Create new distribution platform
stardust-distro init             # Initialize Firebase configuration
stardust-distro deploy           # Deploy to production
stardust-distro update           # Update to latest version

# Development
stardust-distro dev              # Start development server
stardust-distro build            # Build for production
stardust-distro test             # Run test suite

# Configuration
stardust-distro config           # Configure platform settings
stardust-distro target add       # Add DSP delivery target
stardust-distro target test      # Test delivery connection
stardust-distro target list      # List configured targets

# Operations
stardust-distro import           # Import existing catalog
stardust-distro backup           # Backup platform data
stardust-distro restore          # Restore from backup

🎨 What Can You Build?

For Record Labels

npx @stardust-distro/cli create my-label
# → Complete distribution system for your label
# → Manage thousands of artists and releases

For Aggregators

npx @stardust-distro/cli create my-distro
# → Multi-tenant architecture
# → Manage multiple labels/artists

For Artists

npx @stardust-distro/cli create my-music
# → Direct control of catalog assets
# → Professional tools at your fingertips

🛠️ Tech Stack

Built with modern web technologies for maximum performance and developer experience:

• Frontend: Vue 3 (Composition API) with Vite build tool
• Language: JavaScript ES6+ with TypeScript support
• Backend: Firebase (Google Cloud Platform)
  • Firestore for NoSQL, schemaless database
  • Cloud Functions v2 for serverless processing
  • Cloud Storage for asset management
  • Firebase Auth for authentication
• UI/UX: Custom CSS architecture with theming support
• Package Manager: npm/yarn compatible

🔐 Multi-layer Security

• Encrypted Credentials: All DSP credentials encrypted at rest
• Input Validation: DOMPurify + Zod schemas on all inputs
• Rate Limiting: 100 req/min reads, 20 req/min writes
• File Security: Magic number validation, size limits (500MB audio, 10MB images)
• Audit Logs: Complete activity tracking with immutable logs

📈 Performance

Built for major catalogs:

• ✓ Handle 1 million+ releases
• ✓ Process 1,000+ concurrent deliveries
• ✓ Import hundreds of releases with one drag and click
• ✓ 99.95% uptime with Google Cloud SLA

🆓 Open Source

• MIT License: Use commercially, modify freely, no restrictions
• Self-Hosted: Your data, your infrastructure, your control
• Firebase Optimized: Works best with Firebase (free tier available)
• Extensible: Add custom features, integrate with your existing systems

📚 Documentation & Support

• 📖 Full Documentation - Comprehensive guides and API reference
• 🐛 Report Issues - Found a bug? Let us know
• ⭐ Star on GitHub - Show your support

🤝 Contributing

We welcome contributions! Whether it's bug fixes, new features, or documentation improvements:

git clone https://github.com/daddykev/stardust-distro.git
cd stardust-distro
npm run install:all
# Make your changes
npm test
# Submit PR

See CONTRIBUTING.md for detailed guidelines.

🚦 Current Status

v1.0.5 - Alpha Release (September 2025)

• ✅ Production ready for early adopters
• ✅ All core features complete
• ✅ Security audit passed

🗺️ Roadmap

• v1.1: DSR (sales reporting) integration
• v1.2: Advanced royalty management
• v1.3: Mobile app companions (iOS/Android)
• v2.0: AI-powered metadata enhancement

📮 Get Started Now

npx @stardust-distro/cli create my-platform

Your music distribution platform awaits. Join the open-source music distribution revolution.

Built for the music industry using Vue 3 and Firebase

Part of the Stardust Ecosystem - Open-source tools for modern music distribution