|
| 1 | +--- |
| 2 | +title: "Melodee 2.0.0 Released" |
| 3 | +date: 2026-05-01 |
| 4 | +badges: |
| 5 | + - type: info |
| 6 | + tag: release |
| 7 | +--- |
| 8 | + |
| 9 | +We're thrilled to announce the release of Melodee 2.0.0! This is a major milestone that brings powerful automation, a smoother first-time setup, security hardening, and a move to .NET 10. |
| 10 | + |
| 11 | +<!--more--> |
| 12 | + |
| 13 | +## What's New in 2.0.0 |
| 14 | + |
| 15 | +### Event Scripting |
| 16 | +Automate your library workflows with JavaScript-powered event scripts using the built-in Monaco code editor. |
| 17 | + |
| 18 | +- Write scripts that run on directory processing events |
| 19 | +- Context-aware code completion in the admin script editor |
| 20 | +- Deny actions with path validation and dry-run support |
| 21 | +- Validation and orchestration through the CLI |
| 22 | + |
| 23 | +### Onboarding Wizard |
| 24 | +New installations now include a guided setup wizard to get Melodee running in minutes. |
| 25 | + |
| 26 | +- Step-by-step administrator account setup |
| 27 | +- Automated health checks via the integrated Doctor service |
| 28 | +- Checklist-based configuration tracking |
| 29 | +- Admin dashboard warnings for incomplete setup |
| 30 | + |
| 31 | +### .NET 10 & DecentDB |
| 32 | +Melodee has been upgraded to .NET 10 for improved performance, and the database layer has moved from SQLite to DecentDB for better scalability and maintainability. |
| 33 | + |
| 34 | +- .NET 10 runtime support |
| 35 | +- DecentDB.EntityFrameworkCore integration |
| 36 | +- Cancellation support throughout MusicBrainz imports |
| 37 | +- Enhanced query performance and streaming imports |
| 38 | + |
| 39 | +### Playlist Import & Export |
| 40 | +Manage playlists more flexibly with standard file format support. |
| 41 | + |
| 42 | +- Import M3U and M3U8 playlists |
| 43 | +- Export playlists to M3U format |
| 44 | +- Seamless UI integration for playlist management |
| 45 | + |
| 46 | +### Security Hardening |
| 47 | +A comprehensive security audit and remediation effort across the entire codebase. |
| 48 | + |
| 49 | +- Rate limiting with custom rejection handling for API requests |
| 50 | +- Strict CORS policies and secure key generation |
| 51 | +- Centralized file path guarding for destructive operations |
| 52 | +- SSRF and resource exhaustion protections |
| 53 | +- Cache invalidation with concurrency safety |
| 54 | +- Correlation ID logging for observability |
| 55 | + |
| 56 | +### Docker Publishing |
| 57 | +Official Docker images are now published automatically on every release via GitHub Actions. |
| 58 | + |
| 59 | +- Multi-arch container images pushed to GHCR |
| 60 | +- Simplified deployment for self-hosted users |
| 61 | + |
| 62 | +### Additional Improvements |
| 63 | + |
| 64 | +- **Artist alias lookup** - Improved artist matching via alias database schema |
| 65 | +- **Bulk artist management** - Directory diagnosis and bulk operations in the admin UI |
| 66 | +- **Dashboard enhancements** - Admin checks, health warnings, and loading states |
| 67 | +- **MusicBrainz streaming importer** - Generic streaming methods with cancellation support |
| 68 | +- **Artist listing improvements** - Album counts and better pagination |
| 69 | +- **Track gap calculation** - Enhanced logic for identifying missing tracks |
| 70 | + |
| 71 | +## Upgrading |
| 72 | + |
| 73 | +To upgrade to 2.0.0, follow the [upgrade guide](/upgrade/). |
| 74 | + |
| 75 | +Database migrations will run automatically on startup. Note the migration from SQLite to DecentDB — review the migration notes if you are upgrading from an existing SQLite installation. |
| 76 | + |
| 77 | +## Documentation |
| 78 | + |
| 79 | +- [Event Scripting Guide](/event-scripting/) |
| 80 | +- [Onboarding Wizard](/onboarding/) |
| 81 | +- [Upgrade Guide](/upgrade/) |
| 82 | +- [Docker Deployment](/docker/) |
| 83 | +- [Security Overview](/security/) |
| 84 | + |
| 85 | +## Thank You |
| 86 | + |
| 87 | +Thanks to everyone who contributed to this release through bug reports, feature requests, security audits, and pull requests! |
| 88 | + |
| 89 | +Questions or feedback? Join our [Discord community](https://discord.gg/bfMnEUrvbp) or open an issue on [GitHub](https://github.com/melodee-project/melodee/issues). |
0 commit comments