``` ├── .dockerignore ├── .env.example (omitted) ├── .github/ ├── FUNDING.yml ├── ISSUE_TEMPLATE/ ├── bug_report.yml (600 tokens) ├── config.yml ├── feature_request.yml (400 tokens) ├── PULL_REQUEST_TEMPLATE.md (200 tokens) ├── workflows/ ├── docker-nightly.yml (400 tokens) ├── docker-publish.yml (900 tokens) ├── integration.yml (800 tokens) ├── nightly.yml (800 tokens) ├── pr-checks.yml (600 tokens) ├── security.yml (700 tokens) ├── .gitignore (400 tokens) ├── CHANGELOG.md (22.3k tokens) ├── CONTRIBUTING.md (300 tokens) ├── Dockerfile (4.8k tokens) ├── LICENSE (omitted) ├── README.md (8.5k tokens) ├── assets/ ├── screenshots/ ├── deezer-browse.png ├── desktop-album.png ├── desktop-artist.png ├── desktop-audiobooks.png ├── desktop-home.png ├── desktop-library.png ├── desktop-player.png ├── desktop-podcasts.png ├── desktop-settings.png ├── mobile-album.png ├── mobile-artist.png ├── mobile-audiobooks.png ├── mobile-home.png ├── mobile-library.png ├── mobile-login.png ├── mobile-player.png ├── mobile-podcasts.png ├── mood-mixer.png ├── reddit post/ ├── desktop-home.png ├── desktop-podcasts.png ├── mobile-home.png ├── mobile-player.png ├── vibe-overlay.png ├── spotify-import-preview.png ├── vibe-blend.png ├── vibe-drift.png ├── vibe-galaxy.png ├── vibe-map.png ├── vibe-overlay.png ├── backend/ ├── .dockerignore (100 tokens) ├── .gitignore (100 tokens) ├── Dockerfile (400 tokens) ├── docker-entrypoint.sh (600 tokens) ├── healthcheck.js (100 tokens) ├── jest.config.js (100 tokens) ├── migrate-safe.sh (500 tokens) ├── migrations/ ├── audio_analysis_cleanup_fix.sql (200 tokens) ├── package-lock.json (80.3k tokens) ├── package.json (500 tokens) ├── prisma/ ├── migrations/ ├── 20250101000000_rename_soulseek_fallback/ ├── migration.sql (100 tokens) ├── 20250102000000_add_user_token_version/ ├── migration.sql (100 tokens) ├── 20250102000001_add_downloadjob_targetmbid_index/ ├── migration.sql (100 tokens) ├── 20251130000000_init/ ├── migration.sql (7.6k tokens) ├── 20251225000000_add_missing_track_updated_at/ ├── migration.sql (100 tokens) ├── 20251225100000_add_similar_artists_json/ ├── migration.sql ├── 20251226000000_add_mood_bucket_system/ ├── migration.sql (500 tokens) ├── 20251229004706_add_enrichment_concurrency/ ├── migration.sql ├── 20251229043907_add_metadata_overrides/ ├── migration.sql (200 tokens) ├── 20251230000000_add_podcast_audiobook_search_vectors/ ├── migration.sql (1200 tokens) ├── 20251230234224_add_enrichment_and_overrides/ ├── migration.sql (200 tokens) ├── 20251231041041_add_original_year_to_album/ ├── migration.sql ├── 20260101152925_add_lidarr_webhook_secret/ ├── migration.sql ├── 20260102142537_add_analysis_started_at/ ├── migration.sql ├── 20260102150000_add_audio_analyzer_workers/ ├── migration.sql ├── 20260103045951_add_lastfm_api_key/ ├── migration.sql ├── 20260104000000_add_soulseek_concurrent_downloads/ ├── migration.sql ├── 20260107000000_add_download_source_columns/ ├── migration.sql (100 tokens) ├── 20260118000000_add_partial_unique_index_active_downloads/ ├── migration.sql (100 tokens) ├── 20260123181610_add_artist_counts_and_indexes/ ├── migration.sql (100 tokens) ├── 20260127000000_add_pgvector/ ├── migration.sql (200 tokens) ├── 20260128000000_add_clap_workers/ ├── migration.sql ├── 20260128100000_reduce_embedding_dimension/ ├── migration.sql (200 tokens) ├── 20260130000000_add_similarity_functions/ ├── migration.sql (600 tokens) ├── 20260204100000_add_vibe_analysis_fields/ ├── migration.sql (100 tokens) ├── 20260207000000_add_music_search_vector_triggers/ ├── migration.sql (500 tokens) ├── 20260214115252_add_download_job_unique_constraint/ ├── migration.sql (100 tokens) ├── 20260214121222_add_webhook_events/ ├── migration.sql (200 tokens) ├── 20260214145320_standardize_integration_config/ ├── migration.sql (100 tokens) ├── 20260214_add_discovery_batch_version/ ├── migration.sql ├── 20260221000000_add_public_url/ ├── migration.sql ├── 20260221184459_add_subsonic_listen_source/ ├── migration.sql ├── 20260222000000_add_album_title_index/ ├── migration.sql ├── 20260222100000_nullable_download_job_target_mbid/ ├── migration.sql ├── 20260222110000_add_enrichment_status_indexes/ ├── migration.sql (100 tokens) ├── 20260223000000_lastfm_tags_default_empty_array/ ├── migration.sql (100 tokens) ├── 20260226000000_add_registration_open_setting/ ├── migration.sql ├── 20260227000000_add_lidarr_profile_settings/ ├── migration.sql ├── 20260227100000_add_track_lyrics/ ├── migration.sql (100 tokens) ├── 20260302000000_add_share_links/ ├── migration.sql (200 tokens) ├── 20260303000000_add_podcast_cache_headers/ ├── migration.sql ├── 20260304000000_add_source_url_to_import_job/ ├── migration.sql ├── 20260305000000_add_isrc_to_track_and_pending/ ├── migration.sql ├── 20260305000000_add_missing_from_disk_to_pending_track/ ├── migration.sql ├── 20260305000000_add_subsonic_bookmarks/ ├── migration.sql (200 tokens) ├── 20260305000000_add_subsonic_play_queue/ ├── migration.sql (100 tokens) ├── 20260305000001_add_corrupt_flag_to_track/ ├── migration.sql ├── 20260307000000_switch_ivfflat_to_hnsw/ ├── migration.sql (100 tokens) ├── 20260309000000_add_scan_status/ ├── migration.sql ├── 20260401000000_add_disc_number_to_track/ ├── migration.sql ├── migration_lock.toml ├── schema.prisma (5.9k tokens) ├── scripts/ ├── backfill-original-year.ts (900 tokens) ├── create-test-user.ts (100 tokens) ├── duplicateLibrary.ts (700 tokens) ├── generateVibeVocabulary.ts (700 tokens) ├── recalibrateAnalysis.ts (500 tokens) ├── seeds/ ├── createUser.ts (200 tokens) ├── src/ ├── __mocks__/ ├── p-queue.cjs (100 tokens) ├── test-env.cjs (100 tokens) ├── config.ts (700 tokens) ├── data/ ├── featureProfiles.ts (6.1k tokens) ├── vibe-vocabulary.json (520.9k tokens) ├── index.ts (4.6k tokens) ├── jobs/ ├── __tests__/ ├── manual-webhook-reconciliation-test.md (400 tokens) ├── queueCleaner.ts (4.9k tokens) ├── webhookReconciliation.ts (1600 tokens) ├── lib/ ├── soulseek/ ├── client.ts (4.8k tokens) ├── common.ts ├── downloads.ts (500 tokens) ├── index.ts ├── listen.ts (300 tokens) ├── messages/ ├── common.ts (100 tokens) ├── from/ ├── index.ts ├── peer-init.ts (200 tokens) ├── peer.ts (1000 tokens) ├── server.ts (800 tokens) ├── index.ts ├── message-builder.ts (200 tokens) ├── message-parser.ts (300 tokens) ├── message-stream.ts (200 tokens) ├── to/ ├── index.ts ├── peer.ts (700 tokens) ├── server.ts (500 tokens) ├── peer.ts (500 tokens) ├── server.ts (400 tokens) ├── utils/ ├── types.ts (100 tokens) ├── middleware/ ├── __tests__/ ├── auth.test.ts (2.3k tokens) ├── auth.ts (1300 tokens) ├── errorHandler.ts (300 tokens) ├── rateLimiter.ts (600 tokens) ├── subsonicAuth.ts (1000 tokens) ├── routes/ ├── __tests__/ ├── auth.route.test.ts (2.3k tokens) ├── library-albums.route.test.ts (2.5k tokens) ├── playlists.route.test.ts (2.1k tokens) ├── share.route.test.ts (2.5k tokens) ├── webhooks.route.test.ts (2.3k tokens) ├── analysis.ts (4.8k tokens) ├── apiKeys.ts (700 tokens) ├── artists.ts (4.8k tokens) ├── audiobooks.ts (6.2k tokens) ├── auth.ts (3.5k tokens) ├── browse.ts (2.2k tokens) ├── deviceLink.ts (1300 tokens) ├── discover.ts (19.2k tokens) ├── downloads.ts (5.6k tokens) ├── enrichment.ts (5.6k tokens) ├── events.ts (500 tokens) ├── eventsTicket.ts (100 tokens) ├── homepage.ts (1300 tokens) ├── library.ts (100 tokens) ├── library/ ├── albums.ts (1300 tokens) ├── artists.ts (6.5k tokens) ├── backfill.ts (300 tokens) ├── coverArt.ts (3.4k tokens) ├── index.ts (200 tokens) ├── scan.ts (700 tokens) ├── streaming.ts (1200 tokens) ├── tracks.ts (11.2k tokens) ├── listeningState.ts (600 tokens) ├── mixes.ts (3.8k tokens) ├── notifications.ts (5.9k tokens) ├── offline.ts (1800 tokens) ├── onboarding.ts (3.9k tokens) ├── playbackState.ts (1100 tokens) ├── playlists.ts (8.7k tokens) ├── plays.ts (500 tokens) ├── podcasts.ts (11.9k tokens) ├── recommendations.ts (3.2k tokens) ├── releases.ts (1700 tokens) ├── search.ts (2.1k tokens) ├── settings.ts (600 tokens) ├── share.ts (3.1k tokens) ├── soulseek.ts (3.6k tokens) ├── spotify.ts (3k tokens) ├── subsonic/ ├── artistInfo.ts (600 tokens) ├── compat.ts (1300 tokens) ├── index.ts (1100 tokens) ├── library.ts (5.8k tokens) ├── lyrics.ts (900 tokens) ├── mappers.ts (1200 tokens) ├── playback.ts (3.8k tokens) ├── playlists.ts (2k tokens) ├── podcasts.ts (1000 tokens) ├── profile.ts (200 tokens) ├── queue.ts (1500 tokens) ├── search.ts (3.4k tokens) ├── starred.ts (800 tokens) ├── userHelpers.ts (200 tokens) ├── userManagement.ts (1300 tokens) ├── system.ts (100 tokens) ├── systemSettings.ts (5.4k tokens) ├── vibe.ts (3.2k tokens) ├── webhooks.ts (1900 tokens) ├── services/ ├── __tests__/ ├── README.md (200 tokens) ├── audioAnalysisCleanup.test.ts (2.1k tokens) ├── audioScanValidator.test.ts (800 tokens) ├── audioStreaming.test.ts (800 tokens) ├── coverRepair.test.ts (800 tokens) ├── enrichmentFailureService.test.ts (900 tokens) ├── imageStorage.test.ts (300 tokens) ├── m3uParser.test.ts (500 tokens) ├── musicPathConfig.test.ts (1200 tokens) ├── musicScanner.test.ts (2.4k tokens) ├── search.test.ts (1200 tokens) ├── soulseek-search-strategies.test.ts (600 tokens) ├── webhookEventStore.test.ts (1500 tokens) ├── acquisitionService.ts (7.4k tokens) ├── artistCountsService.ts (1100 tokens) ├── audioAnalysisCleanup.ts (2.3k tokens) ├── audioScanValidator.ts (400 tokens) ├── audioStreaming.ts (3.6k tokens) ├── audiobookCache.ts (3k tokens) ├── audiobookshelf.ts (3.3k tokens) ├── coverArt.ts (500 tokens) ├── coverArtExtractor.ts (400 tokens) ├── dataCache.ts (2.8k tokens) ├── deezer.ts (5.3k tokens) ├── discoverWeekly.ts (25.2k tokens) ├── discovery/ ├── __tests__/ ├── discoveryAlbumLifecycle.test.ts (3.4k tokens) ├── discoveryBatchLogger.test.ts (1100 tokens) ├── discoverySeeding.test.ts (3.8k tokens) ├── discoveryAlbumLifecycle.ts (1400 tokens) ├── discoveryBatchLogger.ts (400 tokens) ├── discoverySeeding.ts (2.2k tokens) ├── index.ts (100 tokens) ├── optimisticBatchUpdate.ts (800 tokens) ├── discoveryLogger.ts (1200 tokens) ├── downloadQueue.ts (5k tokens) ├── enrichment.ts (3.8k tokens) ├── enrichmentFailureService.ts (2.5k tokens) ├── enrichmentState.ts (2.1k tokens) ├── eventBus.ts (300 tokens) ├── fanart.ts (1500 tokens) ├── featureDetection.ts (800 tokens) ├── hybridSimilarity.ts (1500 tokens) ├── imageBackfill.ts (2.3k tokens) ├── imageProvider.ts (2.5k tokens) ├── imageStorage.ts (1500 tokens) ├── itunes.ts (2.2k tokens) ├── lastfm.ts (7.1k tokens) ├── lidarr.ts (22k tokens) ├── lrclib.ts (300 tokens) ├── m3uParser.ts (400 tokens) ├── mixes/ ├── discoveryMixes.ts (1600 tokens) ├── genreMixes.ts (2.9k tokens) ├── helpers.ts (1800 tokens) ├── index.ts (2.5k tokens) ├── moodMixes.ts (12.2k tokens) ├── timeMixes.ts (900 tokens) ├── moodBucketService.ts (4.7k tokens) ├── musicScanner.ts (8.9k tokens) ├── musicbrainz.ts (7.2k tokens) ├── notificationPolicyService.ts (2.7k tokens) ├── notificationService.ts (1300 tokens) ├── podcastCache.ts (1600 tokens) ├── podcastDownload.ts (3.3k tokens) ├── podcastindex.ts (300 tokens) ├── programmaticPlaylists.ts ├── rateLimiter.ts (2.3k tokens) ├── rss-parser.ts (2.3k tokens) ├── search.ts (5.1k tokens) ├── simpleDownloadManager.ts (19k tokens) ├── songPath.ts (1700 tokens) ├── songlink.ts (800 tokens) ├── soulseek-search-strategies.ts (2.1k tokens) ├── soulseek.ts (16.9k tokens) ├── spotify.ts (11.1k tokens) ├── spotifyImport.ts (25.2k tokens) ├── staleJobCleanup.ts (1400 tokens) ├── textEmbeddingBridge.ts (400 tokens) ├── trackIdentity.ts (1100 tokens) ├── umapProjection.ts (2.8k tokens) ├── vibeVocabulary.ts (2k tokens) ├── webhookEventStore.ts (1200 tokens) ├── wikidata.ts (1000 tokens) ├── ytdlp.ts (800 tokens) ├── types/ ├── express-session.d.ts (omitted) ├── lidarr.ts (900 tokens) ├── soulseek.ts (200 tokens) ├── utils/ ├── artistNormalization.ts (2.7k tokens) ├── async.ts (300 tokens) ├── cacheWrapper.ts (400 tokens) ├── colorExtractor.ts (1500 tokens) ├── configValidator.ts (1100 tokens) ├── dateFilters.ts (300 tokens) ├── db.ts (300 tokens) ├── distributedLock.ts (300 tokens) ├── embedding.ts (100 tokens) ├── encryption.ts (900 tokens) ├── envWriter.ts (700 tokens) ├── errors.ts (600 tokens) ├── fuzzyMatch.ts (500 tokens) ├── logger.ts (200 tokens) ├── metadataOverrides.ts (300 tokens) ├── metrics.ts (600 tokens) ├── normalization.ts (400 tokens) ├── normalize.ts ├── playlistLogger.ts (1600 tokens) ├── queryMonitor.ts (200 tokens) ├── rangeParser.ts (300 tokens) ├── redis.ts (100 tokens) ├── shuffle.ts (100 tokens) ├── ssrf.ts (400 tokens) ├── subsonicResponse.ts (500 tokens) ├── systemSettings.ts (500 tokens) ├── workers/ ├── __tests__/ ├── dataCleanup.test.ts (1000 tokens) ├── enrichmentStateMachine.test.ts (3.5k tokens) ├── artistEnrichment.ts (3.8k tokens) ├── artistEnrichmentWorker.ts (600 tokens) ├── audioCompletionSubscriber.ts (1100 tokens) ├── dataCleanup.ts (900 tokens) ├── dataIntegrity.ts (3k tokens) ├── discoverCron.ts (500 tokens) ├── enrichmentQueues.ts (400 tokens) ├── index.ts (2.7k tokens) ├── moodBucketWorker.ts (700 tokens) ├── organizeSingles.ts (1800 tokens) ├── podcastEnrichmentWorker.ts (400 tokens) ├── processors/ ├── discoverProcessor.ts (500 tokens) ├── importProcessor.ts (200 tokens) ├── scanProcessor.ts (5k tokens) ├── queues.ts (300 tokens) ├── trackEnrichmentWorker.ts (500 tokens) ├── umapWorker.ts (100 tokens) ├── unifiedEnrichment.ts (13.4k tokens) ├── tsconfig.json (100 tokens) ├── tsconfig.production.json ├── deploy.sh (400 tokens) ├── docker-compose.dev.yml (400 tokens) ├── docker-compose.prod.yml (400 tokens) ├── docker-compose.server.yml (1000 tokens) ├── docker-compose.services.yml (600 tokens) ├── docker-compose.yml (2.5k tokens) ├── frontend/ ├── .dockerignore (100 tokens) ├── .gitignore (100 tokens) ├── Dockerfile (500 tokens) ├── app/ ├── album/ ├── [id]/ ├── page.tsx (2.3k tokens) ├── api/ ├── events/ ├── route.ts (400 tokens) ├── ticket/ ├── route.ts (300 tokens) ├── artist/ ├── [id]/ ├── loading.tsx ├── page.tsx (2.2k tokens) ├── audiobooks/ ├── [id]/ ├── page.tsx (1400 tokens) ├── loading.tsx ├── page.tsx (6.4k tokens) ├── series/ ├── [name]/ ├── page.tsx (3.6k tokens) ├── browse/ ├── playlists/ ├── [id]/ ├── page.tsx (5.1k tokens) ├── page.tsx (6.8k tokens) ├── collection/ ├── loading.tsx ├── page.tsx (3.7k tokens) ├── device/ ├── page.tsx (3.8k tokens) ├── discover/ ├── page.tsx (2.9k tokens) ├── error.tsx (100 tokens) ├── favicon.ico ├── global-error.tsx (200 tokens) ├── globals.css (3k tokens) ├── import/ ├── playlist/ ├── page.tsx (11.8k tokens) ├── spotify/ ├── page.tsx (100 tokens) ├── layout.tsx (800 tokens) ├── library/ ├── page.tsx ├── loading.tsx ├── login/ ├── page.tsx (3.6k tokens) ├── manifest.webmanifest/ ├── route.ts (600 tokens) ├── mix/ ├── [id]/ ├── page.tsx (4k tokens) ├── onboarding/ ├── page.tsx (9.1k tokens) ├── page.tsx (1700 tokens) ├── playlist/ ├── [id]/ ├── page.tsx (12.3k tokens) ├── playlists/ ├── loading.tsx ├── page.tsx (7.9k tokens) ├── podcasts/ ├── [id]/ ├── page.tsx (1800 tokens) ├── genre/ ├── [genreId]/ ├── page.tsx (1900 tokens) ├── loading.tsx ├── page.tsx (6.9k tokens) ├── queue/ ├── loading.tsx ├── page.tsx (3.9k tokens) ├── radio/ ├── page.tsx (2.8k tokens) ├── register/ ├── page.tsx (900 tokens) ├── releases/ ├── page.tsx (2.4k tokens) ├── search/ ├── loading.tsx ├── page.tsx (3.7k tokens) ├── settings/ ├── loading.tsx ├── page.tsx (1900 tokens) ├── setup/ ├── page.tsx (300 tokens) ├── share/ ├── [token]/ ├── SharePageClient.tsx (4.5k tokens) ├── layout.tsx (100 tokens) ├── page.tsx (300 tokens) ├── sync/ ├── page.tsx (2.6k tokens) ├── vibe/ ├── page.tsx (3.7k tokens) ├── assets/ ├── SpotIcon.png ├── icon.png ├── components/ ├── MetadataEditor.tsx (4.4k tokens) ├── MixCard.tsx (900 tokens) ├── MoodMixer.tsx (2.5k tokens) ├── ServiceWorkerRegistration.tsx (500 tokens) ├── activity/ ├── ActiveDownloadsTab.tsx (1800 tokens) ├── DiscoverSettingsTab.tsx (2.2k tokens) ├── HistoryTab.tsx (2.2k tokens) ├── ImportsTab.tsx (2.4k tokens) ├── NotificationsTab.tsx (2.5k tokens) ├── cards/ ├── MediaCard.tsx (800 tokens) ├── layout/ ├── ActivityPanel.tsx (2.6k tokens) ├── AuthenticatedLayout.tsx (1700 tokens) ├── BottomNavigation.tsx (700 tokens) ├── MobileSidebar.tsx (1800 tokens) ├── Sidebar.tsx (4.9k tokens) ├── TVLayout.tsx (2.5k tokens) ├── TopBar.tsx (3.5k tokens) ├── UnifiedPanel.tsx (900 tokens) ├── lyrics/ ├── LyricsPanel.tsx (700 tokens) ├── MobileLyricsView.tsx (600 tokens) ├── player/ ├── FullPlayer.tsx (5.9k tokens) ├── KeyboardShortcutsTooltip.tsx (600 tokens) ├── MediaControlsHandler.tsx (100 tokens) ├── MiniPlayer.tsx (6.7k tokens) ├── OverlayPlayer.tsx (4.1k tokens) ├── PlayerModeWrapper.tsx (100 tokens) ├── SeekSlider.tsx (1900 tokens) ├── SleepTimer.tsx (1200 tokens) ├── UniversalPlayer.tsx (400 tokens) ├── providers/ ├── AudioErrorBoundary.tsx (200 tokens) ├── ConditionalAudioProvider.tsx (500 tokens) ├── GlobalErrorBoundary.tsx (500 tokens) ├── ui/ ├── AudiobookCard.tsx (900 tokens) ├── Badge.tsx (200 tokens) ├── Button.tsx (400 tokens) ├── CachedImage.tsx (200 tokens) ├── Card.tsx (200 tokens) ├── ConfirmDialog.tsx (800 tokens) ├── EmptyState.tsx (200 tokens) ├── FormElements.tsx (500 tokens) ├── GalaxyBackground.tsx (500 tokens) ├── GradientSpinner.tsx (400 tokens) ├── HorizontalCarousel.tsx (1100 tokens) ├── InlineStatus.tsx (1200 tokens) ├── LoadingScreen.tsx (100 tokens) ├── Modal.tsx (400 tokens) ├── OperationConfirmToast.tsx (500 tokens) ├── PlayableCard.tsx (1600 tokens) ├── PlaylistSelector.tsx (2.6k tokens) ├── docker-entrypoint.sh (200 tokens) ├── eslint.config.mjs (100 tokens) ├── features/ ├── album/ ├── components/ ├── AlbumActionBar.tsx (800 tokens) ├── AlbumHero.tsx (1700 tokens) ├── SimilarAlbums.tsx (300 tokens) ├── TrackList.tsx (2.5k tokens) ├── hooks/ ├── useAlbumActions.ts (1000 tokens) ├── useAlbumData.ts (300 tokens) ├── types.ts (300 tokens) ├── artist/ ├── components/ ├── ArtistActionBar.tsx (700 tokens) ├── ArtistBio.tsx (100 tokens) ├── ArtistHero.tsx (1700 tokens) ├── AvailableAlbums.tsx (1200 tokens) ├── Discography.tsx (600 tokens) ├── PopularTracks.tsx (2.1k tokens) ├── SimilarArtists.tsx (1000 tokens) ├── index.ts (100 tokens) ├── hooks/ ├── index.ts ├── useArtistActions.ts (800 tokens) ├── useArtistData.ts (600 tokens) ├── useDownloadActions.ts (500 tokens) ├── types.ts (400 tokens) ├── audiobook/ ├── components/ ├── AudiobookActionBar.tsx (900 tokens) ├── AudiobookHero.tsx (1700 tokens) ├── ChapterList.tsx (400 tokens) ├── hooks/ ├── useAudiobookActions.ts (800 tokens) ├── useAudiobookData.ts (400 tokens) ├── types.ts (300 tokens) ├── discover/ ├── components/ ├── DiscoverActionBar.tsx (500 tokens) ├── DiscoverHero.tsx (900 tokens) ├── HowItWorks.tsx (500 tokens) ├── TrackList.tsx (2000 tokens) ├── UnavailableAlbums.tsx (1500 tokens) ├── constants.ts (100 tokens) ├── hooks/ ├── useDiscoverActions.ts (900 tokens) ├── useDiscoverData.ts (1000 tokens) ├── usePreviewPlayer.ts (1000 tokens) ├── types.ts (200 tokens) ├── home/ ├── components/ ├── ArtistsGrid.tsx (700 tokens) ├── AudiobooksGrid.tsx (600 tokens) ├── ContinueListening.tsx (1100 tokens) ├── FeaturedPlaylistsGrid.tsx (1100 tokens) ├── HomeHero.tsx (300 tokens) ├── LibraryRadioStations.tsx (2000 tokens) ├── MixesGrid.tsx (100 tokens) ├── PodcastsGrid.tsx (700 tokens) ├── PopularArtistsGrid.tsx (600 tokens) ├── SectionHeader.tsx (400 tokens) ├── hooks/ ├── useHomeData.ts (1000 tokens) ├── radioData.ts (2.3k tokens) ├── types.ts (300 tokens) ├── library/ ├── components/ ├── AlbumsGrid.tsx (1300 tokens) ├── ArtistsGrid.tsx (1300 tokens) ├── LibraryHeader.tsx (300 tokens) ├── LibraryTabs.tsx (500 tokens) ├── LibraryToolbar.tsx (700 tokens) ├── TracksList.tsx (2.3k tokens) ├── hooks/ ├── useLibraryActions.ts (900 tokens) ├── types.ts (200 tokens) ├── podcast/ ├── components/ ├── ContinueListening.tsx (1400 tokens) ├── EpisodeList.tsx (2.3k tokens) ├── PodcastActionBar.tsx (1100 tokens) ├── PodcastHero.tsx (1500 tokens) ├── PreviewEpisodes.tsx (1400 tokens) ├── SimilarPodcasts.tsx (800 tokens) ├── hooks/ ├── usePodcastActions.ts (1100 tokens) ├── usePodcastData.ts (1000 tokens) ├── types.ts (200 tokens) ├── utils.ts ├── search/ ├── components/ ├── AliasResolutionBanner.tsx (100 tokens) ├── EmptyState.tsx (100 tokens) ├── LibraryAlbumsGrid.tsx (300 tokens) ├── LibraryAudiobooksGrid.tsx (300 tokens) ├── LibraryPodcastsGrid.tsx (400 tokens) ├── LibraryTracksList.tsx (1300 tokens) ├── SearchFilters.tsx (1000 tokens) ├── SimilarArtistsGrid.tsx (400 tokens) ├── SoulseekBrowser.tsx (3.9k tokens) ├── TVSearchInput.tsx (600 tokens) ├── TopResult.tsx (1000 tokens) ├── UnifiedSongsList.tsx (1900 tokens) ├── soulseekHelpers.tsx (300 tokens) ├── hooks/ ├── useSearchData.ts (400 tokens) ├── useSoulseekSearch.ts (1400 tokens) ├── types.ts (500 tokens) ├── settings/ ├── components/ ├── sections/ ├── AIServicesSection.tsx (1200 tokens) ├── AccountSection.tsx (3.1k tokens) ├── AudiobookshelfSection.tsx (800 tokens) ├── CacheSection.tsx (11.5k tokens) ├── CorruptTracksSection.tsx (1100 tokens) ├── DownloadPreferencesSection.tsx (1000 tokens) ├── LidarrSection.tsx (1300 tokens) ├── PlaybackSection.tsx (400 tokens) ├── SoulseekSection.tsx (800 tokens) ├── StoragePathsSection.tsx (400 tokens) ├── SubsonicSection.tsx (1900 tokens) ├── UserManagementSection.tsx (2000 tokens) ├── ui/ ├── SettingsInput.tsx (400 tokens) ├── SettingsLayout.tsx (900 tokens) ├── SettingsRow.tsx (200 tokens) ├── SettingsSection.tsx (300 tokens) ├── SettingsSelect.tsx (300 tokens) ├── SettingsSidebar.tsx (500 tokens) ├── SettingsToggle.tsx (200 tokens) ├── index.ts (100 tokens) ├── hooks/ ├── useSettingsData.ts (400 tokens) ├── useSystemSettings.ts (1200 tokens) ├── useTwoFactor.ts (900 tokens) ├── types.ts (300 tokens) ├── vibe/ ├── ActivityIconBar.tsx (400 tokens) ├── VibeAlchemy.tsx (2.5k tokens) ├── VibeMap.tsx (3.5k tokens) ├── VibePanelSheet.tsx (800 tokens) ├── VibeSongPath.tsx (1200 tokens) ├── VibeToolbar.tsx (800 tokens) ├── mapUtils.ts (1200 tokens) ├── panel-shared.tsx (600 tokens) ├── scenes/ ├── GravityGridScene.tsx (9.1k tokens) ├── tabs/ ├── LyricsTab.tsx (500 tokens) ├── NowPlayingTab.tsx (500 tokens) ├── QueueTab.tsx (1300 tokens) ├── types.ts (200 tokens) ├── useVibeMap.ts (900 tokens) ├── healthcheck.js (100 tokens) ├── hooks/ ├── useActivityPanel.ts (200 tokens) ├── useDoubleTap.ts (500 tokens) ├── useEventSource.ts (2.1k tokens) ├── useImageColor.ts (2.6k tokens) ├── useImportToasts.ts (200 tokens) ├── useKeyboardShortcuts.ts (1000 tokens) ├── useLyricsSync.ts (700 tokens) ├── useLyricsToggle.tsx (400 tokens) ├── useMediaInfo.ts (600 tokens) ├── useMediaQuery.ts (200 tokens) ├── useMediaSession.ts (1900 tokens) ├── useMetadataDisplay.ts (700 tokens) ├── useNotifications.ts (1200 tokens) ├── usePlaybackProgress.ts (300 tokens) ├── usePlayerMode.ts (300 tokens) ├── useQueries.ts (5.2k tokens) ├── useSleepTimer.ts (600 tokens) ├── useTVNavigation.ts (2.2k tokens) ├── useTrackFormat.ts (100 tokens) ├── useTrackPreview.ts (1400 tokens) ├── useVibeToggle.ts (300 tokens) ├── lib/ ├── activity-panel-settings-context.tsx (300 tokens) ├── api.ts (11.2k tokens) ├── audio-context.tsx (100 tokens) ├── audio-controller-context.tsx (100 tokens) ├── audio-controller.ts (3.7k tokens) ├── audio-controls-context.tsx (10.7k tokens) ├── audio-hooks.tsx (600 tokens) ├── audio-playback-context.tsx (1500 tokens) ├── audio-state-context.tsx (5.5k tokens) ├── auth-context.tsx (1000 tokens) ├── download-context.tsx (1300 tokens) ├── download-progress-context.tsx (500 tokens) ├── enrichmentApi.ts (1100 tokens) ├── features-context.tsx (400 tokens) ├── format.ts (100 tokens) ├── lyrics-utils.ts (200 tokens) ├── query-client.tsx (600 tokens) ├── query-events.ts (400 tokens) ├── search-result-store.ts (300 tokens) ├── toast-context.tsx (1000 tokens) ├── track-format.ts (800 tokens) ├── tv-utils.ts (400 tokens) ├── version.ts (100 tokens) ├── next.config.ts (900 tokens) ├── package-lock.json (79.5k tokens) ├── package.json (400 tokens) ├── playwright.config.ts (200 tokens) ├── postcss.config.mjs ├── public/ ├── assets/ ├── icons/ ├── icon-128.webp ├── icon-192.webp ├── icon-256.webp ├── icon-48.webp ├── icon-512.webp ├── icon-72.webp ├── icon-96.webp ├── images/ ├── SpotIcon.png ├── apple-touch-icon.png ├── favicon-192.png ├── kima.webp ├── fonts/ ├── montserrat-latin.woff2 ├── offline.html (300 tokens) ├── sw.js (1200 tokens) ├── tests/ ├── e2e/ ├── enrichment-cycle.spec.ts (1500 tokens) ├── fixtures/ ├── test-helpers.ts (1100 tokens) ├── full-ux-audit.spec.ts (6.9k tokens) ├── global.setup.ts (500 tokens) ├── import-url.spec.ts (700 tokens) ├── playlists.spec.ts (2.2k tokens) ├── predeploy/ ├── auth.spec.ts (400 tokens) ├── integrations.spec.ts (1000 tokens) ├── library.spec.ts (500 tokens) ├── playback.spec.ts (1200 tokens) ├── queue.spec.ts (1400 tokens) ├── security.spec.ts (2.9k tokens) ├── smoke.spec.ts (400 tokens) ├── vibe.spec.ts (2.4k tokens) ├── tsconfig.json (100 tokens) ├── utils/ ├── cn.ts ├── formatNumber.ts ├── formatTime.ts (400 tokens) ├── shuffle.ts (100 tokens) ├── vibeMatchScore.ts (400 tokens) ├── healthcheck-prod.js (100 tokens) ├── package-lock.json (omitted) ├── package.json ├── scripts/ ├── create-e2e-user.sh (500 tokens) ├── dev-setup.sh (200 tokens) ├── run-enrichment-memory-test.sh (900 tokens) ├── take-screenshots.js (2k tokens) ├── services/ ├── audio-analyzer-clap/ ├── Dockerfile (300 tokens) ├── analyzer.py (8.3k tokens) ├── requirements.txt (100 tokens) ├── audio-analyzer/ ├── Dockerfile (700 tokens) ├── analyzer.py (17.3k tokens) ├── requirements.txt ├── test_analyzer.py (500 tokens) ``` ## /.dockerignore ```dockerignore path="/.dockerignore" .git .worktrees .claude .serena .aider-desk .aider.tags.cache.v4 .roo .ruff_cache .vscode context_portal logs docs scripts *.md *.log **/node_modules **/.next .env* coverage *.test.ts __tests__ android ios ``` ## /.github/FUNDING.yml ```yml path="/.github/FUNDING.yml" github: Chevron7Locked ko_fi: Chevron7Locked #custom: ["https://example.com/donate"] ``` ## /.github/ISSUE_TEMPLATE/bug_report.yml ```yml path="/.github/ISSUE_TEMPLATE/bug_report.yml" name: Bug Report description: Report a bug or unexpected behavior title: "[Bug]: " labels: ["bug", "needs triage"] body: - type: markdown attributes: value: | Thanks for taking the time to report a bug. Please fill out the information below to help us diagnose and fix the issue. - type: textarea id: description attributes: label: Bug Description description: A clear and concise description of what the bug is. placeholder: Describe the bug... validations: required: true - type: textarea id: reproduction attributes: label: Steps to Reproduce description: Step-by-step instructions to reproduce the behavior. placeholder: | 1. Go to '...' 2. Click on '...' 3. Scroll down to '...' 4. See error validations: required: true - type: textarea id: expected attributes: label: Expected Behavior description: What did you expect to happen? placeholder: Describe what should have happened... validations: required: true - type: textarea id: actual attributes: label: Actual Behavior description: What actually happened? placeholder: Describe what actually happened... validations: required: true - type: input id: version attributes: label: Kima Version description: What version of Kima are you running? placeholder: "e.g., v1.0.0, nightly-2024-01-15, or commit hash" validations: required: true - type: dropdown id: deployment attributes: label: Deployment Method description: How are you running Kima? options: - Docker (docker-compose) - Docker (standalone) - Manual/Source - Other validations: required: true - type: textarea id: environment attributes: label: Environment Details description: Any relevant environment information (OS, browser, Docker version, etc.) placeholder: | - OS: Ubuntu 22.04 - Docker: 24.0.5 - Browser: Firefox 120 validations: required: false - type: textarea id: logs attributes: label: Relevant Logs description: Please copy and paste any relevant log output. This will be automatically formatted into code. render: shell validations: required: false - type: checkboxes id: checklist attributes: label: Checklist options: - label: I have searched existing issues to ensure this bug hasn't already been reported required: true - label: I am using a supported version of Kima required: true ``` ## /.github/ISSUE_TEMPLATE/config.yml ```yml path="/.github/ISSUE_TEMPLATE/config.yml" blank_issues_enabled: false contact_links: - name: Questions & Discussions url: https://github.com/Chevron7Locked/kima/discussions about: Ask questions and discuss Kima in GitHub Discussions ``` ## /.github/ISSUE_TEMPLATE/feature_request.yml ```yml path="/.github/ISSUE_TEMPLATE/feature_request.yml" name: Feature Request description: Suggest a new feature or enhancement title: "[Feature]: " labels: ["enhancement", "needs triage"] body: - type: markdown attributes: value: | Thanks for suggesting a feature! Please provide as much detail as possible. - type: textarea id: problem attributes: label: Problem or Use Case description: What problem does this feature solve? What are you trying to accomplish? placeholder: "I'm trying to... but currently..." validations: required: true - type: textarea id: solution attributes: label: Proposed Solution description: Describe the feature you'd like to see implemented. placeholder: Describe your ideal solution... validations: required: true - type: textarea id: alternatives attributes: label: Alternatives Considered description: Have you considered any alternative solutions or workarounds? placeholder: Describe alternatives you've considered... validations: required: false - type: dropdown id: scope attributes: label: Feature Scope description: How big of a change is this? options: - Small (UI tweak, minor enhancement) - Medium (new component, significant enhancement) - Large (new major feature, architectural change) validations: required: true - type: checkboxes id: contribution attributes: label: Contribution options: - label: I would be willing to help implement this feature required: false - type: checkboxes id: checklist attributes: label: Checklist options: - label: I have searched existing issues to ensure this hasn't already been requested required: true ``` ## /.github/PULL_REQUEST_TEMPLATE.md ## Description ## Type of Change - [ ] Bug fix (non-breaking change that fixes an issue) - [ ] New feature (non-breaking change that adds functionality) - [ ] Enhancement (improvement to existing functionality) - [ ] Documentation update - [ ] Code cleanup / refactoring - [ ] Other (please describe): ## Related Issues Fixes # ## Changes Made - - - ## Testing Done - [ ] Tested locally with Docker - [ ] Tested specific functionality: ## Screenshots (if applicable) ## Checklist - [ ] My code follows the project's code style - [ ] I have tested my changes locally - [ ] I have updated documentation if needed - [ ] My changes don't introduce new warnings - [ ] This PR targets the `main` branch ## /.github/workflows/docker-nightly.yml ```yml path="/.github/workflows/docker-nightly.yml" name: Nightly Build on: schedule: - cron: "0 4 * * *" # 4am UTC daily workflow_dispatch: concurrency: group: docker-nightly cancel-in-progress: true env: IMAGE_NAME: ${{ secrets.DOCKERHUB_USERNAME }}/kima jobs: build-nightly: name: Build & Push Nightly Image runs-on: ubuntu-latest steps: - name: Checkout code uses: actions/checkout@v4 - name: Free up disk space run: | sudo rm -rf /usr/share/dotnet sudo rm -rf /opt/ghc sudo rm -rf /usr/local/share/boost sudo rm -rf "$AGENT_TOOLSDIRECTORY" - name: Set up QEMU uses: docker/setup-qemu-action@v3 - name: Set up Docker Buildx uses: docker/setup-buildx-action@v3 - name: Login to Docker Hub uses: docker/login-action@v3 with: username: ${{ secrets.DOCKERHUB_USERNAME }} password: ${{ secrets.DOCKERHUB_TOKEN }} - name: Get short SHA id: sha run: echo "short=$(git rev-parse --short HEAD)" >> $GITHUB_OUTPUT - name: Build and push nightly uses: docker/build-push-action@v5 with: context: . file: ./Dockerfile push: true tags: | ${{ env.IMAGE_NAME }}:nightly ${{ env.IMAGE_NAME }}:nightly-${{ steps.sha.outputs.short }} labels: | org.opencontainers.image.revision=${{ github.sha }} org.opencontainers.image.version=nightly-${{ steps.sha.outputs.short }} cache-from: type=gha cache-to: type=gha,mode=max platforms: linux/amd64,linux/arm64 ``` ## /.github/workflows/docker-publish.yml ```yml path="/.github/workflows/docker-publish.yml" name: Build and Publish Docker Image on: push: tags: - "v*" workflow_dispatch: inputs: version: description: "Version tag (e.g., v1.0.0)" required: true type: string env: DOCKERHUB_IMAGE_NAME: ${{ secrets.DOCKERHUB_USERNAME }}/kima jobs: build: runs-on: ubuntu-latest permissions: contents: read packages: write steps: - name: Checkout uses: actions/checkout@v4 - name: Set GHCR image name run: | OWNER="${{ github.repository_owner }}" echo "GHCR_IMAGE_NAME=ghcr.io/${OWNER,,}/kima" >> $GITHUB_ENV - name: Free up disk space run: | sudo rm -rf /usr/share/dotnet sudo rm -rf /opt/ghc sudo rm -rf /usr/local/share/boost sudo rm -rf "$AGENT_TOOLSDIRECTORY" - name: Set up QEMU uses: docker/setup-qemu-action@v3 - name: Set up Docker Buildx uses: docker/setup-buildx-action@v3 - name: Login to DockerHub uses: docker/login-action@v3 with: username: ${{ secrets.DOCKERHUB_USERNAME }} password: ${{ secrets.DOCKERHUB_TOKEN }} - name: Login to GitHub Container Registry uses: docker/login-action@v3 with: registry: ghcr.io username: ${{ github.actor }} password: ${{ secrets.GITHUB_TOKEN }} - name: Extract version id: version run: | if [ "${{ github.event_name }}" = "workflow_dispatch" ]; then echo "version=${{ inputs.version }}" >> $GITHUB_OUTPUT else echo "version=${GITHUB_REF#refs/tags/}" >> $GITHUB_OUTPUT fi - name: Build and push uses: docker/build-push-action@v5 with: context: . file: ./Dockerfile push: true tags: | ${{ env.DOCKERHUB_IMAGE_NAME }}:${{ steps.version.outputs.version }} ${{ env.DOCKERHUB_IMAGE_NAME }}:latest ${{ env.GHCR_IMAGE_NAME }}:${{ steps.version.outputs.version }} ${{ env.GHCR_IMAGE_NAME }}:latest cache-from: type=gha cache-to: type=gha,mode=max platforms: linux/amd64,linux/arm64 create-release: needs: [build] runs-on: ubuntu-latest permissions: contents: write steps: - name: Checkout uses: actions/checkout@v4 - name: Extract version id: version run: | if [ "${{ github.event_name }}" = "workflow_dispatch" ]; then echo "version=${{ inputs.version }}" >> $GITHUB_OUTPUT else echo "version=${GITHUB_REF#refs/tags/}" >> $GITHUB_OUTPUT fi - name: Create Release uses: softprops/action-gh-release@v1 with: tag_name: ${{ steps.version.outputs.version }} name: Kima ${{ steps.version.outputs.version }} body: | ## Quick Start \`\`\`bash docker run -d \ --name kima \ -p 3030:3030 \ -v /path/to/your/music:/music \ -v kima_data:/data \ ${{ secrets.DOCKERHUB_USERNAME }}/kima:${{ steps.version.outputs.version }} \`\`\` Then open http://localhost:3030 and create your account! ## Documentation See the [README](https://github.com/${{ github.repository }}#readme) for full documentation. draft: false prerelease: false generate_release_notes: true ``` ## /.github/workflows/integration.yml ```yml path="/.github/workflows/integration.yml" name: Integration Tests on: pull_request: branches: [main] types: [labeled] workflow_dispatch: concurrency: group: integration-${{ github.ref }} cancel-in-progress: true jobs: e2e: name: E2E Tests if: github.event_name == 'workflow_dispatch' || github.event.label.name == 'run-e2e' runs-on: ubuntu-latest timeout-minutes: 60 steps: - uses: actions/checkout@v4 - name: Set up Docker Buildx uses: docker/setup-buildx-action@v3 - name: Build Docker image uses: docker/build-push-action@v5 with: context: . push: false load: true tags: kima:e2e cache-from: type=gha cache-to: type=gha,mode=max - name: Start Kima stack run: | docker run -d \ --name kima-e2e \ -p 3030:3030 \ -p 3006:3006 \ -v kima_e2e_data:/data \ kima:e2e echo "Waiting for health check..." timeout 90 bash -c 'until curl -sf http://localhost:3030/api/health; do sleep 3; done' - name: Create E2E test user run: | TEST_USER="kima_e2e" TEST_PASS="$(openssl rand -hex 20)" echo "::add-mask::${TEST_PASS}" echo "KIMA_TEST_USERNAME=${TEST_USER}" >> "$GITHUB_ENV" echo "KIMA_TEST_PASSWORD=${TEST_PASS}" >> "$GITHUB_ENV" KIMA_CONTAINER=kima-e2e \ KIMA_TEST_USERNAME="${TEST_USER}" \ KIMA_TEST_PASSWORD="${TEST_PASS}" \ bash scripts/create-e2e-user.sh - uses: actions/setup-node@v4 with: node-version: "22" cache: "npm" cache-dependency-path: frontend/package-lock.json - name: Install Playwright working-directory: frontend run: | npm ci npx playwright install --with-deps chromium - name: Run predeploy tests working-directory: frontend run: npm run test:predeploy env: KIMA_TEST_USERNAME: ${{ env.KIMA_TEST_USERNAME }} KIMA_TEST_PASSWORD: ${{ env.KIMA_TEST_PASSWORD }} KIMA_UI_BASE_URL: http://127.0.0.1:3030 - name: Run functional tests working-directory: frontend run: | npx playwright test \ tests/e2e/smoke.spec.ts \ tests/e2e/queue.spec.ts \ tests/e2e/playlists.spec.ts \ tests/e2e/security.spec.ts \ tests/e2e/vibe.spec.ts \ tests/e2e/full-ux-audit.spec.ts \ --reporter=list env: KIMA_TEST_USERNAME: ${{ env.KIMA_TEST_USERNAME }} KIMA_TEST_PASSWORD: ${{ env.KIMA_TEST_PASSWORD }} KIMA_UI_BASE_URL: http://127.0.0.1:3030 - name: Upload test results on failure if: failure() uses: actions/upload-artifact@v4 with: name: playwright-results-${{ github.run_id }} path: | frontend/test-results/ frontend/playwright-report/ retention-days: 7 - name: Stop and remove stack if: always() run: | docker stop kima-e2e || true docker rm kima-e2e || true docker volume rm kima_e2e_data || true ``` ## /.github/workflows/nightly.yml ```yml path="/.github/workflows/nightly.yml" name: Nightly Full Suite on: schedule: - cron: "0 3 * * *" workflow_dispatch: concurrency: group: nightly cancel-in-progress: true jobs: full-e2e: name: Full E2E Suite runs-on: ubuntu-latest timeout-minutes: 60 permissions: issues: write steps: - uses: actions/checkout@v4 - name: Set up Docker Buildx uses: docker/setup-buildx-action@v3 - name: Build Docker image uses: docker/build-push-action@v5 with: context: . push: false load: true tags: kima:nightly cache-from: type=gha cache-to: type=gha,mode=max - name: Start Kima stack run: | docker run -d \ --name kima-nightly \ -p 3030:3030 \ -p 3006:3006 \ -v kima_nightly_data:/data \ kima:nightly timeout 90 bash -c 'until curl -sf http://localhost:3030/api/health; do sleep 3; done' - name: Create test user run: | # Generate random credentials for this run -- no hardcoded passwords in source. TEST_USER="kima_e2e" TEST_PASS="$(openssl rand -hex 20)" echo "::add-mask::${TEST_PASS}" echo "KIMA_TEST_USERNAME=${TEST_USER}" >> "$GITHUB_ENV" echo "KIMA_TEST_PASSWORD=${TEST_PASS}" >> "$GITHUB_ENV" KIMA_CONTAINER=kima-nightly \ KIMA_TEST_USERNAME="${TEST_USER}" \ KIMA_TEST_PASSWORD="${TEST_PASS}" \ bash scripts/create-e2e-user.sh - uses: actions/setup-node@v4 with: node-version: "22" cache: "npm" cache-dependency-path: frontend/package-lock.json - name: Install Playwright working-directory: frontend run: | npm ci npx playwright install --with-deps chromium - name: Run full E2E suite working-directory: frontend run: npx playwright test --reporter=list env: KIMA_TEST_USERNAME: ${{ env.KIMA_TEST_USERNAME }} KIMA_TEST_PASSWORD: ${{ env.KIMA_TEST_PASSWORD }} KIMA_UI_BASE_URL: http://127.0.0.1:3030 - name: Upload results if: always() uses: actions/upload-artifact@v4 with: name: nightly-report-${{ github.run_id }} path: | frontend/test-results/ frontend/playwright-report/ retention-days: 14 - name: Open issue on failure if: failure() uses: actions/github-script@v7 with: script: | await github.rest.issues.create({ owner: context.repo.owner, repo: context.repo.repo, title: `Nightly suite failed -- ${new Date().toISOString().split('T')[0]}`, body: `The nightly E2E suite failed on ${context.sha}.\n\nRun: ${context.serverUrl}/${context.repo.owner}/${context.repo.repo}/actions/runs/${context.runId}`, labels: ['bug', 'ci'] }); - name: Stop stack if: always() run: | docker stop kima-nightly || true docker rm kima-nightly || true docker volume rm kima_nightly_data || true ``` ## /.github/workflows/pr-checks.yml ```yml path="/.github/workflows/pr-checks.yml" name: PR Checks on: pull_request: branches: [main] types: [opened, synchronize, reopened] jobs: lint-frontend: name: Lint Frontend runs-on: ubuntu-latest steps: - uses: actions/checkout@v4 - uses: actions/setup-node@v4 with: node-version: "22" cache: "npm" cache-dependency-path: frontend/package-lock.json - name: Install dependencies working-directory: frontend run: npm ci - name: Run ESLint working-directory: frontend run: npm run lint typecheck: name: TypeScript Typecheck runs-on: ubuntu-latest steps: - uses: actions/checkout@v4 - uses: actions/setup-node@v4 with: node-version: "22" cache: "npm" cache-dependency-path: frontend/package-lock.json - name: Typecheck frontend working-directory: frontend run: | npm ci npm run typecheck - uses: actions/setup-node@v4 with: node-version: "22" cache: "npm" cache-dependency-path: backend/package-lock.json - name: Typecheck backend working-directory: backend run: | npm ci npm run typecheck unit-tests: name: Backend Unit Tests runs-on: ubuntu-latest steps: - uses: actions/checkout@v4 - uses: actions/setup-node@v4 with: node-version: "22" cache: "npm" cache-dependency-path: backend/package-lock.json - name: Install dependencies working-directory: backend run: npm ci - name: Run Jest working-directory: backend # Exclude webhookEventStore -- it is an integration test requiring # a live PostgreSQL database. It runs in integration.yml instead. run: npm test -- --passWithNoTests --testPathIgnorePatterns="webhookEventStore" build-docker: name: Docker Build Check runs-on: ubuntu-latest needs: [lint-frontend, typecheck, unit-tests] steps: - uses: actions/checkout@v4 - name: Set up Docker Buildx uses: docker/setup-buildx-action@v3 - name: Build Docker image (no push) uses: docker/build-push-action@v5 with: context: . push: false tags: kima:pr-check cache-from: type=gha cache-to: type=gha,mode=max ``` ## /.github/workflows/security.yml ```yml path="/.github/workflows/security.yml" name: Security Checks on: pull_request: branches: [main] schedule: - cron: "0 2 * * 0" workflow_dispatch: jobs: dependency-audit: name: Dependency Audit runs-on: ubuntu-latest steps: - uses: actions/checkout@v4 - uses: actions/setup-node@v4 with: node-version: "22" - name: Audit frontend (critical only) working-directory: frontend run: | npm ci --ignore-scripts npm audit --audit-level=critical - name: Audit backend (critical only) working-directory: backend run: | npm ci --ignore-scripts npm audit --audit-level=critical security-e2e: name: Security E2E Tests runs-on: ubuntu-latest timeout-minutes: 20 steps: - uses: actions/checkout@v4 - name: Set up Docker Buildx uses: docker/setup-buildx-action@v3 - name: Build Docker image uses: docker/build-push-action@v5 with: context: . push: false load: true tags: kima:security cache-from: type=gha cache-to: type=gha,mode=max - name: Start Kima stack run: | docker run -d \ --name kima-security \ -p 3030:3030 \ -p 3006:3006 \ -v kima_security_data:/data \ kima:security timeout 90 bash -c 'until curl -sf http://localhost:3030/api/health; do sleep 3; done' - name: Create test user run: | TEST_USER="kima_e2e" TEST_PASS="$(openssl rand -hex 20)" echo "::add-mask::${TEST_PASS}" echo "KIMA_TEST_USERNAME=${TEST_USER}" >> "$GITHUB_ENV" echo "KIMA_TEST_PASSWORD=${TEST_PASS}" >> "$GITHUB_ENV" KIMA_CONTAINER=kima-security \ KIMA_TEST_USERNAME="${TEST_USER}" \ KIMA_TEST_PASSWORD="${TEST_PASS}" \ bash scripts/create-e2e-user.sh - uses: actions/setup-node@v4 with: node-version: "22" cache: "npm" cache-dependency-path: frontend/package-lock.json - name: Install Playwright working-directory: frontend run: | npm ci npx playwright install --with-deps chromium - name: Run security spec working-directory: frontend run: npx playwright test tests/e2e/security.spec.ts --reporter=list env: KIMA_TEST_USERNAME: ${{ env.KIMA_TEST_USERNAME }} KIMA_TEST_PASSWORD: ${{ env.KIMA_TEST_PASSWORD }} KIMA_UI_BASE_URL: http://127.0.0.1:3030 - name: Upload results on failure if: failure() uses: actions/upload-artifact@v4 with: name: security-test-results-${{ github.run_id }} path: frontend/test-results/ retention-days: 7 - name: Stop stack if: always() run: | docker stop kima-security || true docker rm kima-security || true docker volume rm kima_security_data || true ``` ## /.gitignore ```gitignore path="/.gitignore" # Environment & Secrets .env .env.* !.env.example *.local .roomodes # Dependencies **/node_modules/ **/__pycache__/ *.py[cod] *$py.class *.so .Python venv/ .venv/ **/.venv/ # Build Outputs frontend/.next/ frontend/out/ backend/dist/ **/dist/ **/build/ **/out/ .next # Logs logs/ *.log npm-debug.log* yarn-debug.log* pnpm-debug.log* backend/logs/ frontend/logs/ # Testing & Coverage coverage/ *.lcov .nyc_output **/playwright-report/ **/test-results/ # Temporary & Backup Files *.tmp *.temp *.bak *.old # Cache .cache .eslintcache .stylelintcache .rpt2_cache_*/ .ruff_cache/ # Docker docker-compose.override.yml docker-compose.local.yml **/volumes/ **/data/ # IDEs & Editors .vscode/ .idea/ *.iml *.sublime-workspace *.sublime-project *.swp *.swo *~ \#*\# .\#* *.code-workspace # OS Files .DS_Store Thumbs.db Desktop.ini # Runtime & Process pids/ *.pid *.seed *.pid.lock # Database *.sqlite *.sqlite3 *.db *.db-shm *.db-wal **/prisma/dev.db **/prisma/dev.db-journal # TypeScript *.tsbuildinfo # Package Manager .yarn/cache .yarn/unplugged .yarn/build-state.yml .yarn/install-state.gz .pnp.* pnpm-lock.yaml # Secrets & Keys *.keystore *.jks keystore.b64 **/key.txt *.conf lidify.keystore # Backend backend/cache/ **/cache/covers/ **/cache/transcodes/ **/mullvad/ # Frontend frontend/android/ frontend/test-*.tsx # Research/Scraping Cache **/.firecrawl/ # AI Tools & Assistants .claude/ **/.claude/ !.claude/commands/ .cursor/ **/.cursor/ .roo/ **/.roo/ .aider* .serena/ **/.serena/ .opencode/ **/.opencode/ .vibe/ **/.vibe/ .claudeignore CLAUDE.md AGENTS.md # Internal Documentation (public docs are in project root) docs/ **/docs/ context_portal/ issues/ plans/ planning/ systems/ # Dev test scripts /e2e/ # Release/Deployment Artifacts RELEASE_NOTES_*.md RELEASE_*_COMMANDS.sh DEPLOYMENT_COMMANDS_*.txt *_RELEASE_SUMMARY.md CODE_REVIEW_*.md # Local stress tests tests/stress/ # Development .worktrees/ reset-and-setup.sh organize-singles.sh COMMIT_MESSAGE.txt ISSUE_REVIEW.md backend/backend/ postman/ soularr/ # Legacy (removed from repo) /App.tsx /app.json /src/ # Allow README files !README.md !readme.md # Claude Code internal task tracking .task/ ``` ## /CHANGELOG.md # Changelog All notable changes to Kima will be documented in this file. The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/), and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html). ## [Unreleased] - nightly ## [1.7.11] - 2026-04-08 ### Fixed - **Docker build failure on linux/arm64 (v1.7.10 hotfix)**: The torch/torchaudio/torchvision pins added in v1.7.10 (PR #178) used the `+cpu` local version suffix, which exists on the pytorch CPU index for amd64 but not for arm64 at torch < 2.6.0. The arm64 build step 7/41 failed with `ERROR: Could not find a version that satisfies the requirement torch==2.5.1+cpu`. Dropped the `+cpu` suffix -- PEP 440 matches versions without a local tag against any local variant, so the same pin resolves to `2.5.1+cpu` on amd64 and `2.5.1` on arm64. - **CLAP model not loading (#165, properly this time)**: The v1.7.6 fix closed this issue but was actually dead code -- it edited `services/audio-analyzer-clap/requirements.txt`, but the main Dockerfile only copies `analyzer.py` from that directory and never installs from requirements.txt. CLAP was broken in every release from when the feature shipped until v1.7.10's pins landed (which would have fixed it if the arm64 build had not failed). Root cause: unpinned `torch torchaudio torchvision` let pip's resolver install mismatched versions (torch 2.5.1+cpu paired with torchaudio 2.11.0+cpu -- ABI-incompatible), and unpinned scipy/pandas were installed at latest versions needing numpy>=1.26, which tensorflow-cpu 2.13 then downgraded to 1.24.3, breaking scipy's `from numpy.exceptions import AxisError`. Fixed by the torch+cpu suffix correction above plus PR #178's (now-effective) numpy/scipy/pandas pins. Verified by reproducing the full CLAP + transformers + laion_clap + tensorflow + essentia import chain in the published v1.7.9 image and confirming the fix resolves all errors. ## [1.7.10] - 2026-04-07 ### Added - **Disc numbers and subtitles for multi-disc albums (#157, #170)**: The scanner now reads `disk.no` and `discsubtitle` tags from file metadata. Album views group tracks by disc with a header when multiple discs are present, and show compact `1-05` / `2-08` track labels for multi-disc releases. Single-disc albums are unchanged. Subsonic clients receive the `discNumber` attribute on songs and tracks are ordered by `[disc, trackNo]` across every code path (library, offline, share, and all Subsonic endpoints). A new additive migration adds two nullable columns (`Track.discNumber`, `Track.discSubtitle`) -- no rescan is required, but rescanning a library picks up the new fields. Thanks @loskutov. ### Fixed - **Deezer preview CORS/ORB in hardened browsers (#173, #178)**: Previews were failing in LibreWolf, hardened Firefox, and Brave because Deezer's CDN doesn't send cross-origin headers and strict browsers block the direct `