MusicHoarder

KO | EN

gitlite — search

#golang #gemini #api #typescript #javascript #video #java #chatgpt #ruby #ai-agent

(★ 9)

Scan, fingerprint, enrich and organize your music library using MusicBrainz, Spotify and AcoustID.

File Explorer

ZIP Download

- settings.json
- - apple-design
  - design-taste-frontend
  - emil-design-eng
  - frontend-design
  - review-animations
- launch.json
- dotnet-tools.json
- - android.yml
  - aspire-deploy.yml
  - ci.yml
  - claude-code-review.yml
  - claude.yml
  - dependabot-auto-merge.yml
  - pr-preview-cleanup.yml
  - pr-preview.yml
  - release.yml
  - spotiflac-sidecar.yml
- dependabot.yml
- - .gitignore
  - build.gradle.kts
- - gradle-daemon-jvm.properties
  - libs.versions.toml
- .gitignore
- build.gradle.kts
- gradle.properties
- gradlew
- gradlew.bat
- README.md
- settings.gradle.kts
- - discover.png
  - inbox-review.png
  - pipeline-conveyor.png
  - stats.png
- SELF_HOSTING.md
- - mcp.json
- - opencode.json
  - svelte.json
- - extensions.json
  - mcp.json
- - generate-icons.ts
- - app.css
  - app.d.ts
  - app.html
  - hooks.client.ts
  - hooks.server.test.ts
  - hooks.server.ts
  - instrumentation.server.ts
- - apple-icon.png
  - icon-dark-32x32.png
  - icon-light-32x32.png
  - icon.svg
  - llms.txt
  - manifest.webmanifest
  - og-image.png
  - placeholder-user.jpg
  - placeholder.jpg
  - placeholder.svg
  - pricing.md
  - robots.txt
- .dockerignore
- .gitignore
- .mcp.json
- .prettierrc
- .releaserc
- AGENTS.md
- bun.lock
- CHANGELOG.md
- CLAUDE.md
- components.json
- Dockerfile
- eslint.config.mjs
- package.json
- README.md
- svelte.config.js
- tsconfig.json
- vite.config.ts
- vitest.config.ts
- - AppleMusicCatalogService.cs
  - AppleMusicCatalogTrack.cs
  - IAppleMusicCatalogService.cs
- - AlbumCoverWriter.cs
  - ArtistImageService.cs
  - ArtworkMatchVerifier.cs
  - CoverArtResolver.cs
  - CoverThumbnailService.cs
  - DestinationCoverFlagger.cs
  - EmbeddedPictureReader.cs
  - ExternalCoverArtFetcher.cs
  - ExternalCoverArtSweepBackgroundService.cs
- - AudioQuality.cs
  - ChromaprintComparer.cs
  - FingerprintSimilarityGate.cs
  - VideoAudioAligner.cs
- - AccountSwitchService.cs
  - AuthOptions.cs
  - AuthService.cs
  - BearerToken.cs
  - Capability.cs
  - ConsoleMagicLinkSender.cs
  - CurrentUser.cs
  - DemoSeederHostedService.cs
  - IAccountSwitchService.cs
  - IAuthService.cs
  - ICurrentUserAccessor.cs
  - IMagicLinkSender.cs
  - Invite.cs
  - IOwnerLookupService.cs
  - MagicLinkToken.cs
  - ResendMagicLinkSender.cs
  - ResendOptions.cs
  - Session.cs
  - SessionCookieService.cs
  - User.cs
  - UserRole.cs
  - WebAuthnCredential.cs
  - WebAuthnOptions.cs
  - WebAuthnService.cs
  - WellKnownUsers.cs
  - WireRole.cs
- - ServiceCollectionExtensions.cs
  - WebApplicationExtensions.cs
- - AlbumSummaryDto.cs
  - BulkApproveRequest.cs
  - EnrichmentResetRequest.cs
  - ManualReviewRequest.cs
  - SharedSongRowDto.cs
- - CoverArtArchiveClient.cs
  - ICoverArtArchiveClient.cs
- - yetracker-art.json
  - yetracker-tracklists.json
  - yetracker.json
- - DeezerCatalogService.cs
  - DeezerCatalogTrack.cs
  - IDeezerCatalogService.cs
- - PlaylistUrlParser.cs
- - AlbumCompletionBackgroundService.cs
  - AlbumCompletionEligibility.cs
  - AlbumCompletionIdentityResolver.cs
  - AlbumCompletionSweep.cs
  - AutomaticUpgradeSweep.cs
  - DownloadArtworkEmbedder.cs
  - DownloadBackgroundService.cs
  - DownloadProgressTracker.cs
  - DownloadProviderChain.cs
  - DownloadTagWriter.cs
  - IAudioFileProbe.cs
  - IDownloadProvider.cs
  - IUpgradeProvider.cs
  - MusicVideoAlignmentService.cs
  - MusicVideoBackgroundService.cs
  - MusicVideoChannel.cs
  - MusicVideoDownloader.cs
  - MusicVideoFileAnalyzer.cs
  - MusicVideoProbe.cs
  - QualityUpgradeBackgroundService.cs
  - QualityUpgradeChannel.cs
  - QualityUpgradeService.cs
  - StagedSourceReleaseBackgroundService.cs
  - StagedSourceReleaseService.cs
  - StagedSourceReleaseTracker.cs
  - StreamingFlacDownloadProvider.cs
  - WishlistDownloadProcessor.cs
  - YtDlpCookies.cs
  - YtDlpDownloadProvider.cs
  - YtDlpErrors.cs
  - YtDlpProcess.cs
- - AlbumDedupEndpoints.cs
  - AlbumQualityEndpoints.cs
  - AlbumsEndpoints.cs
  - ArtistDedupEndpoints.cs
  - ArtistsEndpoints.cs
  - AuthEndpoints.cs
  - DashboardEndpoints.cs
  - DebugEndpoints.cs
  - DedupActionsEndpoints.cs
  - DiscoverEndpoints.cs
  - DuplicatesEndpoints.cs
  - EnrichmentEndpoints.cs
  - FriendsEndpoints.cs
  - FrontendUrlResolver.cs
  - HistoryEndpoints.cs
  - ImportEndpoints.cs
  - InviteEndpoints.cs
  - LegacyScanEndpoints.cs
  - MusicVideoEndpoints.cs
  - PlaylistsEndpoints.cs
  - QualityEndpoints.cs
  - RadioEndpoints.cs
  - RunsEndpoints.cs
  - SettingsEndpoints.cs
  - SharedLibraryEndpoints.cs
  - SharesEndpoints.cs
  - SnapshotsEndpoints.cs
  - SongsEndpoints.cs
  - SoulseekEndpoints.cs
  - SpotifyEndpoints.cs
  - StorageEndpoints.cs
  - SyncEndpoints.cs
  - VersionEndpoints.cs
  - WebAuthnEndpoints.cs
  - WishlistEndpoints.cs
- - AcoustIdMatchValidator.cs
  - AcoustIdService.cs
  - ConsensusEvaluator.cs
  - EnrichmentAlgorithm.cs
  - EnrichmentBackgroundService.cs
  - EnrichmentOrchestrator.cs
  - EnrichmentPipelineChannel.cs
  - EnrichmentProgressTracker.cs
  - EnrichmentProviderResultExtensions.cs
  - EnrichmentQueries.cs
  - ForcedLyricsAligner.cs
  - IEnrichmentProvider.cs
  - LlmLyricsAligner.cs
  - LrcBuilder.cs
  - LrcLibService.cs
  - LyricsProbeBudget.cs
  - LyricsTimingCheckService.cs
  - LyricsTimingProbe.cs
  - LyricsTimingValidator.cs
  - LyricsTranscriptionRateLimiter.cs
  - LyricsTranscriptionService.cs
  - LyricsTranslationService.cs
  - MetadataMerger.cs
  - MusicBrainzDtos.cs
  - MusicBrainzResponseMapper.cs
  - MusicBrainzWebService.cs
  - ProviderRateLimitedException.cs
  - ProviderSearchQuery.cs
  - ReleaseClassifier.cs
  - ReleaseSelector.cs
  - SongSearchText.cs
  - TranslatedLyricsAssembler.cs
  - WinningCandidateApplier.cs
- - ActivityFeed.cs
- - ImportUrlParser.cs
  - YouTubeMetadataResolver.cs
- - FailureBackoffTracker.cs
  - IdleBackoffSweepLoop.cs
  - IngestRunMonitor.cs
  - JobManager.cs
  - PipelineSnapshot.cs
  - ProgressSnapshotFactory.cs
- - AlbumDuplicateDetector.cs
  - AlbumGroupKey.cs
  - AlbumIdentity.cs
  - AlbumIdentityReconciler.cs
  - AlbumProjection.cs
  - AlbumSplitHealer.cs
  - ArtistAliasMap.cs
  - ArtistCreditHealer.cs
  - ArtistDuplicateService.cs
  - CanonicalAlbumConsolidator.cs
  - DedupActionHistoryService.cs
  - DestinationPathResolver.cs
  - IDestinationPathResolver.cs
  - LibraryBuilderBackgroundService.cs
  - LibraryBuilderProgressTracker.cs
  - LibraryBuilderService.cs
  - LibraryBuildQuery.cs
  - LibraryDestinationCleaner.cs
  - M3uPlaylistWriter.cs
  - RadioRanker.cs
  - SongOriginResolver.cs
  - SpotifySaveDates.cs
  - UnreadableAudioFileException.cs
  - WrittenTagSet.cs
- - LogSanitizer.cs
- - AlbumOwnedTrackMatcher.cs
  - CandidateTextMatch.cs
  - CatalogCandidateScorer.cs
  - FuzzyTextMatch.cs
  - MatchWarnings.cs
  - MetadataQualityHeuristics.cs
  - ProviderIdentity.cs
  - SourceIdentityScorer.cs
  - TitleNormalizer.cs
  - VersionQualifier.cs
- - ArtistCreditNormalizer.cs
  - MultiValue.cs
  - ReleaseDateParser.cs
- - NavidromeLikeMatcher.cs
  - NavidromeLikeReconciler.cs
  - NavidromeLikeSyncBackgroundService.cs
  - NavidromeLikeSyncChannel.cs
  - NavidromeModels.cs
  - NavidromeSubsonicClient.cs
- - PipelineMetrics.cs
- - CookieSecuritySchemeTransformer.cs
- - FrontendOptions.cs
  - LyricsTimingOptions.cs
  - LyricsTranscriptionOptions.cs
  - LyricsTranslationOptions.cs
  - MusicEnricherOptions.cs
  - NavidromeOptions.cs
  - OptionsValidators.cs
  - QualityGradingOptions.cs
  - SlskdOptions.cs
  - SpotifyOptions.cs
  - StreamingFlacOptions.cs
  - SyncOptions.cs
- - AlbumCompletionState.cs
  - AlbumCoverFetchAttempt.cs
  - ArtistAlias.cs
  - ArtistImage.cs
  - CanonicalAlbum.cs
  - CanonicalAlbumQualityGrade.cs
  - CanonicalAlbumTrack.cs
  - DedupDismissal.cs
  - DemoTenantQueryExtensions.cs
  - DirectoryPreference.cs
  - EnrichmentSnapshot.cs
  - EnrichmentSnapshotSong.cs
  - ExportedPlaylist.cs
  - IngestRun.cs
  - LibraryShareGrant.cs
  - LibraryWriteEvent.cs
  - MusicHoarderDbContext.cs
  - MusicHoarderDbContextFactory.cs
  - RuntimeSettings.cs
  - SongDuplicateLink.cs
  - SongMetadata.cs
  - SongMetadataChange.cs
  - SongMusicVideo.cs
  - SongProviderAttempt.cs
  - SongQualityGrade.cs
  - SongShare.cs
  - SpotifySettings.cs
  - SpotifyTrackLibraryMatch.cs
  - TrackSyncState.cs
  - UpgradeRequest.cs
  - UserAwareModelCacheKeyFactory.cs
  - UserSongState.cs
  - WishlistItem.cs
  - WishlistSource.cs
- - DirectoryAvailability.cs
  - LibraryDirectoriesHealthCheck.cs
  - PipelinePurgeService.cs
  - PurgeStatusTracker.cs
- - launchSettings.json
- - AlbumGradingBackgroundService.cs
  - AlbumGradingChannel.cs
  - AlbumGradingDossier.cs
  - AlbumGradingDossierFactory.cs
  - AlbumGradingProgressTracker.cs
  - AlbumGradingPrompt.cs
  - AlbumGradingService.cs
  - GradeFreshness.cs
  - GradingIssueJson.cs
  - IAlbumGradingService.cs
  - IChatCompletionClient.cs
  - IQualityGradingService.cs
  - LatestGradeQueries.cs
  - OpenAiCompatibleChatClient.cs
  - QualityBucket.cs
  - QualityDossierFactory.cs
  - QualityGradingBackgroundService.cs
  - QualityGradingChannel.cs
  - QualityGradingProgressTracker.cs
  - QualityGradingPrompt.cs
  - QualityGradingService.cs
  - QualityRollup.cs
  - SongGradingDossier.cs
- - ReconfigurableRateLimiter.cs
  - RequestRateGate.cs
- - AutoScanBackgroundService.cs
  - DuplicateCandidateGenerator.cs
  - DuplicateDetectionService.cs
  - DuplicatePairConfirmer.cs
  - FileScanner.cs
  - FingerprintBackgroundService.cs
  - FingerprintProgressTracker.cs
  - FpcalcService.cs
  - IndexService.cs
  - MockFileGenerator.cs
  - ScannerBackgroundService.cs
  - ScanProgressTracker.cs
  - SongIdPair.cs
- - IRuntimeSettingsService.cs
  - RuntimeSettingsService.cs
- - LibraryScope.cs
  - SharedLibraryGrantResolver.cs
  - SharedSongProjection.cs
  - UserSongStateWriter.cs
- - EnrichmentSnapshotService.cs
  - IEnrichmentSnapshotService.cs
  - SnapshotComparison.cs
  - SnapshotConfigDiff.cs
- - ISlskdClient.cs
  - SlskdCandidateSelector.cs
  - SlskdClient.cs
  - SlskdDownloadProvider.cs
  - SlskdFileFetcher.cs
  - SlskdModels.cs
  - SoulseekSearchQuery.cs
  - UpgradeMergeService.cs
- - ISpotifyApiService.cs
  - ISpotifyCatalogSearchService.cs
  - ISpotifyLibraryComparisonService.cs
  - ISpotifyOAuthService.cs
  - PlaylistExportBackgroundService.cs
  - PlaylistExportService.cs
  - SpotifyApiService.cs
  - SpotifyAppCredentialsProvider.cs
  - SpotifyAppCredentialsResolver.cs
  - SpotifyCatalogSearchService.cs
  - SpotifyCatalogTrack.cs
  - SpotifyIsrcResolver.cs
  - SpotifyLibraryComparisonService.cs
  - SpotifyLibraryMatchBackgroundService.cs
  - SpotifyOAuthService.cs
  - SpotifyOAuthStateProtector.cs
  - SpotifyRedirectUriResolver.cs
  - SpotifyTokenRefreshHealth.cs
  - SpotifyTokenRefreshHealthCheck.cs
  - SpotifyTokenRefreshService.cs
  - SpotifyTokenResponse.cs
  - SpotifyTrackLibraryMatcher.cs
- - IStorageVolumeProbe.cs
  - StorageUsageBackgroundService.cs
  - StorageUsageCalculator.cs
  - StorageUsageSnapshot.cs
  - StorageUsageSnapshotStore.cs
- - StreamingFlacSidecarClient.cs
- - ISyncIngestService.cs
  - SyncIngestService.cs
  - SyncModels.cs
  - SyncPushClient.cs
  - TrackSyncBackgroundService.cs
  - TrackSyncChannel.cs
  - TrackSyncProcessor.cs
- - ReleaseUpdateMonitor.cs
  - SemVerComparer.cs
- - WishlistService.cs
  - WishlistSyncBackgroundService.cs
- appsettings.Development.json
- appsettings.json
- MusicHoarder.Api.csproj
- MusicHoarder.Api.http
- Program.cs
- - AppleMusicCatalogServiceTests.cs
- - AlbumCoverWriterAsyncTests.cs
  - ArtistImageServiceTests.cs
  - ArtworkMatchVerifierTests.cs
  - CoverArtArchiveClientTests.cs
  - CoverArtResolverTests.cs
  - CoverThumbnailServiceTests.cs
  - ExternalCoverArtFetcherTests.cs
  - ExternalCoverArtSweepBackgroundServiceTests.cs
  - StubExternalCoverArtFetcher.cs
  - TagLibEmbeddedPictureReaderTests.cs
- - AudioQualityTests.cs
  - ChromaprintComparerTests.cs
  - VideoAudioAlignerTests.cs
- - AccountSwitchServiceTests.cs
  - AuthenticationMiddlewareTests.cs
  - AuthServiceTests.cs
  - CapabilityTests.cs
  - DemoReadOnlyMiddlewareTests.cs
  - DemoSeederCredentialTests.cs
  - DemoSeederRealMediaTests.cs
  - InviteLifecycleTests.cs
  - MagicLinkSenderSelectionTests.cs
  - MemberWriteGuardMiddlewareTests.cs
  - MultiTenancyIsolationTests.cs
  - RequireAuthMiddlewareTests.cs
  - ResolveRelyingPartyTests.cs
  - TestAuth.cs
  - WebAuthnAuthorizationTests.cs
  - WebAuthnServiceTests.cs
- - DeezerAlbumLookupTests.cs
  - DeezerDiscoverBrowseTests.cs
  - FakeDeezerCatalogService.cs
- - PlaylistUrlParserTests.cs
- - AlbumCompletionSweepTests.cs
  - AutomaticUpgradeSweepTests.cs
  - DownloadArtworkEmbedderTests.cs
  - DownloadTagWriterTests.cs
  - FakeDownloadArtworkEmbedder.cs
  - FakeMusicVideoDownloader.cs
  - MusicVideoDownloaderTests.cs
  - MusicVideoFileAnalyzerTests.cs
  - MusicVideoProbeTests.cs
  - MusicVideoStaticSkipTests.cs
  - QualityUpgradeServiceTests.cs
  - StagedSourceReleaseServiceTests.cs
  - StreamingFlacDownloadProviderTests.cs
  - UpgradeProviderGateTests.cs
  - WishlistDownloadProcessorChainTests.cs
  - WishlistDownloadProcessorTests.cs
  - YtDlpCookiesTests.cs
  - YtDlpDownloadProviderTests.cs
  - YtDlpErrorsTests.cs
  - YtDlpProcessTests.cs
- - AlbumDetailEndpointTests.cs
  - AlbumQualityEndpointsTests.cs
  - AlbumTimelineEndpointTests.cs
  - AuthEndpointsTests.cs
  - CapabilityManagementTests.cs
  - DebugDirectoryTreeTests.cs
  - DebugPipelineSummaryTests.cs
  - DirectoryMatchTreeTests.cs
  - DuplicatesEndpointsTests.cs
  - EnrichFolderPrefixTests.cs
  - EnrichmentDetailHelperTests.cs
  - FriendsEndpointsTests.cs
  - GetRadioTests.cs
  - HistoryEndpointsTests.cs
  - InsightsEndpointTests.cs
  - InviteEndpointsTests.cs
  - LikesAndPlaysTests.cs
  - ListAlbumsTests.cs
  - ListSongsCaller.cs
  - ListSongsTests.cs
  - MusicVideoEndpointsTests.cs
  - QualityEndpointsTests.cs
  - ResetEnrichmentEndpointTests.cs
  - RestampWishlistDownloadsTests.cs
  - SharedLibraryEndpointsTests.cs
  - SharesEndpointsTests.cs
  - SongMediaEndpointsTests.cs
  - SongOriginTests.cs
  - StagedSourceEndpointsTests.cs
  - SyncEndpointsTests.cs
  - TranscribeLyricsEndpointTests.cs
  - UnifiedLikeAndPlayTests.cs
  - UnifiedSongsEndpointTests.cs
- - AcoustIdEnrichmentProviderTests.cs
  - AcoustIdMatchValidatorTests.cs
  - AlbumTracklistReconcilerTests.cs
  - AppleMusicEnrichmentProviderTests.cs
  - CanonicalAlbumFetchServiceTests.cs
  - CanonicalAlbumSourcesTests.cs
  - CatalogMatchResolverTests.cs
  - CatalogResultArtistsTests.cs
  - CatalogSearchPlannerTests.cs
  - ConsensusEvaluatorTests.cs
  - DeezerEnrichmentProviderTests.cs
  - EnrichmentOrchestratorTests.cs
  - EnrichmentPipelineChannelPriorityTests.cs
  - EnrichmentPipelineChannelTests.cs
  - EnrichmentProviderResultExtensionsTests.cs
  - EnrichmentRetrySweepTests.cs
  - EnrichmentWorkerBuildTriggerTests.cs
  - ForcedLyricsAlignerTests.cs
  - JuiceWrldTrackerLiveSmokeTests.cs
  - JuiceWrldTrackerServiceTests.cs
  - LrcBuilderTests.cs
  - LrcLibServiceTests.cs
  - LyricsTimingProbeTests.cs
  - LyricsTimingValidatorTests.cs
  - LyricsTranscriptionRateLimiterTests.cs
  - LyricsTranslationServiceTests.cs
  - ManualLockAndCooldownTests.cs
  - MetadataMergerTests.cs
  - MusicBrainzRecordingLookupTests.cs
  - MusicBrainzReleaseLookupTests.cs
  - MusicBrainzResponseMapperTests.cs
  - MusicBrainzWebEnrichmentProviderTests.cs
  - MusicBrainzWebServiceMappingTests.cs
  - ReleaseClassifierTests.cs
  - ReleaseSelectorTests.cs
  - SongSearchTextTests.cs
  - SpotifyApiEnrichmentProviderTests.cs
  - TrackerEnrichmentProviderTests.cs
  - TranslatedLyricsAssemblerTests.cs
  - UntaggedFreeTextLiveSmokeTests.cs
  - WinningCandidateApplierTests.cs
  - YeTrackerAlbumTracklistProviderTests.cs
  - YeTrackerCatalogServiceTests.cs
  - YeTrackerEnrichmentProviderTests.cs
- - silence.flac
  - silence.m4a
  - silence.mp3
  - silence.opus
- - ActivitySourceTests.cs
- - ImportUrlParserTests.cs
  - YouTubeMetadataResolverTests.cs
- - FailureBackoffTrackerTests.cs
  - IdleBackoffSweepLoopTests.cs
  - IngestRunMonitorTests.cs
  - JobManagerTests.cs
  - ProgressSnapshotFactoryTests.cs
- - AlbumArtistOscillationTests.cs
  - AlbumDuplicateDetectorTests.cs
  - AlbumGroupKeyTests.cs
  - AlbumIdentityReconcilerTests.cs
  - AlbumProjectionTests.cs
  - AlbumSplitHealerTests.cs
  - ArtistCreditHealerTests.cs
  - ArtistDuplicateServiceTests.cs
  - CanonicalAlbumConsolidatorTests.cs
  - DedupActionHistoryServiceTests.cs
  - DestinationPathResolverTests.cs
  - LibraryBuilderServiceTests.cs
  - LibraryBuildQueryTests.cs
  - LibraryDestinationCleanerTests.cs
  - M3uPlaylistWriterTests.cs
  - RadioRankerTests.cs
  - TagLibLibraryTagWriterTests.cs
  - WrittenTagSetTests.cs
- - AlbumOwnedTrackMatcherTests.cs
  - CandidateTextMatchTests.cs
  - CatalogCandidateScorerTests.cs
  - MetadataQualityHeuristicsTests.cs
  - ProviderIdentityTests.cs
  - SourceIdentityScorerTests.cs
  - TitleNormalizerTests.cs
  - VersionQualifierTests.cs
- - ReleaseDateParserTests.cs
- - NavidromeLikeMatcherTests.cs
  - NavidromeLikeReconcilerTests.cs
  - NavidromeSubsonicClientTests.cs
- - DemoTenantQueryExtensionsTests.cs
  - IngestRunScopingTests.cs
  - LyricsProvenanceTests.cs
  - RebuildOnMetadataChangeInterceptorTests.cs
  - SongAcquisitionIntentTests.cs
  - SongMetadataCanonicalCorrectionTests.cs
  - SongMetadataLyricsRecheckTests.cs
  - SongMetadataLyricsTranslationTests.cs
  - SongMetadataResetTests.cs
- - DirectoryAvailabilityMonitorTests.cs
  - PipelinePurgeServiceTests.cs
- - AlbumGradingDossierFactoryTests.cs
  - AlbumGradingServiceTests.cs
  - AlbumGradingSweepTests.cs
  - GradeFreshnessTests.cs
  - GradingFailureBackoffTests.cs
  - GradingIssueJsonTests.cs
  - LatestGradeQueriesTests.cs
  - OpenAiCompatibleChatClientTests.cs
  - QualityBucketTests.cs
  - QualityDossierFactoryTests.cs
  - QualityGradingChannelTests.cs
  - QualityGradingOptionsTests.cs
  - QualityGradingPromptTests.cs
  - QualityGradingServiceTests.cs
  - QualityGradingSweepTests.cs
  - QualityRollupTests.cs
- - ReconfigurableRateLimiterTests.cs
  - RequestRateGateTests.cs
- - AutoScanBackgroundServiceTests.cs
  - DuplicateCandidateGeneratorTests.cs
  - DuplicateDetectionServiceTests.cs
  - DuplicatePairConfirmerTests.cs
  - FileScannerTests.cs
  - IndexServiceTests.cs
- - RuntimeSettingsServiceTests.cs
- - LibraryScopeResolverTests.cs
  - RecordingEnqueuers.cs
  - SharedLibraryGrantResolverTests.cs
  - SharedProjectionSurfaceTests.cs
  - TestLibraryScope.cs
- - EnrichmentSnapshotServiceTests.cs
  - SnapshotComparisonTests.cs
- - SlskdCandidateSelectorTests.cs
  - SoulseekSearchQueryTests.cs
  - UpgradeMergeServiceTests.cs
- - PlaylistExportServiceTests.cs
  - SpotifyApiServiceTests.cs
  - SpotifyAppCredentialsResolverTests.cs
  - SpotifyCatalogSearchServiceTests.cs
  - SpotifyLibraryComparisonServiceTests.cs
  - SpotifyOAuthServiceTests.cs
  - SpotifyOAuthStateProtectorTests.cs
  - SpotifyRedirectUriResolverTests.cs
  - SpotifySettingsTests.cs
  - SpotifyTrackLibraryMatcherTests.cs
- - StorageUsageCalculatorTests.cs
- - SyncIngestServiceTests.cs
  - TrackSyncProcessorTests.cs
- - SemVerComparerTests.cs
  - VersionEndpointsTests.cs
- - WishlistServiceTests.cs
  - WishlistSyncBackgroundServiceTests.cs
- MusicHoarder.Api.Tests.csproj
- TestPipelineMetrics.cs
- - docker-compose.yaml
- - docker-compose.yaml
- - launchSettings.json
- AppHost.cs
- appsettings.Development.json
- appsettings.json
- ComposeFileExtensions.cs
- MusicHoarder.AppHost.csproj
- Extensions.cs
- MusicHoarder.ServiceDefaults.csproj
- check-aspire-compose-drift.sh
- dokploy-preview.sh
- - app.py
  - Dockerfile
  - README.md
  - requirements.txt
- - yetracker_import.py
.dockerignore
.env.example
.gitignore
.mcp.json
AGENTS.md
aspire.config.json
CLAUDE.md
CONTRIBUTING.md
docker-compose.build.yml
docker-compose.yml
Dockerfile
Dockerfile.api-base
LICENSE
MusicHoarder.slnx
nuget.config
opencode.jsonc
README.md
SECURITY.md
skills-lock.json

# Use via CDN

jsDelivr

jsDelivr serves any public GitHub repository as a CDN with zero setup. Pick a version and a file to get a ready-to-paste link and snippet.

Version

File

Link

Example

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

**Fix your messy music library — automatically — then browse, play, like, and grow it.**

MusicHoarder is a self-hosted, open-source app that scans a large, disorganized music collection
(including NAS/SMB shares), identifies each track by its actual audio, enriches it with proper
metadata, and builds a clean, consistently-organized copy — without ever touching your originals.
Once it's clean, it's also a full music app: browse, play, like, get stats, discover new playlists,
and grow your library from Spotify or Soulseek.

[![CI](https://github.com/Jeffreyyvdb/MusicHoarder/actions/workflows/ci.yml/badge.svg)](https://github.com/Jeffreyyvdb/MusicHoarder/actions/workflows/ci.yml)
[![License: MIT](https://img.shields.io/badge/license-MIT-blue.svg)](https://raw.githubusercontent.com/Jeffreyyvdb/MusicHoarder/main/LICENSE)

If you've ever ended up with thousands of files like `track_047.mp3`, duplicate rips at different
bitrates, missing artwork, and inconsistent folder names, this is for you. Point it at your source
library, let it run, and review anything it isn't sure about.

![The Pipeline "Conveyor" — a live dashboard showing source files flowing through Scan → Fingerprint → Match → Decide → AI grade → Dedupe → Library, with a "Needs you" review queue](https://raw.githubusercontent.com/Jeffreyyvdb/MusicHoarder/main/docs/screenshots/pipeline-conveyor.png)

## Features

### Identify, enrich & organize

- **Audio fingerprinting** — identifies each track by its actual sound (AcoustID/Chromaprint), not
  by unreliable filenames or existing tags, so `track_047.mp3` gets recognized for what it is.
- **Multi-provider enrichment with consensus** — every song is matched independently by up to six
  sources — **AcoustID**, **MusicBrainz**, **Spotify**, **Apple Music**, **Deezer**, and community
  trackers — and a consensus evaluator derives the verdict by agreement: when two or more providers
  land on the same recording it auto-matches, a lone fingerprint hit only becomes a candidate, and
  conflicting confident matches go to review. Every provider is individually toggleable, and the app
  degrades gracefully when a credential is missing.
- **Non-destructive, quality-aware tagging** — source files are always read-only; clean copies are
  written to a separate destination library. Matching never blindly overwrites good tags — empty
  fields are filled, a curated value that disagrees is kept and logged as a *proposed* change unless
  a strong consensus justifies the upgrade, and every applied or proposed change is recorded.
- **Whole-album reconciliation & healing** — because tracks are enriched independently, one real
  album can split across release IDs, titles, years, or artist spellings. A build-time reconciler
  elects one canonical identity per folder and tags every track with it, keeping albums whole in
  players like Navidrome. It's build-time and reversible — your per-track enrichment is untouched.
- **Canonical album tracklists** — cross-checks each album against MusicBrainz, Spotify, Apple
  Music, and Deezer to build the *full* tracklist, so the album view shows every real track and
  greys out the ones you're missing.
- **Cover art** — resolves album artwork (folder image → embedded picture, then Cover Art Archive →
  Deezer → iTunes when a file has none), validates it, and writes a single cover into each
  destination folder so players show the real sleeve.
- **Duplicate detection** — groups songs by identical fingerprint and elects the best copy (codec
  tier and bitrate, then metadata trustworthiness, then file size) so only the best version is built.
- **Synced lyrics + AI transcription** — fetches time-synced (karaoke-style) or plain lyrics from
  LRCLIB, embeds them into the built file, and shows them in the app with a synced/plain toggle.
  *Optional, experimental:* when no lyrics exist anywhere, an OpenAI-compatible **Whisper** pass
  (default `whisper-1`; repoint it at Groq or a self-hosted model) transcribes the audio into a fresh
  synced `.lrc` from Whisper's word/segment timestamps — stored **separately** from any curated
  lyrics and clearly marked, so it never overwrites the real thing. No key → the feature is just off.
- **Community trackers** *(optional)* — artist-scoped catalogs cover leaks, alternate versions, and
  unreleased albums that mainstream services don't, gated to a per-artist allowlist.

### Review & quality

- **Manual review Inbox** — a three-tab review surface with live counts: **Tag review**
  (low-confidence matches to approve, correct, or bulk-approve above a confidence threshold),
  **Duplicates** (A/B compare of fingerprint twins), and **AI flagged** (matches the grader marked
  Wrong or Questionable). Nothing is a dead end — unmatched and leaked tracks stay visible.
- **Optional AI quality grading** — an LLM grades each match (and whole-album matches) with a 0–100
  score, verdict, summary, and issue codes, powering rollups and flagged/verified buckets so you can
  triage what actually needs attention. OpenAI-compatible; defaults to OpenRouter, works with a local
  Ollama. Re-gradeable when the prompt or model changes.

![The Inbox — a low-confidence match showing each provider's candidate with a confidence score, and a From → Will-write-to field diff before anything is written](https://raw.githubusercontent.com/Jeffreyyvdb/MusicHoarder/main/docs/screenshots/inbox-review.png)

### Browse, play & grow your library

- **Web UI** — browse by album, artist, track, folder, or liked; play in a persistent
  Apple-Music-style bar that survives navigation; jump anywhere with a ⌘K palette; open any track's
  full-screen provenance panel (Metadata / Lyrics / Fingerprint / Enrichment) and pipeline timeline;
  and watch every stage stream live — all fully responsive on mobile.
- **Likes, play tracking & Liked Songs** — heart any track for a Spotify-style Liked Songs view;
  playback is tracked (play count + last-played) to power most-played, recently-added, and
  "never played" shelves.
- **Stats & overview dashboards** — a "hoard at a glance" insights page (hero counts, pipeline and
  wishlist funnels, metadata-coverage rings, top artists, format breakdowns) plus a personalized home
  built from your real play and like history.
- **Discover playlists** *(optional)* — browse Deezer-backed editorial and chart playlists by genre
  or search, or paste a Spotify/Deezer playlist link, then subscribe so new tracks are wishlisted
  and (with downloads enabled) fetched automatically.
- **Spotify sync** *(optional)* — connect a Spotify account (read-only) and browse your Liked Songs
  and playlists with every track's local-library match shown inline. Add any playlist (or your Liked
  Songs) as an **auto-syncing wishlist source** so new additions flow in on their own, see a
  track-by-track *in-library vs missing* comparison, and a fast poll picks up songs you just liked
  within seconds.
- **Wishlist with auto-download** *(optional)* — everything wishlisted (from Spotify sync or
  Discover) is turned into an actual file by an ordered fetch chain: a self-run
  [slskd](https://github.com/slskd/slskd) (Soulseek) first, then a yt-dlp fallback that keeps native
  Opus and stamps the authoritative identity so the download enriches correctly and lands in the
  right album. Already-owned tracks are skipped; failures retry individually or in bulk. The whole
  *liked → wishlisted → downloaded → in library* journey is charted on the Stats page. Off by default.
- **Playlist export** *(optional)* — mirror your Spotify Liked Songs or any playlist as a static
  `.m3u8` file in the destination library, in order, so Navidrome/Plex/Jellyfin auto-import it.
- **Public share links & share view** — mint a revocable, no-account link scoped to a single track
  or a whole album. The public page is a chrome-free player with ambient artwork pulled from the
  cover, an album queue that plays straight through, and a **full-screen synced-lyrics theater** that
  scrolls line-by-line with the song and follows the queue as it advances. Nothing else in your
  library is exposed, and the link is revocable anytime. With the Android app installed, share and
  invite links open natively in the app (verified App Links; see `android/README.md`).
- **Friend accounts & sharing** — invite people by email (Settings → People mints a one-time link)
  to create their own listen-only account, then share albums, artists, or your entire library per
  friend. Friends get the full listening app — Overview, Albums/Artists/Tracks with search and
  filters, synced-lyrics theater, music videos, and their own likes and play history — over
  exactly what you granted. Your library stays scoped to your account, every grant is revocable,
  and removing a friend disables their account and signs them out everywhere.
- **Library history** — an audit log of every change written to the destination (album
  consolidations, artist renames, year corrections, cover art, per-field tag diffs), so you can see
  exactly "what Navidrome sees differently."

![The Discover page — Deezer-backed editorial and chart playlists with genre filters, a paste-a-link box, and one-click subscribe](https://raw.githubusercontent.com/Jeffreyyvdb/MusicHoarder/main/docs/screenshots/discover.png)

### Optional integrations

- **Navidrome two-way like sync** — keeps song likes in sync in both directions with a Navidrome
  server via its Subsonic *starred* API (immediate push on toggle + periodic reconcile).
- **Soulseek quality upgrades** — manually queue a search for a strictly-better copy of a track or
  album on Soulseek (via slskd); the better file is swapped **in place**, keeping the track's id,
  enrichment, and lyrics.
- **Instance sync (NAS → VPS)** — push finished tracks from a private instance to a public one over
  plain HTTPS. A portable fingerprint-based existence check means only missing or better-quality
  files transfer, in-place replacement keeps the remote's track ids stable, and an at-least-once
  outbox with retries survives crashes.

### Platform

- **Passwordless auth + read-only demo** — sign in by emailed magic link or WebAuthn passkey
  (Touch ID / Windows Hello / security key), with Owner (full control), Friend (invited, listen-only,
  sees only what the owner shared), and Demo (read-only) roles. A one-click
  **[Try the demo](https://musichoarder.app/login)** account browses and plays a seeded library
  while every mutating action is denied.
- **Self-hosted** — runs on your own hardware via .NET Aspire (dev) or Docker Compose (prod),
  pulling prebuilt GHCR images. Your music never leaves your machine.

![The Stats dashboard — hero counts (in library, covers added, lyrics added, hours of music), a pipeline funnel, a Spotify wishlist journey, and metadata-coverage rings](https://raw.githubusercontent.com/Jeffreyyvdb/MusicHoarder/main/docs/screenshots/stats.png)

## How it works

The pipeline is a state machine over each song, run by background workers that each sweep for work
in the status they handle:

```
Source library
   → Scan          index files (incl. SMB/NAS) and read embedded tags
   → Fingerprint   compute an audio fingerprint (fpcalc/Chromaprint)
   → Match         identify via AcoustID, then match against MusicBrainz,
                   Spotify, Apple Music, Deezer + community trackers
   → Decide        a consensus evaluator derives the verdict from all providers
   → AI grade      (optional) an LLM scores the match/metadata quality
   → Dedupe        detect duplicate recordings, keep the best copy
   → Build         copy + tag + organize into the destination library
```

Confident matches flow straight through to a clean destination library; uncertain ones — and
anything the AI grader flags — surface in the **Inbox** for a human decision. The source is never
modified, and removed/missing files are soft-deleted rather than purged. The whole flow is visible
live on the **Pipeline → Conveyor** dashboard.

## Tech stack

| Project | Description |
|---------|-------------|
| `MusicHoarder.Api` | ASP.NET Core minimal API — endpoints, EF Core/PostgreSQL persistence, and the background services that run the pipeline, enrichment providers, sync, and downloads |
| `MusicHoarder.AppHost` | .NET Aspire AppHost — composes the API, frontend, and PostgreSQL for local dev |
| `MusicHoarder.ServiceDefaults` | Shared cross-cutting defaults (health checks, OpenTelemetry, resilient HTTP) |
| `frontend` | SvelteKit 2 + Svelte 5 + Bun — the full web app: library browser, built-in player, live pipeline/conveyor, review Inbox, Discover, Stats, and share pages |

---

## Quickstart (local development)

### Prerequisites

- .NET 10 SDK
- Docker (for PostgreSQL via Aspire)
- Bun (frontend toolchain); Node.js 22 only for the semantic-release step
- `fpcalc` (`libchromaprint-tools`) for fingerprinting
- [Aspire CLI](https://aspire.dev) (optional — enables `aspire run`; otherwise use `dotnet run`)

### Run with Aspire (recommended)

```bash
aspire run
```

That's the whole thing. On first run the Aspire dashboard (at `https://localhost:17072`) prompts for
the two required values — your **source** and **destination** library paths — then provisions
PostgreSQL in Docker, launches the API, and starts the frontend. EF Core migrations are applied
automatically.

> No Aspire CLI? `dotnet run --project MusicHoarder.AppHost` does exactly the same thing. Install
> the CLI with `curl -sSL https://aspire.dev/install.sh | bash`.

**Optional — skip the prompts.** Pre-seed the paths (and any provider keys) as AppHost user-secrets
so boots are unattended and repeatable:

```bash
mkdir -p /tmp/musichoarder-source /tmp/musichoarder-dest
dotnet user-secrets set "Parameters:source-directory" "/tmp/musichoarder-source" --project MusicHoarder.AppHost
dotnet user-secrets set "Parameters:destination-directory" "/tmp/musichoarder-dest" --project MusicHoarder.AppHost
```

Drop a few audio files into your source directory, then trigger a scan from the UI (or let the
pipeline auto-run) to watch them flow through. Prefer to click around first? Open `/login` and hit
**Try the demo** for a read-only, seeded library.

### Frontend (standalone)

The AppHost runs the frontend via `.WithBun()`. To start it separately:

```bash
cd frontend && MUSICHOARDER_API_URL=http://localhost:<api-port> PORT=3000 bun run dev
```

Find the API port in the Aspire dashboard.

### Run tests

```bash
dotnet test MusicHoarder.Api.Tests/MusicHoarder.Api.Tests.csproj
```

The xUnit suite uses an in-memory EF Core provider — no PostgreSQL or Docker required.

---

## Configuration

All options live under the `MusicEnricher` section in `appsettings.json` or as environment variables
using the `MusicEnricher__` prefix.

| Key | Description | Required |
|-----|-------------|----------|
| `MusicEnricher__SourceDirectory` | Path to the source music library | Yes |
| `MusicEnricher__DestinationDirectory` | Path for the cleaned destination library | Yes |
| `MusicEnricher__AutoStartPipeline` | Auto-run the *processing* cascade (scan→fingerprint→enrich→build, enrichment backfill/retry sweep). Discovery (file indexing) always runs so the library still populates. Set `false` to require manual triggering of the heavy steps — useful in resource-constrained environments. | No (default: `true`) |
| `MusicEnricher__TempDirectory` | Scratch space for in-progress work | No (default: `/tmp/musicenricher`) |
| `MusicEnricher__AcoustIdApiKey` | AcoustID API key for fingerprint-to-MusicBrainz lookup | No (enrichment falls back to `NeedsReview` without it) |
| `MusicEnricher__AcoustIdScoreThreshold` | Minimum confidence score to accept a match (0–1) | No (default: `0.85`) |
| `MusicEnricher__SmbConcurrency` | Parallel file reads from SMB | No (default: `8`) |
| `MusicEnricher__EnrichmentWorkerConcurrency` | Parallel AcoustID lookups | No (default: `2`) |
| `ConnectionStrings__musichoarderdb` | PostgreSQL connection string | Yes (injected by Aspire in dev) |

Everything in the **Optional integrations** and several **Browse & grow** features above are off
until configured: Spotify (metadata + import) needs a registered Spotify app and the OAuth relay;
Discover/wishlist auto-download needs slskd and/or yt-dlp; Navidrome sync, instance sync, AI quality
grading, and the experimental AI lyrics transcription each have their own config sections
(`QualityGrading__`, `LyricsTranscription__`, sync/Navidrome/slskd settings). Lyrics transcription is
**hidden in the UI unless `LyricsTranscription__ApiKey` is set**. See the
[self-hosting guide](docs/SELF_HOSTING.md#optional-integrations) for the full reference.

---

## Self-host

Run MusicHoarder on your own box or NAS with Docker. The shipped `docker-compose.yml` **pulls
prebuilt images** from GHCR (`ghcr.io/jeffreyyvdb/musichoarder/{api,frontend}`) — no repo checkout
or build toolchain required. A localhost trial needs just the compose file:

```bash
mkdir musichoarder && cd musichoarder
curl -fsSLO https://raw.githubusercontent.com/Jeffreyyvdb/MusicHoarder/main/docker-compose.yml
docker compose up -d
```

The web UI is then at `http://localhost:3000` (API at `:5050`); migrations apply automatically.
Sign in as `owner@musichoarder.local` — the login link is printed to the API logs
(`docker compose logs api | grep -i magic`), no email service needed.

An `.env` is optional for the trial — every value has a working localhost default. For a real
deployment, grab [`.env.example`](.env.example) and set `POSTGRES_PASSWORD`, `MUSIC_SOURCE_PATH`,
`MUSIC_DESTINATION_PATH`, `OWNER_EMAIL`, and `PUBLIC_BASE_URL`.

The app serves plain HTTP — put it behind your own reverse proxy for TLS and point
`PUBLIC_BASE_URL` at the external URL.

**→ Full guide:** [docs/SELF_HOSTING.md](docs/SELF_HOSTING.md) — env reference, first login,
reverse proxy, Portainer/TrueNAS, optional integrations (AcoustID, Spotify, AI grading, AI lyrics
transcription, Navidrome sync, instance sync, Umami), updating, backups, build-from-source, and
troubleshooting.

---

## Deployment (CI/CD)

The whole repo (API **and** frontend together) is versioned as a single line by
[semantic-release](https://github.com/semantic-release/semantic-release). Deployment is
release-driven — only a semantic-release version publishes images and redeploys; routine
`chore`/`docs`/`refactor` pushes do not.

```
Push to main
     ↓
ci.yml          — dotnet build+test, frontend lint/check/test (also on PRs)
     ↓
release.yml     — semantic-release analyzes Conventional Commits; if warranted,
                  cuts a `vX.Y.Z` tag + GitHub Release, then dispatches ↓
     ↓
aspire-deploy.yml — builds the API + frontend images, pushes them to GHCR, semver-tags
                  them, then calls the Dokploy API to redeploy the Compose stack
```

The version bump follows the commit prefix — `fix:` → patch, `feat:` → minor,
`feat!:`/`BREAKING CHANGE:` → major; `chore`/`docs`/`refactor`/`test`/`style` cut no release. The
[Releases page](https://github.com/Jeffreyyvdb/MusicHoarder/releases) is the canonical changelog.

### Zero-downtime deploys

The prod compose (`MusicHoarder.AppHost/aspire-output/docker-compose.yaml`) declares a Swarm
`deploy.update_config` (`order: start-first`) plus Docker `healthcheck`s on the `api` and `frontend`
services. To get zero-downtime rollouts you must run the stack as a **Docker Stack (Swarm)** — in
Dokploy set the Compose service's **Compose Type to "Docker Stack"**. Swarm then starts the new task,
waits for its healthcheck to pass, and only then removes the old one, so there is no 502 window.
(Because Swarm ignores `pull_policy`, the stack deploy must run with `--resolve-image always` so the
unchanged `:latest` reference still re-pulls the newest digest.)

These keys are inert under plain `docker compose up` (Compose ignores `deploy.update_config`), so the
[Self-host](#self-host) path above is unaffected and keeps its current stop-then-start behavior —
self-hosters who want zero-downtime can likewise run their stack via `docker stack deploy`.

Operational detail — PR preview environments, the Spotify OAuth relay, and the Dokploy setup — lives
in the heavily-commented workflow files under [`.github/workflows/`](.github/workflows).

---

## Pipeline notes

### fpcalc + AcoustID

`fpcalc` (Chromaprint) is included in the Docker image via `libchromaprint-tools`. Without
`MusicEnricher__AcoustIdApiKey`, enrichment sets songs to `NeedsReview` rather than `Matched`, and
the Library Builder skips them.

### Library views

The Library **Overview / Albums / Artists / All tracks** views show what's in your destination
library; the **Pipeline → Conveyor** dashboard shows the full source-to-destination flow, and the
**Inbox** holds anything awaiting a human decision.

### EF Core migrations

Migrations are applied automatically on container startup in all environments. No manual migration
steps are required after a new image is deployed.

---

## Contributing & license

- **Contributing:** see [CONTRIBUTING.md](CONTRIBUTING.md). Commit messages follow
  [Conventional Commits](https://www.conventionalcommits.org/) — they drive the shared
  semantic-release version.
- **Security:** report vulnerabilities per [SECURITY.md](SECURITY.md).
- **License:** [MIT](LICENSE).

MusicHoarder

Owner Repos

File Explorer

# Use via CDN

Was this content helpful?

Recent Feedback

MusicHoarder

Owner Repos

File Explorer

# Use via CDN

Was this content helpful?

Recent Feedback

Download README