From c2a098794633d77bfcfc5f235f9a293dd56f37c3 Mon Sep 17 00:00:00 2001 From: Gabe Farrell <90876006+gabehf@users.noreply.github.com> Date: Tue, 13 Jan 2026 11:13:54 -0500 Subject: [PATCH 01/37] fix: improved mobile ui for rewind (#133) --- client/app/routes/RewindPage.tsx | 126 ++++++++++++++++--------------- 1 file changed, 64 insertions(+), 62 deletions(-) diff --git a/client/app/routes/RewindPage.tsx b/client/app/routes/RewindPage.tsx index 8417212..71a1ef6 100644 --- a/client/app/routes/RewindPage.tsx +++ b/client/app/routes/RewindPage.tsx @@ -128,74 +128,76 @@ export default function RewindPage() { transition: "1000", }} > -
+
{pgTitle} -
+
+
+
+
+ +

+ {months[month]} +

+ +
+
+ +

{year}

+ +
+
+
+ + setShowTime(!showTime)} + > +
+
{stats !== undefined && ( )} -
-
- -

- {months[month]} -

- -
-
- -

{year}

- -
-
-
- - setShowTime(!showTime)} - > -
From 288d04d714cefa67d647535cb5a17e0c76cdc82c Mon Sep 17 00:00:00 2001 From: Gabe Farrell <90876006+gabehf@users.noreply.github.com> Date: Tue, 13 Jan 2026 23:25:31 -0500 Subject: [PATCH 02/37] fix: ui tweaks and fixes (#134) --- client/app/components/AllTimeStats.tsx | 8 +++++--- client/app/components/LastPlays.tsx | 8 +++++--- client/app/components/TopAlbums.tsx | 8 +++++--- client/app/components/TopArtists.tsx | 10 +++++----- client/app/components/TopTracks.tsx | 8 +++++--- client/app/routes/MediaItems/Album.tsx | 8 ++++---- client/app/routes/MediaItems/Track.tsx | 17 +++++++++++------ 7 files changed, 40 insertions(+), 27 deletions(-) diff --git a/client/app/components/AllTimeStats.tsx b/client/app/components/AllTimeStats.tsx index 8f1bc40..556fa32 100644 --- a/client/app/components/AllTimeStats.tsx +++ b/client/app/components/AllTimeStats.tsx @@ -7,10 +7,12 @@ export default function AllTimeStats() { queryFn: ({ queryKey }) => getStats(queryKey[1]), }); + const header = "All time stats"; + if (isPending) { return (
-

All Time Stats

+

{header}

Loading...

); @@ -18,7 +20,7 @@ export default function AllTimeStats() { return ( <>
-

All Time Stats

+

{header}

Error: {error.message}

@@ -29,7 +31,7 @@ export default function AllTimeStats() { return (
-

All Time Stats

+

{header}

getNowPlaying(), }); + const header = "Last played"; + const [items, setItems] = useState(null); const handleDelete = async (listen: Listen) => { @@ -63,14 +65,14 @@ export default function LastPlays(props: Props) { if (isPending) { return (
-

Last Played

+

{header}

Loading...

); } else if (isError) { return (
-

Last Played

+

{header}

Error: {error.message}

); @@ -86,7 +88,7 @@ export default function LastPlays(props: Props) { return (

- Last Played + {header}

diff --git a/client/app/components/TopAlbums.tsx b/client/app/components/TopAlbums.tsx index 052e76a..d8a3b00 100644 --- a/client/app/components/TopAlbums.tsx +++ b/client/app/components/TopAlbums.tsx @@ -30,17 +30,19 @@ export default function TopAlbums(props: Props) { queryFn: ({ queryKey }) => getTopAlbums(queryKey[1] as getItemsArgs), }); + const header = "Top albums"; + if (isPending) { return (
-

Top Albums

+

{header}

Loading...

); } else if (isError) { return (
-

Top Albums

+

{header}

Error: {error.message}

); @@ -54,7 +56,7 @@ export default function TopAlbums(props: Props) { props.artistId ? `&artist_id=${props.artistId}` : "" }`} > - Top Albums + {header}
diff --git a/client/app/components/TopArtists.tsx b/client/app/components/TopArtists.tsx index c169448..a1db871 100644 --- a/client/app/components/TopArtists.tsx +++ b/client/app/components/TopArtists.tsx @@ -21,17 +21,19 @@ export default function TopArtists(props: Props) { queryFn: ({ queryKey }) => getTopArtists(queryKey[1] as getItemsArgs), }); + const header = "Top artists"; + if (isPending) { return (
-

Top Artists

+

{header}

Loading...

); } else if (isError) { return (
-

Top Artists

+

{header}

Error: {error.message}

); @@ -40,9 +42,7 @@ export default function TopArtists(props: Props) { return (

- - Top Artists - + {header}

diff --git a/client/app/components/TopTracks.tsx b/client/app/components/TopTracks.tsx index 85fef79..bfe31ca 100644 --- a/client/app/components/TopTracks.tsx +++ b/client/app/components/TopTracks.tsx @@ -28,17 +28,19 @@ const TopTracks = (props: Props) => { queryFn: ({ queryKey }) => getTopTracks(queryKey[1] as getItemsArgs), }); + const header = "Top tracks"; + if (isPending) { return (
-

Top Tracks

+

{header}

Loading...

); } else if (isError) { return (
-

Top Tracks

+

{header}

Error: {error.message}

); @@ -53,7 +55,7 @@ const TopTracks = (props: Props) => {

- Top Tracks + {header}

diff --git a/client/app/routes/MediaItems/Album.tsx b/client/app/routes/MediaItems/Album.tsx index b300422..afba6f7 100644 --- a/client/app/routes/MediaItems/Album.tsx +++ b/client/app/routes/MediaItems/Album.tsx @@ -50,17 +50,17 @@ export default function Album() { {album.listen_count} play{album.listen_count > 1 ? "s" : ""}

)} - { + {album.time_listened && (

{timeListenedString(album.time_listened)}

- } - { + )} + {album.first_listen && (

Listening since{" "} {new Date(album.first_listen * 1000).toLocaleDateString()}

- } + )}
} > diff --git a/client/app/routes/MediaItems/Track.tsx b/client/app/routes/MediaItems/Track.tsx index 2a45e2f..20258c1 100644 --- a/client/app/routes/MediaItems/Track.tsx +++ b/client/app/routes/MediaItems/Track.tsx @@ -49,23 +49,28 @@ export default function Track() { }} subContent={
- appears on {album.title} - {track.listen_count && ( +

+ Appears on{" "} + + {album.title} + +

+ {track.listen_count !== 0 && (

{track.listen_count} play{track.listen_count > 1 ? "s" : ""}

)} - { + {track.time_listened !== 0 && (

{timeListenedString(track.time_listened)}

- } - { + )} + {track.first_listen > 0 && (

Listening since{" "} {new Date(track.first_listen * 1000).toLocaleDateString()}

- } + )}
} > From df59605418a4f0e250e4f2c991e911620d107022 Mon Sep 17 00:00:00 2001 From: Gabe Farrell <90876006+gabehf@users.noreply.github.com> Date: Wed, 14 Jan 2026 00:08:05 -0500 Subject: [PATCH 03/37] feat: backfill duration from musicbrainz (#135) * feat: backfill durations from musicbrainz * chore: make request body dump info level --- db/queries/track.sql | 10 ++++ engine/engine.go | 59 ++++++++++++++----- engine/handlers/lbz_submit_listen.go | 2 +- internal/catalog/duration.go | 84 ++++++++++++++++++++++++++++ internal/db/db.go | 1 + internal/db/psql/track.go | 26 +++++++++ internal/repository/track.sql.go | 42 ++++++++++++++ 7 files changed, 208 insertions(+), 16 deletions(-) create mode 100644 internal/catalog/duration.go diff --git a/db/queries/track.sql b/db/queries/track.sql index af7006a..933fcc1 100644 --- a/db/queries/track.sql +++ b/db/queries/track.sql @@ -137,3 +137,13 @@ WHERE artist_id = $1 AND track_id = $2; -- name: DeleteTrack :exec DELETE FROM tracks WHERE id = $1; + +-- name: GetTracksWithNoDurationButHaveMbzID :many +SELECT + * +FROM tracks_with_title +WHERE duration = 0 + AND musicbrainz_id IS NOT NULL + AND id > $2 +ORDER BY id ASC +LIMIT $1; diff --git a/engine/engine.go b/engine/engine.go index b8e01b8..f259efb 100644 --- a/engine/engine.go +++ b/engine/engine.go @@ -2,6 +2,7 @@ package engine import ( "context" + "encoding/json" "fmt" "io" "net/http" @@ -105,6 +106,32 @@ func Run( l.Warn().Msg("Engine: MusicBrainz client disabled") } + if cfg.SubsonicEnabled() { + l.Debug().Msg("Engine: Checking Subsonic configuration") + pingURL := cfg.SubsonicUrl() + "/rest/ping.view?" + cfg.SubsonicParams() + "&f=json" + + resp, err := http.Get(pingURL) + if err != nil { + l.Fatal().Err(err).Msg("Engine: Failed to contact Subsonic server! Ensure the provided URL is correct") + } else { + defer resp.Body.Close() + + var result struct { + Response struct { + Status string `json:"status"` + } `json:"subsonic-response"` + } + + if err := json.NewDecoder(resp.Body).Decode(&result); err != nil { + l.Fatal().Err(err).Msg("Engine: Failed to parse Subsonic response") + } else if result.Response.Status != "ok" { + l.Fatal().Msg("Engine: Provided Subsonic credentials are invalid") + } else { + l.Info().Msg("Engine: Subsonic credentials validated successfully") + } + } + } + l.Debug().Msg("Engine: Initializing image sources") images.Initialize(images.ImageSourceOpts{ UserAgent: cfg.UserAgent(), @@ -201,6 +228,8 @@ func Run( l.Info().Msg("Engine: Pruning orphaned images") go catalog.PruneOrphanedImages(logger.NewContext(l), store) + l.Info().Msg("Engine: Running duration backfill task") + go catalog.BackfillTrackDurationsFromMusicBrainz(ctx, store, mbzC) l.Info().Msg("Engine: Initialization finished") quit := make(chan os.Signal, 1) @@ -221,19 +250,19 @@ func Run( } func RunImporter(l *zerolog.Logger, store db.DB, mbzc mbz.MusicBrainzCaller) { - l.Debug().Msg("Checking for import files...") + l.Debug().Msg("Importer: Checking for import files...") files, err := os.ReadDir(path.Join(cfg.ConfigDir(), "import")) if err != nil { - l.Err(err).Msg("Failed to read files from import dir") + l.Err(err).Msg("Importer: Failed to read files from import dir") } if len(files) > 0 { - l.Info().Msg("Files found in import directory. Attempting to import...") + l.Info().Msg("Importer: Files found in import directory. Attempting to import...") } else { return } defer func() { if r := recover(); r != nil { - l.Error().Interface("recover", r).Msg("Panic when importing files") + l.Error().Interface("recover", r).Msg("Importer: Panic when importing files") } }() for _, file := range files { @@ -241,37 +270,37 @@ func RunImporter(l *zerolog.Logger, store db.DB, mbzc mbz.MusicBrainzCaller) { continue } if strings.Contains(file.Name(), "Streaming_History_Audio") { - l.Info().Msgf("Import file %s detecting as being Spotify export", file.Name()) + l.Info().Msgf("Importer: Import file %s detecting as being Spotify export", file.Name()) err := importer.ImportSpotifyFile(logger.NewContext(l), store, file.Name()) if err != nil { - l.Err(err).Msgf("Failed to import file: %s", file.Name()) + l.Err(err).Msgf("Importer: Failed to import file: %s", file.Name()) } } else if strings.Contains(file.Name(), "maloja") { - l.Info().Msgf("Import file %s detecting as being Maloja export", file.Name()) + l.Info().Msgf("Importer: Import file %s detecting as being Maloja export", file.Name()) err := importer.ImportMalojaFile(logger.NewContext(l), store, file.Name()) if err != nil { - l.Err(err).Msgf("Failed to import file: %s", file.Name()) + l.Err(err).Msgf("Importer: Failed to import file: %s", file.Name()) } } else if strings.Contains(file.Name(), "recenttracks") { - l.Info().Msgf("Import file %s detecting as being ghan.nl LastFM export", file.Name()) + l.Info().Msgf("Importer: Import file %s detecting as being ghan.nl LastFM export", file.Name()) err := importer.ImportLastFMFile(logger.NewContext(l), store, mbzc, file.Name()) if err != nil { - l.Err(err).Msgf("Failed to import file: %s", file.Name()) + l.Err(err).Msgf("Importer: Failed to import file: %s", file.Name()) } } else if strings.Contains(file.Name(), "listenbrainz") { - l.Info().Msgf("Import file %s detecting as being ListenBrainz export", file.Name()) + l.Info().Msgf("Importer: Import file %s detecting as being ListenBrainz export", file.Name()) err := importer.ImportListenBrainzExport(logger.NewContext(l), store, mbzc, file.Name()) if err != nil { - l.Err(err).Msgf("Failed to import file: %s", file.Name()) + l.Err(err).Msgf("Importer: Failed to import file: %s", file.Name()) } } else if strings.Contains(file.Name(), "koito") { - l.Info().Msgf("Import file %s detecting as being Koito export", file.Name()) + l.Info().Msgf("Importer: Import file %s detecting as being Koito export", file.Name()) err := importer.ImportKoitoFile(logger.NewContext(l), store, file.Name()) if err != nil { - l.Err(err).Msgf("Failed to import file: %s", file.Name()) + l.Err(err).Msgf("Importer: Failed to import file: %s", file.Name()) } } else { - l.Warn().Msgf("File %s not recognized as a valid import file; make sure it is valid and named correctly", file.Name()) + l.Warn().Msgf("Importer: File %s not recognized as a valid import file; make sure it is valid and named correctly", file.Name()) } } } diff --git a/engine/handlers/lbz_submit_listen.go b/engine/handlers/lbz_submit_listen.go index e92eb48..91eeaac 100644 --- a/engine/handlers/lbz_submit_listen.go +++ b/engine/handlers/lbz_submit_listen.go @@ -103,7 +103,7 @@ func LbzSubmitListenHandler(store db.DB, mbzc mbz.MusicBrainzCaller) func(w http return } - l.Debug().Any("request_body", req).Msg("LbzSubmitListenHandler: Parsed request body") + l.Info().Any("request_body", req).Msg("LbzSubmitListenHandler: Parsed request body") if len(req.Payload) < 1 { l.Debug().Msg("LbzSubmitListenHandler: Payload is empty") diff --git a/internal/catalog/duration.go b/internal/catalog/duration.go new file mode 100644 index 0000000..808ebd0 --- /dev/null +++ b/internal/catalog/duration.go @@ -0,0 +1,84 @@ +package catalog + +import ( + "context" + "fmt" + + "github.com/gabehf/koito/internal/db" + "github.com/gabehf/koito/internal/logger" + "github.com/gabehf/koito/internal/mbz" + "github.com/google/uuid" +) + +func BackfillTrackDurationsFromMusicBrainz( + ctx context.Context, + store db.DB, + mbzCaller mbz.MusicBrainzCaller, +) error { + l := logger.FromContext(ctx) + l.Info().Msg("BackfillTrackDurationsFromMusicBrainz: Starting backfill of track durations from MusicBrainz") + + var from int32 = 0 + + for { + tracks, err := store.GetTracksWithNoDurationButHaveMbzID(ctx, from) + if err != nil { + return fmt.Errorf("BackfillTrackDurationsFromMusicBrainz: failed to fetch tracks for duration backfill: %w", err) + } + + // nil, nil means no more results + if len(tracks) == 0 { + if from == 0 { + l.Info().Msg("BackfillTrackDurationsFromMusicBrainz: No tracks need updating. Skipping backfill...") + } else { + l.Info().Msg("BackfillTrackDurationsFromMusicBrainz: Backfill complete") + } + return nil + } + + for _, track := range tracks { + from = track.ID + + if track.MbzID == nil || *track.MbzID == uuid.Nil { + continue + } + + l.Debug(). + Str("title", track.Title). + Str("mbz_id", track.MbzID.String()). + Msg("BackfillTrackDurationsFromMusicBrainz: Backfilling duration from MusicBrainz") + + mbzTrack, err := mbzCaller.GetTrack(ctx, *track.MbzID) + if err != nil { + l.Err(err). + Str("title", track.Title). + Msg("BackfillTrackDurationsFromMusicBrainz: Failed to fetch track from MusicBrainz") + continue + } + + if mbzTrack.LengthMs <= 0 { + l.Debug(). + Str("title", track.Title). + Msg("BackfillTrackDurationsFromMusicBrainz: MusicBrainz track has no duration") + continue + } + + durationSeconds := int32(mbzTrack.LengthMs / 1000) + + err = store.UpdateTrack(ctx, db.UpdateTrackOpts{ + ID: track.ID, + Duration: durationSeconds, + }) + if err != nil { + l.Err(err). + Str("title", track.Title). + Msg("BackfillTrackDurationsFromMusicBrainz: Failed to update track duration") + } else { + l.Info(). + Str("title", track.Title). + Int32("duration_seconds", durationSeconds). + Msg("BackfillTrackDurationsFromMusicBrainz: Track duration backfilled successfully") + } + } + } +} diff --git a/internal/db/db.go b/internal/db/db.go index e725bc8..4695967 100644 --- a/internal/db/db.go +++ b/internal/db/db.go @@ -16,6 +16,7 @@ type DB interface { GetAlbum(ctx context.Context, opts GetAlbumOpts) (*models.Album, error) GetAlbumWithNoMbzIDByTitles(ctx context.Context, artistId int32, titles []string) (*models.Album, error) GetTrack(ctx context.Context, opts GetTrackOpts) (*models.Track, error) + GetTracksWithNoDurationButHaveMbzID(ctx context.Context, from int32) ([]*models.Track, error) GetArtistsForAlbum(ctx context.Context, id int32) ([]*models.Artist, error) GetArtistsForTrack(ctx context.Context, id int32) ([]*models.Artist, error) GetTopTracksPaginated(ctx context.Context, opts GetItemsOpts) (*PaginatedResponse[*models.Track], error) diff --git a/internal/db/psql/track.go b/internal/db/psql/track.go index 6634397..f20263a 100644 --- a/internal/db/psql/track.go +++ b/internal/db/psql/track.go @@ -375,3 +375,29 @@ func (d *Psql) SetPrimaryTrackArtist(ctx context.Context, id int32, artistId int } return tx.Commit(ctx) } + +// returns nil, nil when no results +func (d *Psql) GetTracksWithNoDurationButHaveMbzID(ctx context.Context, from int32) ([]*models.Track, error) { + results, err := d.q.GetTracksWithNoDurationButHaveMbzID(ctx, repository.GetTracksWithNoDurationButHaveMbzIDParams{ + Limit: 20, + ID: 0, + }) + if errors.Is(err, pgx.ErrNoRows) { + return nil, nil + } else if err != nil { + return nil, fmt.Errorf("GetTracksWithNoDurationButHaveMbzID: %w", err) + } + + ret := make([]*models.Track, 0) + + for _, v := range results { + ret = append(ret, &models.Track{ + ID: v.ID, + Duration: v.Duration, + MbzID: v.MusicBrainzID, + Title: v.Title, + }) + } + + return ret, nil +} diff --git a/internal/repository/track.sql.go b/internal/repository/track.sql.go index 883e13c..6b11b01 100644 --- a/internal/repository/track.sql.go +++ b/internal/repository/track.sql.go @@ -447,6 +447,48 @@ func (q *Queries) GetTrackByTrackInfo(ctx context.Context, arg GetTrackByTrackIn return i, err } +const getTracksWithNoDurationButHaveMbzID = `-- name: GetTracksWithNoDurationButHaveMbzID :many +SELECT + id, musicbrainz_id, duration, release_id, title +FROM tracks_with_title +WHERE duration = 0 + AND musicbrainz_id IS NOT NULL + AND id > $2 +ORDER BY id ASC +LIMIT $1 +` + +type GetTracksWithNoDurationButHaveMbzIDParams struct { + Limit int32 + ID int32 +} + +func (q *Queries) GetTracksWithNoDurationButHaveMbzID(ctx context.Context, arg GetTracksWithNoDurationButHaveMbzIDParams) ([]TracksWithTitle, error) { + rows, err := q.db.Query(ctx, getTracksWithNoDurationButHaveMbzID, arg.Limit, arg.ID) + if err != nil { + return nil, err + } + defer rows.Close() + var items []TracksWithTitle + for rows.Next() { + var i TracksWithTitle + if err := rows.Scan( + &i.ID, + &i.MusicBrainzID, + &i.Duration, + &i.ReleaseID, + &i.Title, + ); err != nil { + return nil, err + } + items = append(items, i) + } + if err := rows.Err(); err != nil { + return nil, err + } + return items, nil +} + const insertTrack = `-- name: InsertTrack :one INSERT INTO tracks (musicbrainz_id, release_id, duration) VALUES ($1, $2, $3) From 25d7bb41c1c3d44cbd7009a776f693cb687c2127 Mon Sep 17 00:00:00 2001 From: Gabe Farrell <90876006+gabehf@users.noreply.github.com> Date: Wed, 14 Jan 2026 00:24:19 -0500 Subject: [PATCH 04/37] Revise README for project status and update screenshots Updated project status to reflect active development and instability. Added new images to the screenshots section and made minor text adjustments. Also since when does AI write GitHub default commit messages... --- README.md | 10 +++++----- 1 file changed, 5 insertions(+), 5 deletions(-) diff --git a/README.md b/README.md index 2bc10ce..f657f5f 100644 --- a/README.md +++ b/README.md @@ -3,7 +3,7 @@ Koito is a modern, themeable ListenBrainz-compatible scrobbler for self-hosters who want control over their data and insights into their listening habits. It supports relaying to other compatible scrobblers, so you can try it safely without replacing your current setup. -> This project is currently pre-release, and therefore you can expect rapid development and some bugs. If you don't want to replace your current scrobbler +> This project is under active development and still considered "unstable", and therefore you can expect some bugs. If you don't want to replace your current scrobbler with Koito quite yet, you can [set up a relay](https://koito.io/guides/scrobbler/#set-up-a-relay) from Koito to another ListenBrainz-compatible scrobbler. This is what I've been doing for the entire development of this app and it hasn't failed me once. Or, you can always use something like [multi-scrobbler](https://github.com/FoxxMD/multi-scrobbler). @@ -23,8 +23,9 @@ You can view my public instance with my listening data at https://koito.mnrva.de ## Screenshots ![screenshot one](assets/screenshot1.png) -![screenshot two](assets/screenshot2.png) -![screenshot three](assets/screenshot3.png) +image +image + ## Installation @@ -84,5 +85,4 @@ Not just during development, you can see my complete listening data on my [live #### Random notes - I find it a little annoying when READMEs use emoji but everyone else is doing it so I felt like I had to... -- It's funny how you can see the days in my listening history when I was just working on this project because they have way more listens than other days. -- About 50% of the reason I built this was minor/not-so-minor greivances with Maloja. Could I have just contributed to Maloja? Maybe, but I like building stuff and I like Koito's UI a lot more anyways. \ No newline at end of file +- About 50% of the reason I built this was minor/not-so-minor greivances with Maloja. Could I have just contributed to Maloja? Maybe, but I like building stuff and I like Koito's UI a lot more anyways. From feef66da122a34dd2cbf6da0c1c18a1234d18513 Mon Sep 17 00:00:00 2001 From: Gabe Farrell Date: Wed, 14 Jan 2026 01:09:17 -0500 Subject: [PATCH 05/37] fix: add required parameters for subsonic request --- engine/engine.go | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/engine/engine.go b/engine/engine.go index f259efb..31fe552 100644 --- a/engine/engine.go +++ b/engine/engine.go @@ -108,7 +108,7 @@ func Run( if cfg.SubsonicEnabled() { l.Debug().Msg("Engine: Checking Subsonic configuration") - pingURL := cfg.SubsonicUrl() + "/rest/ping.view?" + cfg.SubsonicParams() + "&f=json" + pingURL := cfg.SubsonicUrl() + "/rest/ping.view?" + cfg.SubsonicParams() + "&f=json&v=1&c=koito" resp, err := http.Get(pingURL) if err != nil { From 231e751be30157741ca1cb259944bc510e8b17b8 Mon Sep 17 00:00:00 2001 From: Gabe Farrell Date: Wed, 14 Jan 2026 01:26:01 -0500 Subject: [PATCH 06/37] docs: add navidrome quickstart guide --- docs/astro.config.mjs | 98 ++++++++++-------- docs/src/assets/navidrome_lbz_switch.png | Bin 0 -> 182662 bytes docs/src/content/docs/quickstart/navidrome.md | 68 ++++++++++++ 3 files changed, 123 insertions(+), 43 deletions(-) create mode 100644 docs/src/assets/navidrome_lbz_switch.png create mode 100644 docs/src/content/docs/quickstart/navidrome.md diff --git a/docs/astro.config.mjs b/docs/astro.config.mjs index 845acb4..7875016 100644 --- a/docs/astro.config.mjs +++ b/docs/astro.config.mjs @@ -1,57 +1,69 @@ // @ts-check -import { defineConfig } from 'astro/config'; -import starlight from '@astrojs/starlight'; +import { defineConfig } from "astro/config"; +import starlight from "@astrojs/starlight"; -import tailwindcss from '@tailwindcss/vite'; +import tailwindcss from "@tailwindcss/vite"; // https://astro.build/config export default defineConfig({ integrations: [ - starlight({ - head: [ - { - tag: 'script', - attrs: { - src: 'https://static.cloudflareinsights.com/beacon.min.js', - 'data-cf-beacon': '{"token": "1948caaaba10463fa1d310ee02b0951c"}', - defer: true, - } - } - ], - title: 'Koito', - logo: { - src: './src/assets/logo_text.png', - replacesTitle: true, + starlight({ + head: [ + { + tag: "script", + attrs: { + src: "https://static.cloudflareinsights.com/beacon.min.js", + "data-cf-beacon": '{"token": "1948caaaba10463fa1d310ee02b0951c"}', + defer: true, }, - social: [{ icon: 'github', label: 'GitHub', href: 'https://github.com/gabehf/koito' }], - sidebar: [ - { - label: 'Guides', - items: [ - // Each item here is one entry in the navigation menu. - { label: 'Installation', slug: 'guides/installation' }, - { label: 'Importing Data', slug: 'guides/importing' }, - { label: 'Setting up the Scrobbler', slug: 'guides/scrobbler' }, - { label: 'Editing Data', slug: 'guides/editing' }, - ], - }, - { - label: 'Reference', - items: [ - { label: 'Configuration Options', slug: 'reference/configuration' }, - ] - }, + }, + ], + title: "Koito", + logo: { + src: "./src/assets/logo_text.png", + replacesTitle: true, + }, + social: [ + { + icon: "github", + label: "GitHub", + href: "https://github.com/gabehf/koito", + }, + ], + sidebar: [ + { + label: "Guides", + items: [ + // Each item here is one entry in the navigation menu. + { label: "Installation", slug: "guides/installation" }, + { label: "Importing Data", slug: "guides/importing" }, + { label: "Setting up the Scrobbler", slug: "guides/scrobbler" }, + { label: "Editing Data", slug: "guides/editing" }, ], - customCss: [ - // Path to your Tailwind base styles: - './src/styles/global.css', - ], - }), - ], + }, + { + label: "Quickstart", + items: [ + { label: "Setup with Navidrome", slug: "quickstart/navidrome" }, + ], + }, + { + label: "Reference", + items: [ + { label: "Configuration Options", slug: "reference/configuration" }, + ], + }, + ], + customCss: [ + // Path to your Tailwind base styles: + "./src/styles/global.css", + ], + }), + ], site: "https://koito.io", vite: { plugins: [tailwindcss()], }, -}); \ No newline at end of file +}); diff --git a/docs/src/assets/navidrome_lbz_switch.png b/docs/src/assets/navidrome_lbz_switch.png new file mode 100644 index 0000000000000000000000000000000000000000..a8b44be848e3a3c4110126b465902368e5649916 GIT binary patch literal 182662 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Ν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:5432/koitodb + - KOITO_ALLOWED_HOSTS=koito.mydomain.com,192.168.1.100 + - KOITO_SUBSONIC_URL=https://navidrome.mydomain.com # the url to your navidrome instance + - KOITO_SUBSONIC_PARAMS=u=&t=&s= + - KOITO_DEFAULT_THEME=black # i like this theme, use whatever you want + ports: + - "4110:4110" + volumes: + - ./koito-data:/etc/koito + restart: unless-stopped + + db: + user: 1000:1000 + image: postgres:16 + container_name: psql + restart: unless-stopped + environment: + POSTGRES_DB: koitodb + POSTGRES_USER: postgres + POSTGRES_PASSWORD: + volumes: + - ./db-data:/var/lib/postgresql/data +``` + +### How do I get the Subsonic params? +The easiest way to get your Subsonic parameters to open your browser and sign into Navidrome, then press F12 to get to +the developer options and navigate to the **Network** tab. Find a `getCoverArt` request (there should be a lot on the home +page) and look for the part of the URL that looks like `u=&t=&s=`. This +is what you need to copy and provide to Koito. +:::note +If you don't want to use Navidrome to provide images to Koito, you can skip the `KOITO_SUBSONIC_URL` and `KOITO_SUBSONIC_PARAMS` +variables entirely. +::: + +## Configure Navidrome +You have to provide Navidrome with the environment variables `ND_LISTENBRAINZ_ENABLED=true` and +`ND_LISTENBRAINZ_BASEURL=/apis/listenbrainz/1`. The place where you edit these environment variables will change +depending on how you have chosen to deploy Navidrome. + +## Enable ListenBrainz in Navidrome +In Navidome, click on **Settings** in the top right, then click **Personal**. + +Here, you will see that **Scrobble to ListenBrainz** is turned off. Flip that switch on. +![navidrome listenbrainz switch screenshot](../../../assets/navidrome_lbz_switch.png) + +When you flip it on, Navidrome will prompt you for a ListenBrainz token. To get this token, open your Koito page and sign in. +Press the settings button (or hit `\`) and go to the **API Keys** tab. Copy the autogenerated API key by either clicking the +copy button, or clicking on the key itself and copying with ctrl+c. + +After hitting **Save** in Navidrome, your listen activity will start being sent to Koito as you listen to tracks. + +Happy scrobbling! From 8223a29be68ed7a4cb45cecbbb28e61cba8e4e27 Mon Sep 17 00:00:00 2001 From: Gabe Farrell <90876006+gabehf@users.noreply.github.com> Date: Wed, 14 Jan 2026 12:46:17 -0500 Subject: [PATCH 07/37] fix: correctly cycle tracks in backfill (#138) --- internal/catalog/duration.go | 1 + internal/catalog/duration_test.go | 36 +++++++++++++++++++++++++++++++ internal/db/psql/track.go | 2 +- 3 files changed, 38 insertions(+), 1 deletion(-) create mode 100644 internal/catalog/duration_test.go diff --git a/internal/catalog/duration.go b/internal/catalog/duration.go index 808ebd0..6217dd6 100644 --- a/internal/catalog/duration.go +++ b/internal/catalog/duration.go @@ -21,6 +21,7 @@ func BackfillTrackDurationsFromMusicBrainz( var from int32 = 0 for { + l.Debug().Int32("ID", from).Msg("Fetching tracks to backfill from ID") tracks, err := store.GetTracksWithNoDurationButHaveMbzID(ctx, from) if err != nil { return fmt.Errorf("BackfillTrackDurationsFromMusicBrainz: failed to fetch tracks for duration backfill: %w", err) diff --git a/internal/catalog/duration_test.go b/internal/catalog/duration_test.go new file mode 100644 index 0000000..911e345 --- /dev/null +++ b/internal/catalog/duration_test.go @@ -0,0 +1,36 @@ +package catalog_test + +import ( + "context" + "testing" + + "github.com/gabehf/koito/internal/catalog" + "github.com/gabehf/koito/internal/mbz" + "github.com/stretchr/testify/assert" + "github.com/stretchr/testify/require" +) + +func TestBackfillDuration(t *testing.T) { + setupTestDataWithMbzIDs(t) + + ctx := context.Background() + mbzc := &mbz.MbzMockCaller{ + Artists: mbzArtistData, + Releases: mbzReleaseData, + Tracks: mbzTrackData, + } + + var err error + + err = catalog.BackfillTrackDurationsFromMusicBrainz(context.Background(), store, &mbz.MbzErrorCaller{}) + assert.NoError(t, err) + + err = catalog.BackfillTrackDurationsFromMusicBrainz(ctx, store, mbzc) + assert.NoError(t, err) + + count, err := store.Count(ctx, ` + SELECT COUNT(*) FROM tracks_with_title WHERE title = $1 AND duration > 0 + `, "Tokyo Calling") + require.NoError(t, err) + assert.Equal(t, 1, count, "track was not updated with duration") +} diff --git a/internal/db/psql/track.go b/internal/db/psql/track.go index f20263a..d511de6 100644 --- a/internal/db/psql/track.go +++ b/internal/db/psql/track.go @@ -380,7 +380,7 @@ func (d *Psql) SetPrimaryTrackArtist(ctx context.Context, id int32, artistId int func (d *Psql) GetTracksWithNoDurationButHaveMbzID(ctx context.Context, from int32) ([]*models.Track, error) { results, err := d.q.GetTracksWithNoDurationButHaveMbzID(ctx, repository.GetTracksWithNoDurationButHaveMbzIDParams{ Limit: 20, - ID: 0, + ID: from, }) if errors.Is(err, pgx.ErrNoRows) { return nil, nil From a94584da23a130b99c299380e22213202158643e Mon Sep 17 00:00:00 2001 From: Gabe Farrell <90876006+gabehf@users.noreply.github.com> Date: Wed, 14 Jan 2026 14:06:14 -0500 Subject: [PATCH 08/37] create FUNDING.yml --- .github/FUNDING.yml | 3 +++ 1 file changed, 3 insertions(+) create mode 100644 .github/FUNDING.yml diff --git a/.github/FUNDING.yml b/.github/FUNDING.yml new file mode 100644 index 0000000..fbf205d --- /dev/null +++ b/.github/FUNDING.yml @@ -0,0 +1,3 @@ +# These are supported funding model platforms + +ko_fi: gabehf From 20bbf62254184355addc652ac24f4314c981b8d6 Mon Sep 17 00:00:00 2001 From: Gabe Farrell <90876006+gabehf@users.noreply.github.com> Date: Wed, 14 Jan 2026 14:47:21 -0500 Subject: [PATCH 09/37] update README Added logo and Ko-Fi badge to README. --- README.md | 12 +++++++++++- 1 file changed, 11 insertions(+), 1 deletion(-) diff --git a/README.md b/README.md index f657f5f..7c34208 100644 --- a/README.md +++ b/README.md @@ -1,4 +1,14 @@ -# Koito +
+ +![Koito logo](https://github.com/user-attachments/assets/bd69a050-b40f-4da7-8ff1-4607554bfd6d) + +
+ +
+ + [![Ko-Fi](https://img.shields.io/badge/Ko--fi-F16061?style=for-the-badge&logo=ko-fi&logoColor=white)](https://ko-fi.com/gabehf) + +
Koito is a modern, themeable ListenBrainz-compatible scrobbler for self-hosters who want control over their data and insights into their listening habits. It supports relaying to other compatible scrobblers, so you can try it safely without replacing your current setup. From 3305ad269e614f85221c25c47b197857eead0387 Mon Sep 17 00:00:00 2001 From: Gabe Farrell <90876006+gabehf@users.noreply.github.com> Date: Wed, 14 Jan 2026 17:21:52 -0500 Subject: [PATCH 10/37] Add Star History section to README Added Star History section with visualization. --- README.md | 10 ++++++++++ 1 file changed, 10 insertions(+) diff --git a/README.md b/README.md index 7c34208..6c24726 100644 --- a/README.md +++ b/README.md @@ -86,6 +86,16 @@ There are currently some known issues that I am actively working on, in addition If you have any feature ideas, open a GitHub issue to let me know. I'm sorting through ideas to decide which data visualizations and customization options to add next. +## Star History + + + + + + Star History Chart + + + ## Albums that fueled development + notes More relevant here than any of my other projects... From d87ed2eb978e70a9d12458b3694c57ce7b569797 Mon Sep 17 00:00:00 2001 From: Gabe Farrell <90876006+gabehf@users.noreply.github.com> Date: Wed, 14 Jan 2026 21:35:01 -0500 Subject: [PATCH 11/37] fix: ensure listen activity correctly sums listen activity in step (#139) * remove impossible nil check * fix listen activity not correctly aggregating step * remove stray log * fix test --- engine/handlers/get_listen_activity.go | 41 ++++++++++++++++++------ internal/catalog/associate_track.go | 3 -- internal/db/period.go | 4 ++- internal/db/psql/listen_activity_test.go | 19 ++++++----- 4 files changed, 43 insertions(+), 24 deletions(-) diff --git a/engine/handlers/get_listen_activity.go b/engine/handlers/get_listen_activity.go index 22d23fa..c11ed3e 100644 --- a/engine/handlers/get_listen_activity.go +++ b/engine/handlers/get_listen_activity.go @@ -106,7 +106,7 @@ func GetListenActivityHandler(store db.DB) func(w http.ResponseWriter, r *http.R return } - activity = fillMissingActivity(activity, opts) + activity = processActivity(activity, opts) l.Debug().Msg("GetListenActivityHandler: Successfully retrieved listen activity") utils.WriteJSON(w, http.StatusOK, activity) @@ -114,34 +114,55 @@ func GetListenActivityHandler(store db.DB) func(w http.ResponseWriter, r *http.R } // ngl i hate this -func fillMissingActivity( +func processActivity( items []db.ListenActivityItem, opts db.ListenActivityOpts, ) []db.ListenActivityItem { from, to := db.ListenActivityOptsToTimes(opts) - existing := make(map[string]int64, len(items)) + buckets := make(map[string]int64) + for _, item := range items { - existing[item.Start.Format("2006-01-02")] = item.Listens + bucketStart := normalizeToStep(item.Start, opts.Step) + key := bucketStart.Format("2006-01-02") + buckets[key] += item.Listens } var result []db.ListenActivityItem - for t := from; t.Before(to); t = addStep(t, opts.Step) { - listens := int64(0) - if v, ok := existing[t.Format("2006-01-02")]; ok { - listens = v - } + for t := normalizeToStep(from, opts.Step); t.Before(to); t = addStep(t, opts.Step) { + key := t.Format("2006-01-02") result = append(result, db.ListenActivityItem{ Start: t, - Listens: int64(listens), + Listens: buckets[key], }) } return result } +func normalizeToStep(t time.Time, step db.StepInterval) time.Time { + switch step { + case db.StepDay: + return time.Date(t.Year(), t.Month(), t.Day(), 0, 0, 0, 0, t.Location()) + + case db.StepWeek: + weekday := int(t.Weekday()) + if weekday == 0 { + weekday = 7 + } + start := t.AddDate(0, 0, -(weekday - 1)) + return time.Date(start.Year(), start.Month(), start.Day(), 0, 0, 0, 0, t.Location()) + + case db.StepMonth: + return time.Date(t.Year(), t.Month(), 1, 0, 0, 0, 0, t.Location()) + + default: + return t + } +} + func addStep(t time.Time, step db.StepInterval) time.Time { switch step { case db.StepDay: diff --git a/internal/catalog/associate_track.go b/internal/catalog/associate_track.go index bb8ebc7..3fa1fbc 100644 --- a/internal/catalog/associate_track.go +++ b/internal/catalog/associate_track.go @@ -74,9 +74,6 @@ func matchTrackByMbzID(ctx context.Context, d db.DB, opts AssociateTrackOpts) (* } else { l.Warn().Msgf("Attempted to update track %s with MusicBrainz ID, but an existing ID was already found", track.Title) } - if err != nil { - return nil, fmt.Errorf("matchTrackByMbzID: %w", err) - } track.MbzID = &opts.TrackMbzID return track, nil } diff --git a/internal/db/period.go b/internal/db/period.go index d28f59a..f13d321 100644 --- a/internal/db/period.go +++ b/internal/db/period.go @@ -91,7 +91,9 @@ func ListenActivityOptsToTimes(opts ListenActivityOpts) (start, end time.Time) { // Align to most recent Sunday weekday := int(now.Weekday()) // Sunday = 0 startOfThisWeek := time.Date(now.Year(), now.Month(), now.Day()-weekday, 0, 0, 0, 0, loc) - start = startOfThisWeek.AddDate(0, 0, -7*opts.Range) + // need to subtract 1 from range for week because we are going back from the beginning of this + // week, so we sort of already went back a week + start = startOfThisWeek.AddDate(0, 0, -7*(opts.Range-1)) end = startOfThisWeek.AddDate(0, 0, 7).Add(-time.Nanosecond) case StepMonth: diff --git a/internal/db/psql/listen_activity_test.go b/internal/db/psql/listen_activity_test.go index 9b277ff..b2da07f 100644 --- a/internal/db/psql/listen_activity_test.go +++ b/internal/db/psql/listen_activity_test.go @@ -97,20 +97,19 @@ func TestListenActivity(t *testing.T) { err = store.Exec(context.Background(), `INSERT INTO listens (user_id, track_id, listened_at) - VALUES (1, 1, NOW() - INTERVAL '1 month'), - (1, 1, NOW() - INTERVAL '2 months'), - (1, 1, NOW() - INTERVAL '3 months'), - (1, 2, NOW() - INTERVAL '1 month'), - (1, 2, NOW() - INTERVAL '2 months')`) + VALUES (1, 1, NOW() - INTERVAL '1 month 1 day'), + (1, 1, NOW() - INTERVAL '2 months 1 day'), + (1, 1, NOW() - INTERVAL '3 months 1 day'), + (1, 2, NOW() - INTERVAL '1 month 1 day'), + (1, 2, NOW() - INTERVAL '1 hour'), + (1, 2, NOW() - INTERVAL '1 minute'), + (1, 2, NOW() - INTERVAL '2 months 1 day')`) require.NoError(t, err) - // This test is bad, and I think it's because of daylight savings. - // I need to find a better test. - activity, err = store.GetListenActivity(ctx, db.ListenActivityOpts{Step: db.StepMonth, Range: 8}) require.NoError(t, err) - // require.Len(t, activity, 8) - // assert.Equal(t, []int64{0, 0, 0, 0, 1, 2, 2, 0}, flattenListenCounts(activity)) + require.Len(t, activity, 4) + assert.Equal(t, []int64{1, 2, 2, 2}, flattenListenCounts(activity)) // Truncate listens table and insert specific dates for testing opts.Step = db.StepYear err = store.Exec(context.Background(), `TRUNCATE TABLE listens RESTART IDENTITY`) From 94108953ec357449a44299d49585ae048aae0ea8 Mon Sep 17 00:00:00 2001 From: Gabe Farrell <90876006+gabehf@users.noreply.github.com> Date: Wed, 14 Jan 2026 22:12:57 -0500 Subject: [PATCH 12/37] fix: conditional rendering on artist and album pages (#140) --- client/app/routes/MediaItems/Album.tsx | 6 +++--- client/app/routes/MediaItems/Artist.tsx | 8 ++++---- 2 files changed, 7 insertions(+), 7 deletions(-) diff --git a/client/app/routes/MediaItems/Album.tsx b/client/app/routes/MediaItems/Album.tsx index afba6f7..0de544a 100644 --- a/client/app/routes/MediaItems/Album.tsx +++ b/client/app/routes/MediaItems/Album.tsx @@ -45,17 +45,17 @@ export default function Album() { }} subContent={
- {album.listen_count && ( + {album.listen_count !== 0 && (

{album.listen_count} play{album.listen_count > 1 ? "s" : ""}

)} - {album.time_listened && ( + {album.time_listened !== 0 && (

{timeListenedString(album.time_listened)}

)} - {album.first_listen && ( + {album.first_listen > 0 && (

Listening since{" "} {new Date(album.first_listen * 1000).toLocaleDateString()} diff --git a/client/app/routes/MediaItems/Artist.tsx b/client/app/routes/MediaItems/Artist.tsx index 00334c1..f2600be 100644 --- a/client/app/routes/MediaItems/Artist.tsx +++ b/client/app/routes/MediaItems/Artist.tsx @@ -56,17 +56,17 @@ export default function Artist() { {artist.listen_count} play{artist.listen_count > 1 ? "s" : ""}

)} - { + {artist.time_listened !== 0 && (

{timeListenedString(artist.time_listened)}

- } - { + )} + {artist.first_listen > 0 && (

Listening since{" "} {new Date(artist.first_listen * 1000).toLocaleDateString()}

- } + )}
} > From 9dbdfe5e414c5712e40c86375dbb0ae8216d7466 Mon Sep 17 00:00:00 2001 From: Gabe Farrell <90876006+gabehf@users.noreply.github.com> Date: Thu, 15 Jan 2026 18:21:51 -0500 Subject: [PATCH 13/37] update README --- README.md | 2 ++ 1 file changed, 2 insertions(+) diff --git a/README.md b/README.md index 6c24726..b51b2ff 100644 --- a/README.md +++ b/README.md @@ -2,6 +2,8 @@ ![Koito logo](https://github.com/user-attachments/assets/bd69a050-b40f-4da7-8ff1-4607554bfd6d) +*Koito (小糸) is a Japanese surname. It is also homophonous with the words 恋と (koi to), meaning "and/with love".* +
From 92648167f0f5c46ba6ea1cba481db8dbefea68c2 Mon Sep 17 00:00:00 2001 From: Gabe Farrell <90876006+gabehf@users.noreply.github.com> Date: Thu, 15 Jan 2026 19:36:48 -0500 Subject: [PATCH 14/37] fix: get current time in tz for listen activity (#146) * fix: get current time in tz for listen activity * fix: adjust test to prevent timezone errors --- internal/db/period.go | 2 +- internal/db/psql/listen_activity.go | 8 ++++---- internal/db/psql/listen_activity_test.go | 4 ++-- 3 files changed, 7 insertions(+), 7 deletions(-) diff --git a/internal/db/period.go b/internal/db/period.go index f13d321..00c4886 100644 --- a/internal/db/period.go +++ b/internal/db/period.go @@ -57,11 +57,11 @@ const ( // and end will be 23:59:59 on Saturday at the end of the current week. // If opts.Year (or opts.Year + opts.Month) is provided, start and end will simply by the start and end times of that year/month. func ListenActivityOptsToTimes(opts ListenActivityOpts) (start, end time.Time) { - now := time.Now() loc := opts.Timezone if loc == nil { loc, _ = time.LoadLocation("UTC") } + now := time.Now().In(loc) // If Year (and optionally Month) are specified, use calendar boundaries if opts.Year != 0 { diff --git a/internal/db/psql/listen_activity.go b/internal/db/psql/listen_activity.go index 7a3a776..b2c7990 100644 --- a/internal/db/psql/listen_activity.go +++ b/internal/db/psql/listen_activity.go @@ -23,7 +23,7 @@ func (d *Psql) GetListenActivity(ctx context.Context, opts db.ListenActivityOpts var listenActivity []db.ListenActivityItem if opts.AlbumID > 0 { l.Debug().Msgf("Fetching listen activity for %d %s(s) from %v to %v for release group %d", - opts.Range, opts.Step, t1.Format("Jan 02, 2006 15:04:05"), t2.Format("Jan 02, 2006 15:04:05"), opts.AlbumID) + opts.Range, opts.Step, t1.Format("Jan 02, 2006 15:04:05 MST"), t2.Format("Jan 02, 2006 15:04:05 MST"), opts.AlbumID) rows, err := d.q.ListenActivityForRelease(ctx, repository.ListenActivityForReleaseParams{ Column1: opts.Timezone.String(), ListenedAt: t1, @@ -44,7 +44,7 @@ func (d *Psql) GetListenActivity(ctx context.Context, opts db.ListenActivityOpts l.Debug().Msgf("Database responded with %d steps", len(rows)) } else if opts.ArtistID > 0 { l.Debug().Msgf("Fetching listen activity for %d %s(s) from %v to %v for artist %d", - opts.Range, opts.Step, t1.Format("Jan 02, 2006 15:04:05"), t2.Format("Jan 02, 2006 15:04:05"), opts.ArtistID) + opts.Range, opts.Step, t1.Format("Jan 02, 2006 15:04:05 MST"), t2.Format("Jan 02, 2006 15:04:05 MST"), opts.ArtistID) rows, err := d.q.ListenActivityForArtist(ctx, repository.ListenActivityForArtistParams{ Column1: opts.Timezone.String(), ListenedAt: t1, @@ -65,7 +65,7 @@ func (d *Psql) GetListenActivity(ctx context.Context, opts db.ListenActivityOpts l.Debug().Msgf("Database responded with %d steps", len(rows)) } else if opts.TrackID > 0 { l.Debug().Msgf("Fetching listen activity for %d %s(s) from %v to %v for track %d", - opts.Range, opts.Step, t1.Format("Jan 02, 2006 15:04:05"), t2.Format("Jan 02, 2006 15:04:05"), opts.TrackID) + opts.Range, opts.Step, t1.Format("Jan 02, 2006 15:04:05 MST"), t2.Format("Jan 02, 2006 15:04:05 MST"), opts.TrackID) rows, err := d.q.ListenActivityForTrack(ctx, repository.ListenActivityForTrackParams{ Column1: opts.Timezone.String(), ListenedAt: t1, @@ -86,7 +86,7 @@ func (d *Psql) GetListenActivity(ctx context.Context, opts db.ListenActivityOpts l.Debug().Msgf("Database responded with %d steps", len(rows)) } else { l.Debug().Msgf("Fetching listen activity for %d %s(s) from %v to %v", - opts.Range, opts.Step, t1.Format("Jan 02, 2006 15:04:05"), t2.Format("Jan 02, 2006 15:04:05")) + opts.Range, opts.Step, t1.Format("Jan 02, 2006 15:04:05 MST"), t2.Format("Jan 02, 2006 15:04:05 MST")) rows, err := d.q.ListenActivity(ctx, repository.ListenActivityParams{ Column1: opts.Timezone.String(), ListenedAt: t1, diff --git a/internal/db/psql/listen_activity_test.go b/internal/db/psql/listen_activity_test.go index b2da07f..affc202 100644 --- a/internal/db/psql/listen_activity_test.go +++ b/internal/db/psql/listen_activity_test.go @@ -101,8 +101,8 @@ func TestListenActivity(t *testing.T) { (1, 1, NOW() - INTERVAL '2 months 1 day'), (1, 1, NOW() - INTERVAL '3 months 1 day'), (1, 2, NOW() - INTERVAL '1 month 1 day'), - (1, 2, NOW() - INTERVAL '1 hour'), - (1, 2, NOW() - INTERVAL '1 minute'), + (1, 2, NOW() - INTERVAL '1 second'), + (1, 2, NOW() - INTERVAL '2 seconds'), (1, 2, NOW() - INTERVAL '2 months 1 day')`) require.NoError(t, err) From 1eb1cd0fd5a1f385e585f16835b34a4f29b45c71 Mon Sep 17 00:00:00 2001 From: Gabe Farrell <90876006+gabehf@users.noreply.github.com> Date: Thu, 15 Jan 2026 19:40:38 -0500 Subject: [PATCH 15/37] chore: call relay early to prevent missed relays (#145) * chore: call relay early to prevent missed relays * fix: get current time in tz for listen activity (#146) * fix: get current time in tz for listen activity * fix: adjust test to prevent timezone errors --- engine/handlers/lbz_submit_listen.go | 9 +++++---- 1 file changed, 5 insertions(+), 4 deletions(-) diff --git a/engine/handlers/lbz_submit_listen.go b/engine/handlers/lbz_submit_listen.go index 91eeaac..daf7969 100644 --- a/engine/handlers/lbz_submit_listen.go +++ b/engine/handlers/lbz_submit_listen.go @@ -90,6 +90,11 @@ func LbzSubmitListenHandler(store db.DB, mbzc mbz.MusicBrainzCaller) func(w http utils.WriteError(w, "failed to read request body", http.StatusBadRequest) return } + + if cfg.LbzRelayEnabled() { + go doLbzRelay(requestBytes, l) + } + if err := json.NewDecoder(bytes.NewBuffer(requestBytes)).Decode(&req); err != nil { l.Err(err).Msg("LbzSubmitListenHandler: Failed to decode request") utils.WriteError(w, "failed to decode request", http.StatusBadRequest) @@ -234,10 +239,6 @@ func LbzSubmitListenHandler(store db.DB, mbzc mbz.MusicBrainzCaller) func(w http w.WriteHeader(http.StatusOK) w.Header().Set("Content-Type", "application/json") w.Write([]byte("{\"status\": \"ok\"}")) - - if cfg.LbzRelayEnabled() { - go doLbzRelay(requestBytes, l) - } } } From aa7fddd51889a5f9e84992d46d4ade929da83733 Mon Sep 17 00:00:00 2001 From: Gabe Farrell <90876006+gabehf@users.noreply.github.com> Date: Thu, 15 Jan 2026 20:21:05 -0500 Subject: [PATCH 16/37] fix: a couple ui fixes (#147) * fix: reduce loading component width * improve theme selector for mobile * match interest graph width to activity grid --- client/app/components/ActivityGrid.tsx | 4 +- client/app/components/AllTimeStats.tsx | 2 +- client/app/components/InterestGraph.tsx | 6 +-- .../components/themeSwitcher/ThemeOption.tsx | 52 +++++++++++++------ .../themeSwitcher/ThemeSwitcher.tsx | 2 +- 5 files changed, 43 insertions(+), 23 deletions(-) diff --git a/client/app/components/ActivityGrid.tsx b/client/app/components/ActivityGrid.tsx index 18ca0de..0d39e2c 100644 --- a/client/app/components/ActivityGrid.tsx +++ b/client/app/components/ActivityGrid.tsx @@ -68,14 +68,14 @@ export default function ActivityGrid({ if (isPending) { return ( -
+

Activity

Loading...

); } else if (isError) { return ( -
+

Activity

Error: {error.message}

diff --git a/client/app/components/AllTimeStats.tsx b/client/app/components/AllTimeStats.tsx index 556fa32..6a3ebac 100644 --- a/client/app/components/AllTimeStats.tsx +++ b/client/app/components/AllTimeStats.tsx @@ -11,7 +11,7 @@ export default function AllTimeStats() { if (isPending) { return ( -
+

{header}

Loading...

diff --git a/client/app/components/InterestGraph.tsx b/client/app/components/InterestGraph.tsx index 7f22209..9e2baaf 100644 --- a/client/app/components/InterestGraph.tsx +++ b/client/app/components/InterestGraph.tsx @@ -48,14 +48,14 @@ export default function InterestGraph({ if (isPending) { return ( -
+

Interest over time

Loading...

); } else if (isError) { return ( -
+

Interest over time

Error: {error.message}

@@ -67,7 +67,7 @@ export default function InterestGraph({ // so I think I just have to remove it for now. return ( -
+

Interest over time

{ + return s.charAt(0).toUpperCase() + s.slice(1); + }; - const capitalizeFirstLetter = (s: string) => { - return s.charAt(0).toUpperCase() + s.slice(1); - } - - return ( -
setTheme(themeName)} className="rounded-md p-3 sm:p-5 hover:cursor-pointer flex gap-4 items-center border-2" style={{background: theme.bg, color: theme.fg, borderColor: theme.bgSecondary}}> -
{capitalizeFirstLetter(themeName)}
-
-
-
-
- ) -} \ No newline at end of file + return ( +
setTheme(themeName)} + className="rounded-md p-3 sm:p-5 hover:cursor-pointer flex gap-3 items-center border-2 justify-between" + style={{ + background: theme.bg, + color: theme.fg, + borderColor: theme.bgSecondary, + }} + > +
+ {capitalizeFirstLetter(themeName)} +
+
+
+
+
+
+
+ ); +} diff --git a/client/app/components/themeSwitcher/ThemeSwitcher.tsx b/client/app/components/themeSwitcher/ThemeSwitcher.tsx index 62374be..f27d41c 100644 --- a/client/app/components/themeSwitcher/ThemeSwitcher.tsx +++ b/client/app/components/themeSwitcher/ThemeSwitcher.tsx @@ -49,7 +49,7 @@ export function ThemeSwitcher() { Reset
-
+
{Object.entries(themes).map(([name, themeData]) => ( Date: Thu, 15 Jan 2026 21:08:30 -0500 Subject: [PATCH 17/37] fix: use sql rank (#148) --- client/api/api.ts | 17 ++-- client/app/components/TopItemList.tsx | 29 ++---- client/app/routes/Charts/AlbumChart.tsx | 4 +- client/app/routes/Charts/ArtistChart.tsx | 4 +- client/app/routes/Charts/TrackChart.tsx | 6 +- db/queries/artist.sql | 23 +++-- db/queries/release.sql | 50 +++++---- db/queries/track.sql | 117 +++++++++++++-------- internal/db/db.go | 6 +- internal/db/psql/top_albums.go | 21 ++-- internal/db/psql/top_albums_test.go | 28 +++--- internal/db/psql/top_artists.go | 9 +- internal/db/psql/top_artists_test.go | 26 ++--- internal/db/psql/top_tracks.go | 21 ++-- internal/db/psql/top_tracks_test.go | 36 +++---- internal/db/types.go | 5 + internal/repository/artist.sql.go | 25 +++-- internal/repository/release.sql.go | 54 ++++++---- internal/repository/track.sql.go | 123 +++++++++++++++-------- internal/summary/summary.go | 52 +++++----- 20 files changed, 386 insertions(+), 270 deletions(-) diff --git a/client/api/api.ts b/client/api/api.ts index 2b0b665..ff69b78 100644 --- a/client/api/api.ts +++ b/client/api/api.ts @@ -48,32 +48,32 @@ async function getLastListens( async function getTopTracks( args: getItemsArgs -): Promise> { +): Promise>> { let url = `/apis/web/v1/top-tracks?period=${args.period}&limit=${args.limit}&page=${args.page}`; if (args.artist_id) url += `&artist_id=${args.artist_id}`; else if (args.album_id) url += `&album_id=${args.album_id}`; const r = await fetch(url); - return handleJson>(r); + return handleJson>>(r); } async function getTopAlbums( args: getItemsArgs -): Promise> { +): Promise>> { let url = `/apis/web/v1/top-albums?period=${args.period}&limit=${args.limit}&page=${args.page}`; if (args.artist_id) url += `&artist_id=${args.artist_id}`; const r = await fetch(url); - return handleJson>(r); + return handleJson>>(r); } async function getTopArtists( args: getItemsArgs -): Promise> { +): Promise>> { const url = `/apis/web/v1/top-artists?period=${args.period}&limit=${args.limit}&page=${args.page}`; const r = await fetch(url); - return handleJson>(r); + return handleJson>>(r); } async function getActivity( @@ -407,6 +407,10 @@ type PaginatedResponse = { current_page: number; items_per_page: number; }; +type Ranked = { + item: T; + rank: number; +}; type ListenActivityItem = { start_time: Date; listens: number; @@ -480,6 +484,7 @@ export type { Listen, SearchResponse, PaginatedResponse, + Ranked, ListenActivityItem, InterestBucket, User, diff --git a/client/app/components/TopItemList.tsx b/client/app/components/TopItemList.tsx index adb60ce..4d355b7 100644 --- a/client/app/components/TopItemList.tsx +++ b/client/app/components/TopItemList.tsx @@ -6,11 +6,12 @@ import { type Artist, type Track, type PaginatedResponse, + type Ranked, } from "api/api"; type Item = Album | Track | Artist; -interface Props { +interface Props> { data: PaginatedResponse; separators?: ConstrainBoolean; ranked?: boolean; @@ -18,33 +19,17 @@ interface Props { className?: string; } -export default function TopItemList({ +export default function TopItemList>({ data, separators, type, className, ranked, }: Props) { - const currentParams = new URLSearchParams(location.search); - const page = Math.max(parseInt(currentParams.get("page") || "1"), 1); - - let lastRank = 0; - - const calculateRank = (data: Item[], page: number, index: number): number => { - if ( - index === 0 || - data[index] == undefined || - !(data[index].listen_count === data[index - 1].listen_count) - ) { - lastRank = index + 1 + (page - 1) * 100; - } - return lastRank; - }; - return (
{data.items.map((item, index) => { - const key = `${type}-${item.id}`; + const key = `${type}-${item.item.id}`; return (
({ >
); diff --git a/client/app/routes/Charts/AlbumChart.tsx b/client/app/routes/Charts/AlbumChart.tsx index 96370a9..7bc4eea 100644 --- a/client/app/routes/Charts/AlbumChart.tsx +++ b/client/app/routes/Charts/AlbumChart.tsx @@ -1,7 +1,7 @@ import TopItemList from "~/components/TopItemList"; import ChartLayout from "./ChartLayout"; import { useLoaderData, type LoaderFunctionArgs } from "react-router"; -import { type Album, type PaginatedResponse } from "api/api"; +import { type Album, type PaginatedResponse, type Ranked } from "api/api"; export async function clientLoader({ request }: LoaderFunctionArgs) { const url = new URL(request.url); @@ -21,7 +21,7 @@ export async function clientLoader({ request }: LoaderFunctionArgs) { export default function AlbumChart() { const { top_albums: initialData } = useLoaderData<{ - top_albums: PaginatedResponse; + top_albums: PaginatedResponse>; }>(); return ( diff --git a/client/app/routes/Charts/ArtistChart.tsx b/client/app/routes/Charts/ArtistChart.tsx index 676700d..f128027 100644 --- a/client/app/routes/Charts/ArtistChart.tsx +++ b/client/app/routes/Charts/ArtistChart.tsx @@ -1,7 +1,7 @@ import TopItemList from "~/components/TopItemList"; import ChartLayout from "./ChartLayout"; import { useLoaderData, type LoaderFunctionArgs } from "react-router"; -import { type Album, type PaginatedResponse } from "api/api"; +import { type Album, type PaginatedResponse, type Ranked } from "api/api"; export async function clientLoader({ request }: LoaderFunctionArgs) { const url = new URL(request.url); @@ -21,7 +21,7 @@ export async function clientLoader({ request }: LoaderFunctionArgs) { export default function Artist() { const { top_artists: initialData } = useLoaderData<{ - top_artists: PaginatedResponse; + top_artists: PaginatedResponse>; }>(); return ( diff --git a/client/app/routes/Charts/TrackChart.tsx b/client/app/routes/Charts/TrackChart.tsx index 9e8ee08..023dceb 100644 --- a/client/app/routes/Charts/TrackChart.tsx +++ b/client/app/routes/Charts/TrackChart.tsx @@ -1,7 +1,7 @@ import TopItemList from "~/components/TopItemList"; import ChartLayout from "./ChartLayout"; import { useLoaderData, type LoaderFunctionArgs } from "react-router"; -import { type Album, type PaginatedResponse } from "api/api"; +import { type Track, type PaginatedResponse, type Ranked } from "api/api"; export async function clientLoader({ request }: LoaderFunctionArgs) { const url = new URL(request.url); @@ -15,13 +15,13 @@ export async function clientLoader({ request }: LoaderFunctionArgs) { throw new Response("Failed to load top tracks", { status: 500 }); } - const top_tracks: PaginatedResponse = await res.json(); + const top_tracks: PaginatedResponse = await res.json(); return { top_tracks }; } export default function TrackChart() { const { top_tracks: initialData } = useLoaderData<{ - top_tracks: PaginatedResponse; + top_tracks: PaginatedResponse>; }>(); return ( diff --git a/db/queries/artist.sql b/db/queries/artist.sql index e20326d..863de32 100644 --- a/db/queries/artist.sql +++ b/db/queries/artist.sql @@ -58,18 +58,27 @@ GROUP BY a.id, a.musicbrainz_id, a.image, a.image_source, a.name; -- name: GetTopArtistsPaginated :many SELECT + x.id, + x.name, + x.musicbrainz_id, + x.image, + x.listen_count, + RANK() OVER (ORDER BY x.listen_count DESC) AS rank +FROM ( + SELECT a.id, a.name, a.musicbrainz_id, a.image, COUNT(*) AS listen_count -FROM listens l -JOIN tracks t ON l.track_id = t.id -JOIN artist_tracks at ON at.track_id = t.id -JOIN artists_with_name a ON a.id = at.artist_id -WHERE l.listened_at BETWEEN $1 AND $2 -GROUP BY a.id, a.name, a.musicbrainz_id, a.image, a.image_source, a.name -ORDER BY listen_count DESC, a.id + FROM listens l + JOIN tracks t ON l.track_id = t.id + JOIN artist_tracks at ON at.track_id = t.id + JOIN artists_with_name a ON a.id = at.artist_id + WHERE l.listened_at BETWEEN $1 AND $2 + GROUP BY a.id, a.name, a.musicbrainz_id, a.image +) x +ORDER BY x.listen_count DESC, x.id LIMIT $3 OFFSET $4; -- name: CountTopArtists :one diff --git a/db/queries/release.sql b/db/queries/release.sql index 9f54291..cb548ed 100644 --- a/db/queries/release.sql +++ b/db/queries/release.sql @@ -47,30 +47,40 @@ WHERE r.title = ANY ($1::TEXT[]) -- name: GetTopReleasesFromArtist :many SELECT - r.*, - COUNT(*) AS listen_count, - get_artists_for_release(r.id) AS artists -FROM listens l -JOIN tracks t ON l.track_id = t.id -JOIN releases_with_title r ON t.release_id = r.id -JOIN artist_releases ar ON r.id = ar.release_id -WHERE ar.artist_id = $5 - AND l.listened_at BETWEEN $1 AND $2 -GROUP BY r.id, r.title, r.musicbrainz_id, r.various_artists, r.image, r.image_source -ORDER BY listen_count DESC, r.id + x.*, + RANK() OVER (ORDER BY x.listen_count DESC) AS rank +FROM ( + SELECT + r.*, + COUNT(*) AS listen_count, + get_artists_for_release(r.id) AS artists + FROM listens l + JOIN tracks t ON l.track_id = t.id + JOIN releases_with_title r ON t.release_id = r.id + JOIN artist_releases ar ON r.id = ar.release_id + WHERE ar.artist_id = $5 + AND l.listened_at BETWEEN $1 AND $2 + GROUP BY r.id, r.title, r.musicbrainz_id, r.various_artists, r.image, r.image_source +) x +ORDER BY listen_count DESC, x.id LIMIT $3 OFFSET $4; -- name: GetTopReleasesPaginated :many SELECT - r.*, - COUNT(*) AS listen_count, - get_artists_for_release(r.id) AS artists -FROM listens l -JOIN tracks t ON l.track_id = t.id -JOIN releases_with_title r ON t.release_id = r.id -WHERE l.listened_at BETWEEN $1 AND $2 -GROUP BY r.id, r.title, r.musicbrainz_id, r.various_artists, r.image, r.image_source -ORDER BY listen_count DESC, r.id + x.*, + RANK() OVER (ORDER BY x.listen_count DESC) AS rank +FROM ( + SELECT + r.*, + COUNT(*) AS listen_count, + get_artists_for_release(r.id) AS artists + FROM listens l + JOIN tracks t ON l.track_id = t.id + JOIN releases_with_title r ON t.release_id = r.id + WHERE l.listened_at BETWEEN $1 AND $2 + GROUP BY r.id, r.title, r.musicbrainz_id, r.various_artists, r.image, r.image_source +) x +ORDER BY listen_count DESC, x.id LIMIT $3 OFFSET $4; -- name: CountTopReleases :one diff --git a/db/queries/track.sql b/db/queries/track.sql index 933fcc1..24be467 100644 --- a/db/queries/track.sql +++ b/db/queries/track.sql @@ -39,56 +39,89 @@ HAVING COUNT(DISTINCT at.artist_id) = cardinality($3::int[]); -- name: GetTopTracksPaginated :many SELECT - t.id, - t.title, - t.musicbrainz_id, - t.release_id, - r.image, - COUNT(*) AS listen_count, - get_artists_for_track(t.id) AS artists -FROM listens l -JOIN tracks_with_title t ON l.track_id = t.id -JOIN releases r ON t.release_id = r.id -WHERE l.listened_at BETWEEN $1 AND $2 -GROUP BY t.id, t.title, t.musicbrainz_id, t.release_id, r.image -ORDER BY listen_count DESC, t.id + x.id, + x.title, + x.musicbrainz_id, + x.release_id, + x.image, + x.listen_count, + x.artists, + RANK() OVER (ORDER BY x.listen_count DESC) AS rank +FROM ( + SELECT + t.id, + t.title, + t.musicbrainz_id, + t.release_id, + r.image, + COUNT(*) AS listen_count, + get_artists_for_track(t.id) AS artists + FROM listens l + JOIN tracks_with_title t ON l.track_id = t.id + JOIN releases r ON t.release_id = r.id + WHERE l.listened_at BETWEEN $1 AND $2 + GROUP BY t.id, t.title, t.musicbrainz_id, t.release_id, r.image +) x +ORDER BY x.listen_count DESC, x.id LIMIT $3 OFFSET $4; -- name: GetTopTracksByArtistPaginated :many SELECT - t.id, - t.title, - t.musicbrainz_id, - t.release_id, - r.image, - COUNT(*) AS listen_count, - get_artists_for_track(t.id) AS artists -FROM listens l -JOIN tracks_with_title t ON l.track_id = t.id -JOIN releases r ON t.release_id = r.id -JOIN artist_tracks at ON at.track_id = t.id -WHERE l.listened_at BETWEEN $1 AND $2 - AND at.artist_id = $5 -GROUP BY t.id, t.title, t.musicbrainz_id, t.release_id, r.image -ORDER BY listen_count DESC, t.id + x.id, + x.title, + x.musicbrainz_id, + x.release_id, + x.image, + x.listen_count, + x.artists, + RANK() OVER (ORDER BY x.listen_count DESC) AS rank +FROM ( + SELECT + t.id, + t.title, + t.musicbrainz_id, + t.release_id, + r.image, + COUNT(*) AS listen_count, + get_artists_for_track(t.id) AS artists + FROM listens l + JOIN tracks_with_title t ON l.track_id = t.id + JOIN releases r ON t.release_id = r.id + JOIN artist_tracks at ON at.track_id = t.id + WHERE l.listened_at BETWEEN $1 AND $2 + AND at.artist_id = $5 + GROUP BY t.id, t.title, t.musicbrainz_id, t.release_id, r.image +) x +ORDER BY x.listen_count DESC, x.id LIMIT $3 OFFSET $4; -- name: GetTopTracksInReleasePaginated :many SELECT - t.id, - t.title, - t.musicbrainz_id, - t.release_id, - r.image, - COUNT(*) AS listen_count, - get_artists_for_track(t.id) AS artists -FROM listens l -JOIN tracks_with_title t ON l.track_id = t.id -JOIN releases r ON t.release_id = r.id -WHERE l.listened_at BETWEEN $1 AND $2 - AND t.release_id = $5 -GROUP BY t.id, t.title, t.musicbrainz_id, t.release_id, r.image -ORDER BY listen_count DESC, t.id + x.id, + x.title, + x.musicbrainz_id, + x.release_id, + x.image, + x.listen_count, + x.artists, + RANK() OVER (ORDER BY x.listen_count DESC) AS rank +FROM ( + SELECT + t.id, + t.title, + t.musicbrainz_id, + t.release_id, + r.image, + COUNT(*) AS listen_count, + get_artists_for_track(t.id) AS artists + FROM listens l + JOIN tracks_with_title t ON l.track_id = t.id + JOIN releases r ON t.release_id = r.id + WHERE l.listened_at BETWEEN $1 AND $2 + AND t.release_id = $5 + GROUP BY t.id, t.title, t.musicbrainz_id, t.release_id, r.image +) x +ORDER BY x.listen_count DESC, x.id LIMIT $3 OFFSET $4; -- name: CountTopTracks :one diff --git a/internal/db/db.go b/internal/db/db.go index 4695967..a0f0f80 100644 --- a/internal/db/db.go +++ b/internal/db/db.go @@ -19,9 +19,9 @@ type DB interface { GetTracksWithNoDurationButHaveMbzID(ctx context.Context, from int32) ([]*models.Track, error) GetArtistsForAlbum(ctx context.Context, id int32) ([]*models.Artist, error) GetArtistsForTrack(ctx context.Context, id int32) ([]*models.Artist, error) - GetTopTracksPaginated(ctx context.Context, opts GetItemsOpts) (*PaginatedResponse[*models.Track], error) - GetTopArtistsPaginated(ctx context.Context, opts GetItemsOpts) (*PaginatedResponse[*models.Artist], error) - GetTopAlbumsPaginated(ctx context.Context, opts GetItemsOpts) (*PaginatedResponse[*models.Album], error) + GetTopTracksPaginated(ctx context.Context, opts GetItemsOpts) (*PaginatedResponse[RankedItem[*models.Track]], error) + GetTopArtistsPaginated(ctx context.Context, opts GetItemsOpts) (*PaginatedResponse[RankedItem[*models.Artist]], error) + GetTopAlbumsPaginated(ctx context.Context, opts GetItemsOpts) (*PaginatedResponse[RankedItem[*models.Album]], error) GetListensPaginated(ctx context.Context, opts GetItemsOpts) (*PaginatedResponse[*models.Listen], error) GetListenActivity(ctx context.Context, opts ListenActivityOpts) ([]ListenActivityItem, error) GetAllArtistAliases(ctx context.Context, id int32) ([]models.Alias, error) diff --git a/internal/db/psql/top_albums.go b/internal/db/psql/top_albums.go index 8610ce5..652b790 100644 --- a/internal/db/psql/top_albums.go +++ b/internal/db/psql/top_albums.go @@ -11,7 +11,7 @@ import ( "github.com/gabehf/koito/internal/repository" ) -func (d *Psql) GetTopAlbumsPaginated(ctx context.Context, opts db.GetItemsOpts) (*db.PaginatedResponse[*models.Album], error) { +func (d *Psql) GetTopAlbumsPaginated(ctx context.Context, opts db.GetItemsOpts) (*db.PaginatedResponse[db.RankedItem[*models.Album]], error) { l := logger.FromContext(ctx) offset := (opts.Page - 1) * opts.Limit t1, t2 := db.TimeframeToTimeRange(opts.Timeframe) @@ -19,7 +19,7 @@ func (d *Psql) GetTopAlbumsPaginated(ctx context.Context, opts db.GetItemsOpts) opts.Limit = DefaultItemsPerPage } - var rgs []*models.Album + var rgs []db.RankedItem[*models.Album] var count int64 if opts.ArtistID != 0 { @@ -36,7 +36,7 @@ func (d *Psql) GetTopAlbumsPaginated(ctx context.Context, opts db.GetItemsOpts) if err != nil { return nil, fmt.Errorf("GetTopAlbumsPaginated: GetTopReleasesFromArtist: %w", err) } - rgs = make([]*models.Album, len(rows)) + rgs = make([]db.RankedItem[*models.Album], len(rows)) l.Debug().Msgf("Database responded with %d items", len(rows)) for i, v := range rows { artists := make([]models.SimpleArtist, 0) @@ -45,7 +45,7 @@ func (d *Psql) GetTopAlbumsPaginated(ctx context.Context, opts db.GetItemsOpts) l.Err(err).Msgf("Error unmarshalling artists for release group with id %d", v.ID) return nil, fmt.Errorf("GetTopAlbumsPaginated: Unmarshal: %w", err) } - rgs[i] = &models.Album{ + rgs[i].Item = &models.Album{ ID: v.ID, MbzID: v.MusicBrainzID, Title: v.Title, @@ -54,6 +54,7 @@ func (d *Psql) GetTopAlbumsPaginated(ctx context.Context, opts db.GetItemsOpts) VariousArtists: v.VariousArtists, ListenCount: v.ListenCount, } + rgs[i].Rank = v.Rank } count, err = d.q.CountReleasesFromArtist(ctx, int32(opts.ArtistID)) if err != nil { @@ -71,7 +72,7 @@ func (d *Psql) GetTopAlbumsPaginated(ctx context.Context, opts db.GetItemsOpts) if err != nil { return nil, fmt.Errorf("GetTopAlbumsPaginated: GetTopReleasesPaginated: %w", err) } - rgs = make([]*models.Album, len(rows)) + rgs = make([]db.RankedItem[*models.Album], len(rows)) l.Debug().Msgf("Database responded with %d items", len(rows)) for i, row := range rows { artists := make([]models.SimpleArtist, 0) @@ -80,16 +81,16 @@ func (d *Psql) GetTopAlbumsPaginated(ctx context.Context, opts db.GetItemsOpts) l.Err(err).Msgf("Error unmarshalling artists for release group with id %d", row.ID) return nil, fmt.Errorf("GetTopAlbumsPaginated: Unmarshal: %w", err) } - t := &models.Album{ - Title: row.Title, - MbzID: row.MusicBrainzID, + rgs[i].Item = &models.Album{ ID: row.ID, + MbzID: row.MusicBrainzID, + Title: row.Title, Image: row.Image, Artists: artists, VariousArtists: row.VariousArtists, ListenCount: row.ListenCount, } - rgs[i] = t + rgs[i].Rank = row.Rank } count, err = d.q.CountTopReleases(ctx, repository.CountTopReleasesParams{ ListenedAt: t1, @@ -100,7 +101,7 @@ func (d *Psql) GetTopAlbumsPaginated(ctx context.Context, opts db.GetItemsOpts) } l.Debug().Msgf("Database responded with %d albums out of a total %d", len(rows), count) } - return &db.PaginatedResponse[*models.Album]{ + return &db.PaginatedResponse[db.RankedItem[*models.Album]]{ Items: rgs, TotalCount: count, ItemsPerPage: int32(opts.Limit), diff --git a/internal/db/psql/top_albums_test.go b/internal/db/psql/top_albums_test.go index ff0efef..eb4efde 100644 --- a/internal/db/psql/top_albums_test.go +++ b/internal/db/psql/top_albums_test.go @@ -18,16 +18,16 @@ func TestGetTopAlbumsPaginated(t *testing.T) { require.NoError(t, err) require.Len(t, resp.Items, 4) assert.Equal(t, int64(4), resp.TotalCount) - assert.Equal(t, "Release One", resp.Items[0].Title) - assert.Equal(t, "Release Two", resp.Items[1].Title) - assert.Equal(t, "Release Three", resp.Items[2].Title) - assert.Equal(t, "Release Four", resp.Items[3].Title) + assert.Equal(t, "Release One", resp.Items[0].Item.Title) + assert.Equal(t, "Release Two", resp.Items[1].Item.Title) + assert.Equal(t, "Release Three", resp.Items[2].Item.Title) + assert.Equal(t, "Release Four", resp.Items[3].Item.Title) // Test pagination resp, err = store.GetTopAlbumsPaginated(ctx, db.GetItemsOpts{Limit: 1, Page: 2, Timeframe: db.Timeframe{Period: db.PeriodAllTime}}) require.NoError(t, err) require.Len(t, resp.Items, 1) - assert.Equal(t, "Release Two", resp.Items[0].Title) + assert.Equal(t, "Release Two", resp.Items[0].Item.Title) // Test page out of range resp, err = store.GetTopAlbumsPaginated(ctx, db.GetItemsOpts{Limit: 1, Page: 10, Timeframe: db.Timeframe{Period: db.PeriodAllTime}}) @@ -57,29 +57,29 @@ func TestGetTopAlbumsPaginated(t *testing.T) { require.NoError(t, err) require.Len(t, resp.Items, 1) assert.Equal(t, int64(1), resp.TotalCount) - assert.Equal(t, "Release Four", resp.Items[0].Title) + assert.Equal(t, "Release Four", resp.Items[0].Item.Title) resp, err = store.GetTopAlbumsPaginated(ctx, db.GetItemsOpts{Timeframe: db.Timeframe{Period: db.PeriodMonth}}) require.NoError(t, err) require.Len(t, resp.Items, 2) assert.Equal(t, int64(2), resp.TotalCount) - assert.Equal(t, "Release Three", resp.Items[0].Title) - assert.Equal(t, "Release Four", resp.Items[1].Title) + assert.Equal(t, "Release Three", resp.Items[0].Item.Title) + assert.Equal(t, "Release Four", resp.Items[1].Item.Title) resp, err = store.GetTopAlbumsPaginated(ctx, db.GetItemsOpts{Timeframe: db.Timeframe{Period: db.PeriodYear}}) require.NoError(t, err) require.Len(t, resp.Items, 3) assert.Equal(t, int64(3), resp.TotalCount) - assert.Equal(t, "Release Two", resp.Items[0].Title) - assert.Equal(t, "Release Three", resp.Items[1].Title) - assert.Equal(t, "Release Four", resp.Items[2].Title) + assert.Equal(t, "Release Two", resp.Items[0].Item.Title) + assert.Equal(t, "Release Three", resp.Items[1].Item.Title) + assert.Equal(t, "Release Four", resp.Items[2].Item.Title) // test specific artist resp, err = store.GetTopAlbumsPaginated(ctx, db.GetItemsOpts{Timeframe: db.Timeframe{Period: db.PeriodYear}, ArtistID: 2}) require.NoError(t, err) require.Len(t, resp.Items, 1) assert.Equal(t, int64(1), resp.TotalCount) - assert.Equal(t, "Release Two", resp.Items[0].Title) + assert.Equal(t, "Release Two", resp.Items[0].Item.Title) // Test specify dates @@ -89,11 +89,11 @@ func TestGetTopAlbumsPaginated(t *testing.T) { require.NoError(t, err) require.Len(t, resp.Items, 1) assert.Equal(t, int64(1), resp.TotalCount) - assert.Equal(t, "Release One", resp.Items[0].Title) + assert.Equal(t, "Release One", resp.Items[0].Item.Title) resp, err = store.GetTopAlbumsPaginated(ctx, db.GetItemsOpts{Timeframe: db.Timeframe{Month: 6, Year: 2024}}) require.NoError(t, err) require.Len(t, resp.Items, 1) assert.Equal(t, int64(1), resp.TotalCount) - assert.Equal(t, "Release Two", resp.Items[0].Title) + assert.Equal(t, "Release Two", resp.Items[0].Item.Title) } diff --git a/internal/db/psql/top_artists.go b/internal/db/psql/top_artists.go index f66f082..497efbd 100644 --- a/internal/db/psql/top_artists.go +++ b/internal/db/psql/top_artists.go @@ -10,7 +10,7 @@ import ( "github.com/gabehf/koito/internal/repository" ) -func (d *Psql) GetTopArtistsPaginated(ctx context.Context, opts db.GetItemsOpts) (*db.PaginatedResponse[*models.Artist], error) { +func (d *Psql) GetTopArtistsPaginated(ctx context.Context, opts db.GetItemsOpts) (*db.PaginatedResponse[db.RankedItem[*models.Artist]], error) { l := logger.FromContext(ctx) offset := (opts.Page - 1) * opts.Limit t1, t2 := db.TimeframeToTimeRange(opts.Timeframe) @@ -28,7 +28,7 @@ func (d *Psql) GetTopArtistsPaginated(ctx context.Context, opts db.GetItemsOpts) if err != nil { return nil, fmt.Errorf("GetTopArtistsPaginated: GetTopArtistsPaginated: %w", err) } - rgs := make([]*models.Artist, len(rows)) + rgs := make([]db.RankedItem[*models.Artist], len(rows)) for i, row := range rows { t := &models.Artist{ Name: row.Name, @@ -37,7 +37,8 @@ func (d *Psql) GetTopArtistsPaginated(ctx context.Context, opts db.GetItemsOpts) Image: row.Image, ListenCount: row.ListenCount, } - rgs[i] = t + rgs[i].Item = t + rgs[i].Rank = row.Rank } count, err := d.q.CountTopArtists(ctx, repository.CountTopArtistsParams{ ListenedAt: t1, @@ -48,7 +49,7 @@ func (d *Psql) GetTopArtistsPaginated(ctx context.Context, opts db.GetItemsOpts) } l.Debug().Msgf("Database responded with %d artists out of a total %d", len(rows), count) - return &db.PaginatedResponse[*models.Artist]{ + return &db.PaginatedResponse[db.RankedItem[*models.Artist]]{ Items: rgs, TotalCount: count, ItemsPerPage: int32(opts.Limit), diff --git a/internal/db/psql/top_artists_test.go b/internal/db/psql/top_artists_test.go index 182d96e..7a69ab5 100644 --- a/internal/db/psql/top_artists_test.go +++ b/internal/db/psql/top_artists_test.go @@ -18,16 +18,16 @@ func TestGetTopArtistsPaginated(t *testing.T) { require.NoError(t, err) require.Len(t, resp.Items, 4) assert.Equal(t, int64(4), resp.TotalCount) - assert.Equal(t, "Artist One", resp.Items[0].Name) - assert.Equal(t, "Artist Two", resp.Items[1].Name) - assert.Equal(t, "Artist Three", resp.Items[2].Name) - assert.Equal(t, "Artist Four", resp.Items[3].Name) + assert.Equal(t, "Artist One", resp.Items[0].Item.Name) + assert.Equal(t, "Artist Two", resp.Items[1].Item.Name) + assert.Equal(t, "Artist Three", resp.Items[2].Item.Name) + assert.Equal(t, "Artist Four", resp.Items[3].Item.Name) // Test pagination resp, err = store.GetTopArtistsPaginated(ctx, db.GetItemsOpts{Limit: 1, Page: 2, Timeframe: db.Timeframe{Period: db.PeriodAllTime}}) require.NoError(t, err) require.Len(t, resp.Items, 1) - assert.Equal(t, "Artist Two", resp.Items[0].Name) + assert.Equal(t, "Artist Two", resp.Items[0].Item.Name) // Test page out of range resp, err = store.GetTopArtistsPaginated(ctx, db.GetItemsOpts{Limit: 1, Page: 10, Timeframe: db.Timeframe{Period: db.PeriodAllTime}}) @@ -57,22 +57,22 @@ func TestGetTopArtistsPaginated(t *testing.T) { require.NoError(t, err) require.Len(t, resp.Items, 1) assert.Equal(t, int64(1), resp.TotalCount) - assert.Equal(t, "Artist Four", resp.Items[0].Name) + assert.Equal(t, "Artist Four", resp.Items[0].Item.Name) resp, err = store.GetTopArtistsPaginated(ctx, db.GetItemsOpts{Timeframe: db.Timeframe{Period: db.PeriodMonth}}) require.NoError(t, err) require.Len(t, resp.Items, 2) assert.Equal(t, int64(2), resp.TotalCount) - assert.Equal(t, "Artist Three", resp.Items[0].Name) - assert.Equal(t, "Artist Four", resp.Items[1].Name) + assert.Equal(t, "Artist Three", resp.Items[0].Item.Name) + assert.Equal(t, "Artist Four", resp.Items[1].Item.Name) resp, err = store.GetTopArtistsPaginated(ctx, db.GetItemsOpts{Timeframe: db.Timeframe{Period: db.PeriodYear}}) require.NoError(t, err) require.Len(t, resp.Items, 3) assert.Equal(t, int64(3), resp.TotalCount) - assert.Equal(t, "Artist Two", resp.Items[0].Name) - assert.Equal(t, "Artist Three", resp.Items[1].Name) - assert.Equal(t, "Artist Four", resp.Items[2].Name) + assert.Equal(t, "Artist Two", resp.Items[0].Item.Name) + assert.Equal(t, "Artist Three", resp.Items[1].Item.Name) + assert.Equal(t, "Artist Four", resp.Items[2].Item.Name) // Test specify dates @@ -82,11 +82,11 @@ func TestGetTopArtistsPaginated(t *testing.T) { require.NoError(t, err) require.Len(t, resp.Items, 1) assert.Equal(t, int64(1), resp.TotalCount) - assert.Equal(t, "Artist One", resp.Items[0].Name) + assert.Equal(t, "Artist One", resp.Items[0].Item.Name) resp, err = store.GetTopArtistsPaginated(ctx, db.GetItemsOpts{Timeframe: db.Timeframe{Month: 6, Year: 2024}}) require.NoError(t, err) require.Len(t, resp.Items, 1) assert.Equal(t, int64(1), resp.TotalCount) - assert.Equal(t, "Artist Two", resp.Items[0].Name) + assert.Equal(t, "Artist Two", resp.Items[0].Item.Name) } diff --git a/internal/db/psql/top_tracks.go b/internal/db/psql/top_tracks.go index da34efc..89960e8 100644 --- a/internal/db/psql/top_tracks.go +++ b/internal/db/psql/top_tracks.go @@ -11,14 +11,14 @@ import ( "github.com/gabehf/koito/internal/repository" ) -func (d *Psql) GetTopTracksPaginated(ctx context.Context, opts db.GetItemsOpts) (*db.PaginatedResponse[*models.Track], error) { +func (d *Psql) GetTopTracksPaginated(ctx context.Context, opts db.GetItemsOpts) (*db.PaginatedResponse[db.RankedItem[*models.Track]], error) { l := logger.FromContext(ctx) offset := (opts.Page - 1) * opts.Limit t1, t2 := db.TimeframeToTimeRange(opts.Timeframe) if opts.Limit == 0 { opts.Limit = DefaultItemsPerPage } - var tracks []*models.Track + var tracks []db.RankedItem[*models.Track] var count int64 if opts.AlbumID > 0 { l.Debug().Msgf("Fetching top %d tracks on page %d from range %v to %v", @@ -33,7 +33,7 @@ func (d *Psql) GetTopTracksPaginated(ctx context.Context, opts db.GetItemsOpts) if err != nil { return nil, fmt.Errorf("GetTopTracksPaginated: GetTopTracksInReleasePaginated: %w", err) } - tracks = make([]*models.Track, len(rows)) + tracks = make([]db.RankedItem[*models.Track], len(rows)) for i, row := range rows { artists := make([]models.SimpleArtist, 0) err = json.Unmarshal(row.Artists, &artists) @@ -50,7 +50,8 @@ func (d *Psql) GetTopTracksPaginated(ctx context.Context, opts db.GetItemsOpts) AlbumID: row.ReleaseID, Artists: artists, } - tracks[i] = t + tracks[i].Item = t + tracks[i].Rank = row.Rank } count, err = d.q.CountTopTracksByRelease(ctx, repository.CountTopTracksByReleaseParams{ ListenedAt: t1, @@ -73,7 +74,7 @@ func (d *Psql) GetTopTracksPaginated(ctx context.Context, opts db.GetItemsOpts) if err != nil { return nil, fmt.Errorf("GetTopTracksPaginated: GetTopTracksByArtistPaginated: %w", err) } - tracks = make([]*models.Track, len(rows)) + tracks = make([]db.RankedItem[*models.Track], len(rows)) for i, row := range rows { artists := make([]models.SimpleArtist, 0) err = json.Unmarshal(row.Artists, &artists) @@ -90,7 +91,8 @@ func (d *Psql) GetTopTracksPaginated(ctx context.Context, opts db.GetItemsOpts) AlbumID: row.ReleaseID, Artists: artists, } - tracks[i] = t + tracks[i].Item = t + tracks[i].Rank = row.Rank } count, err = d.q.CountTopTracksByArtist(ctx, repository.CountTopTracksByArtistParams{ ListenedAt: t1, @@ -112,7 +114,7 @@ func (d *Psql) GetTopTracksPaginated(ctx context.Context, opts db.GetItemsOpts) if err != nil { return nil, fmt.Errorf("GetTopTracksPaginated: GetTopTracksPaginated: %w", err) } - tracks = make([]*models.Track, len(rows)) + tracks = make([]db.RankedItem[*models.Track], len(rows)) for i, row := range rows { artists := make([]models.SimpleArtist, 0) err = json.Unmarshal(row.Artists, &artists) @@ -129,7 +131,8 @@ func (d *Psql) GetTopTracksPaginated(ctx context.Context, opts db.GetItemsOpts) AlbumID: row.ReleaseID, Artists: artists, } - tracks[i] = t + tracks[i].Item = t + tracks[i].Rank = row.Rank } count, err = d.q.CountTopTracks(ctx, repository.CountTopTracksParams{ ListenedAt: t1, @@ -141,7 +144,7 @@ func (d *Psql) GetTopTracksPaginated(ctx context.Context, opts db.GetItemsOpts) l.Debug().Msgf("Database responded with %d tracks out of a total %d", len(rows), count) } - return &db.PaginatedResponse[*models.Track]{ + return &db.PaginatedResponse[db.RankedItem[*models.Track]]{ Items: tracks, TotalCount: count, ItemsPerPage: int32(opts.Limit), diff --git a/internal/db/psql/top_tracks_test.go b/internal/db/psql/top_tracks_test.go index 15f898f..934d9b7 100644 --- a/internal/db/psql/top_tracks_test.go +++ b/internal/db/psql/top_tracks_test.go @@ -18,19 +18,19 @@ func TestGetTopTracksPaginated(t *testing.T) { require.NoError(t, err) require.Len(t, resp.Items, 4) assert.Equal(t, int64(4), resp.TotalCount) - assert.Equal(t, "Track One", resp.Items[0].Title) - assert.Equal(t, "Track Two", resp.Items[1].Title) - assert.Equal(t, "Track Three", resp.Items[2].Title) - assert.Equal(t, "Track Four", resp.Items[3].Title) + assert.Equal(t, "Track One", resp.Items[0].Item.Title) + assert.Equal(t, "Track Two", resp.Items[1].Item.Title) + assert.Equal(t, "Track Three", resp.Items[2].Item.Title) + assert.Equal(t, "Track Four", resp.Items[3].Item.Title) // ensure artists are included - require.Len(t, resp.Items[0].Artists, 1) - assert.Equal(t, "Artist One", resp.Items[0].Artists[0].Name) + require.Len(t, resp.Items[0].Item.Artists, 1) + assert.Equal(t, "Artist One", resp.Items[0].Item.Artists[0].Name) // Test pagination resp, err = store.GetTopTracksPaginated(ctx, db.GetItemsOpts{Limit: 1, Page: 2, Timeframe: db.Timeframe{Period: db.PeriodAllTime}}) require.NoError(t, err) require.Len(t, resp.Items, 1) - assert.Equal(t, "Track Two", resp.Items[0].Title) + assert.Equal(t, "Track Two", resp.Items[0].Item.Title) // Test page out of range resp, err = store.GetTopTracksPaginated(ctx, db.GetItemsOpts{Limit: 1, Page: 10, Timeframe: db.Timeframe{Period: db.PeriodAllTime}}) @@ -60,41 +60,41 @@ func TestGetTopTracksPaginated(t *testing.T) { require.NoError(t, err) require.Len(t, resp.Items, 1) assert.Equal(t, int64(1), resp.TotalCount) - assert.Equal(t, "Track Four", resp.Items[0].Title) + assert.Equal(t, "Track Four", resp.Items[0].Item.Title) resp, err = store.GetTopTracksPaginated(ctx, db.GetItemsOpts{Timeframe: db.Timeframe{Period: db.PeriodMonth}}) require.NoError(t, err) require.Len(t, resp.Items, 2) assert.Equal(t, int64(2), resp.TotalCount) - assert.Equal(t, "Track Three", resp.Items[0].Title) - assert.Equal(t, "Track Four", resp.Items[1].Title) + assert.Equal(t, "Track Three", resp.Items[0].Item.Title) + assert.Equal(t, "Track Four", resp.Items[1].Item.Title) resp, err = store.GetTopTracksPaginated(ctx, db.GetItemsOpts{Timeframe: db.Timeframe{Period: db.PeriodYear}}) require.NoError(t, err) require.Len(t, resp.Items, 3) assert.Equal(t, int64(3), resp.TotalCount) - assert.Equal(t, "Track Two", resp.Items[0].Title) - assert.Equal(t, "Track Three", resp.Items[1].Title) - assert.Equal(t, "Track Four", resp.Items[2].Title) + assert.Equal(t, "Track Two", resp.Items[0].Item.Title) + assert.Equal(t, "Track Three", resp.Items[1].Item.Title) + assert.Equal(t, "Track Four", resp.Items[2].Item.Title) // Test filter by artists and releases resp, err = store.GetTopTracksPaginated(ctx, db.GetItemsOpts{Timeframe: db.Timeframe{Period: db.PeriodAllTime}, ArtistID: 1}) require.NoError(t, err) require.Len(t, resp.Items, 1) assert.Equal(t, int64(1), resp.TotalCount) - assert.Equal(t, "Track One", resp.Items[0].Title) + assert.Equal(t, "Track One", resp.Items[0].Item.Title) resp, err = store.GetTopTracksPaginated(ctx, db.GetItemsOpts{Timeframe: db.Timeframe{Period: db.PeriodAllTime}, AlbumID: 2}) require.NoError(t, err) require.Len(t, resp.Items, 1) assert.Equal(t, int64(1), resp.TotalCount) - assert.Equal(t, "Track Two", resp.Items[0].Title) + assert.Equal(t, "Track Two", resp.Items[0].Item.Title) // when both artistID and albumID are specified, artist id is ignored resp, err = store.GetTopTracksPaginated(ctx, db.GetItemsOpts{Timeframe: db.Timeframe{Period: db.PeriodAllTime}, AlbumID: 2, ArtistID: 1}) require.NoError(t, err) require.Len(t, resp.Items, 1) assert.Equal(t, int64(1), resp.TotalCount) - assert.Equal(t, "Track Two", resp.Items[0].Title) + assert.Equal(t, "Track Two", resp.Items[0].Item.Title) // Test specify dates @@ -104,11 +104,11 @@ func TestGetTopTracksPaginated(t *testing.T) { require.NoError(t, err) require.Len(t, resp.Items, 1) assert.Equal(t, int64(1), resp.TotalCount) - assert.Equal(t, "Track One", resp.Items[0].Title) + assert.Equal(t, "Track One", resp.Items[0].Item.Title) resp, err = store.GetTopTracksPaginated(ctx, db.GetItemsOpts{Timeframe: db.Timeframe{Month: 6, Year: 2024}}) require.NoError(t, err) require.Len(t, resp.Items, 1) assert.Equal(t, int64(1), resp.TotalCount) - assert.Equal(t, "Track Two", resp.Items[0].Title) + assert.Equal(t, "Track Two", resp.Items[0].Item.Title) } diff --git a/internal/db/types.go b/internal/db/types.go index 93ff031..46d3c01 100644 --- a/internal/db/types.go +++ b/internal/db/types.go @@ -28,6 +28,11 @@ type PaginatedResponse[T any] struct { CurrentPage int32 `json:"current_page"` } +type RankedItem[T any] struct { + Item T `json:"item"` + Rank int64 `json:"rank"` +} + type ExportItem struct { ListenedAt time.Time UserID int32 diff --git a/internal/repository/artist.sql.go b/internal/repository/artist.sql.go index 3d33446..3722291 100644 --- a/internal/repository/artist.sql.go +++ b/internal/repository/artist.sql.go @@ -269,18 +269,27 @@ func (q *Queries) GetReleaseArtists(ctx context.Context, releaseID int32) ([]Get const getTopArtistsPaginated = `-- name: GetTopArtistsPaginated :many SELECT + x.id, + x.name, + x.musicbrainz_id, + x.image, + x.listen_count, + RANK() OVER (ORDER BY x.listen_count DESC) AS rank +FROM ( + SELECT a.id, a.name, a.musicbrainz_id, a.image, COUNT(*) AS listen_count -FROM listens l -JOIN tracks t ON l.track_id = t.id -JOIN artist_tracks at ON at.track_id = t.id -JOIN artists_with_name a ON a.id = at.artist_id -WHERE l.listened_at BETWEEN $1 AND $2 -GROUP BY a.id, a.name, a.musicbrainz_id, a.image, a.image_source, a.name -ORDER BY listen_count DESC, a.id + FROM listens l + JOIN tracks t ON l.track_id = t.id + JOIN artist_tracks at ON at.track_id = t.id + JOIN artists_with_name a ON a.id = at.artist_id + WHERE l.listened_at BETWEEN $1 AND $2 + GROUP BY a.id, a.name, a.musicbrainz_id, a.image +) x +ORDER BY x.listen_count DESC, x.id LIMIT $3 OFFSET $4 ` @@ -297,6 +306,7 @@ type GetTopArtistsPaginatedRow struct { MusicBrainzID *uuid.UUID Image *uuid.UUID ListenCount int64 + Rank int64 } func (q *Queries) GetTopArtistsPaginated(ctx context.Context, arg GetTopArtistsPaginatedParams) ([]GetTopArtistsPaginatedRow, error) { @@ -319,6 +329,7 @@ func (q *Queries) GetTopArtistsPaginated(ctx context.Context, arg GetTopArtistsP &i.MusicBrainzID, &i.Image, &i.ListenCount, + &i.Rank, ); err != nil { return nil, err } diff --git a/internal/repository/release.sql.go b/internal/repository/release.sql.go index 3d77eef..76789d0 100644 --- a/internal/repository/release.sql.go +++ b/internal/repository/release.sql.go @@ -321,17 +321,22 @@ func (q *Queries) GetReleasesWithoutImages(ctx context.Context, arg GetReleasesW const getTopReleasesFromArtist = `-- name: GetTopReleasesFromArtist :many SELECT - r.id, r.musicbrainz_id, r.image, r.various_artists, r.image_source, r.title, - COUNT(*) AS listen_count, - get_artists_for_release(r.id) AS artists -FROM listens l -JOIN tracks t ON l.track_id = t.id -JOIN releases_with_title r ON t.release_id = r.id -JOIN artist_releases ar ON r.id = ar.release_id -WHERE ar.artist_id = $5 - AND l.listened_at BETWEEN $1 AND $2 -GROUP BY r.id, r.title, r.musicbrainz_id, r.various_artists, r.image, r.image_source -ORDER BY listen_count DESC, r.id + x.id, x.musicbrainz_id, x.image, x.various_artists, x.image_source, x.title, x.listen_count, x.artists, + RANK() OVER (ORDER BY x.listen_count DESC) AS rank +FROM ( + SELECT + r.id, r.musicbrainz_id, r.image, r.various_artists, r.image_source, r.title, + COUNT(*) AS listen_count, + get_artists_for_release(r.id) AS artists + FROM listens l + JOIN tracks t ON l.track_id = t.id + JOIN releases_with_title r ON t.release_id = r.id + JOIN artist_releases ar ON r.id = ar.release_id + WHERE ar.artist_id = $5 + AND l.listened_at BETWEEN $1 AND $2 + GROUP BY r.id, r.title, r.musicbrainz_id, r.various_artists, r.image, r.image_source +) x +ORDER BY listen_count DESC, x.id LIMIT $3 OFFSET $4 ` @@ -352,6 +357,7 @@ type GetTopReleasesFromArtistRow struct { Title string ListenCount int64 Artists []byte + Rank int64 } func (q *Queries) GetTopReleasesFromArtist(ctx context.Context, arg GetTopReleasesFromArtistParams) ([]GetTopReleasesFromArtistRow, error) { @@ -378,6 +384,7 @@ func (q *Queries) GetTopReleasesFromArtist(ctx context.Context, arg GetTopReleas &i.Title, &i.ListenCount, &i.Artists, + &i.Rank, ); err != nil { return nil, err } @@ -391,15 +398,20 @@ func (q *Queries) GetTopReleasesFromArtist(ctx context.Context, arg GetTopReleas const getTopReleasesPaginated = `-- name: GetTopReleasesPaginated :many SELECT - r.id, r.musicbrainz_id, r.image, r.various_artists, r.image_source, r.title, - COUNT(*) AS listen_count, - get_artists_for_release(r.id) AS artists -FROM listens l -JOIN tracks t ON l.track_id = t.id -JOIN releases_with_title r ON t.release_id = r.id -WHERE l.listened_at BETWEEN $1 AND $2 -GROUP BY r.id, r.title, r.musicbrainz_id, r.various_artists, r.image, r.image_source -ORDER BY listen_count DESC, r.id + x.id, x.musicbrainz_id, x.image, x.various_artists, x.image_source, x.title, x.listen_count, x.artists, + RANK() OVER (ORDER BY x.listen_count DESC) AS rank +FROM ( + SELECT + r.id, r.musicbrainz_id, r.image, r.various_artists, r.image_source, r.title, + COUNT(*) AS listen_count, + get_artists_for_release(r.id) AS artists + FROM listens l + JOIN tracks t ON l.track_id = t.id + JOIN releases_with_title r ON t.release_id = r.id + WHERE l.listened_at BETWEEN $1 AND $2 + GROUP BY r.id, r.title, r.musicbrainz_id, r.various_artists, r.image, r.image_source +) x +ORDER BY listen_count DESC, x.id LIMIT $3 OFFSET $4 ` @@ -419,6 +431,7 @@ type GetTopReleasesPaginatedRow struct { Title string ListenCount int64 Artists []byte + Rank int64 } func (q *Queries) GetTopReleasesPaginated(ctx context.Context, arg GetTopReleasesPaginatedParams) ([]GetTopReleasesPaginatedRow, error) { @@ -444,6 +457,7 @@ func (q *Queries) GetTopReleasesPaginated(ctx context.Context, arg GetTopRelease &i.Title, &i.ListenCount, &i.Artists, + &i.Rank, ); err != nil { return nil, err } diff --git a/internal/repository/track.sql.go b/internal/repository/track.sql.go index 6b11b01..a18d87a 100644 --- a/internal/repository/track.sql.go +++ b/internal/repository/track.sql.go @@ -155,21 +155,32 @@ func (q *Queries) GetAllTracksFromArtist(ctx context.Context, artistID int32) ([ const getTopTracksByArtistPaginated = `-- name: GetTopTracksByArtistPaginated :many SELECT - t.id, - t.title, - t.musicbrainz_id, - t.release_id, - r.image, - COUNT(*) AS listen_count, - get_artists_for_track(t.id) AS artists -FROM listens l -JOIN tracks_with_title t ON l.track_id = t.id -JOIN releases r ON t.release_id = r.id -JOIN artist_tracks at ON at.track_id = t.id -WHERE l.listened_at BETWEEN $1 AND $2 - AND at.artist_id = $5 -GROUP BY t.id, t.title, t.musicbrainz_id, t.release_id, r.image -ORDER BY listen_count DESC, t.id + x.id, + x.title, + x.musicbrainz_id, + x.release_id, + x.image, + x.listen_count, + x.artists, + RANK() OVER (ORDER BY x.listen_count DESC) AS rank +FROM ( + SELECT + t.id, + t.title, + t.musicbrainz_id, + t.release_id, + r.image, + COUNT(*) AS listen_count, + get_artists_for_track(t.id) AS artists + FROM listens l + JOIN tracks_with_title t ON l.track_id = t.id + JOIN releases r ON t.release_id = r.id + JOIN artist_tracks at ON at.track_id = t.id + WHERE l.listened_at BETWEEN $1 AND $2 + AND at.artist_id = $5 + GROUP BY t.id, t.title, t.musicbrainz_id, t.release_id, r.image +) x +ORDER BY x.listen_count DESC, x.id LIMIT $3 OFFSET $4 ` @@ -189,6 +200,7 @@ type GetTopTracksByArtistPaginatedRow struct { Image *uuid.UUID ListenCount int64 Artists []byte + Rank int64 } func (q *Queries) GetTopTracksByArtistPaginated(ctx context.Context, arg GetTopTracksByArtistPaginatedParams) ([]GetTopTracksByArtistPaginatedRow, error) { @@ -214,6 +226,7 @@ func (q *Queries) GetTopTracksByArtistPaginated(ctx context.Context, arg GetTopT &i.Image, &i.ListenCount, &i.Artists, + &i.Rank, ); err != nil { return nil, err } @@ -227,20 +240,31 @@ func (q *Queries) GetTopTracksByArtistPaginated(ctx context.Context, arg GetTopT const getTopTracksInReleasePaginated = `-- name: GetTopTracksInReleasePaginated :many SELECT - t.id, - t.title, - t.musicbrainz_id, - t.release_id, - r.image, - COUNT(*) AS listen_count, - get_artists_for_track(t.id) AS artists -FROM listens l -JOIN tracks_with_title t ON l.track_id = t.id -JOIN releases r ON t.release_id = r.id -WHERE l.listened_at BETWEEN $1 AND $2 - AND t.release_id = $5 -GROUP BY t.id, t.title, t.musicbrainz_id, t.release_id, r.image -ORDER BY listen_count DESC, t.id + x.id, + x.title, + x.musicbrainz_id, + x.release_id, + x.image, + x.listen_count, + x.artists, + RANK() OVER (ORDER BY x.listen_count DESC) AS rank +FROM ( + SELECT + t.id, + t.title, + t.musicbrainz_id, + t.release_id, + r.image, + COUNT(*) AS listen_count, + get_artists_for_track(t.id) AS artists + FROM listens l + JOIN tracks_with_title t ON l.track_id = t.id + JOIN releases r ON t.release_id = r.id + WHERE l.listened_at BETWEEN $1 AND $2 + AND t.release_id = $5 + GROUP BY t.id, t.title, t.musicbrainz_id, t.release_id, r.image +) x +ORDER BY x.listen_count DESC, x.id LIMIT $3 OFFSET $4 ` @@ -260,6 +284,7 @@ type GetTopTracksInReleasePaginatedRow struct { Image *uuid.UUID ListenCount int64 Artists []byte + Rank int64 } func (q *Queries) GetTopTracksInReleasePaginated(ctx context.Context, arg GetTopTracksInReleasePaginatedParams) ([]GetTopTracksInReleasePaginatedRow, error) { @@ -285,6 +310,7 @@ func (q *Queries) GetTopTracksInReleasePaginated(ctx context.Context, arg GetTop &i.Image, &i.ListenCount, &i.Artists, + &i.Rank, ); err != nil { return nil, err } @@ -298,19 +324,30 @@ func (q *Queries) GetTopTracksInReleasePaginated(ctx context.Context, arg GetTop const getTopTracksPaginated = `-- name: GetTopTracksPaginated :many SELECT - t.id, - t.title, - t.musicbrainz_id, - t.release_id, - r.image, - COUNT(*) AS listen_count, - get_artists_for_track(t.id) AS artists -FROM listens l -JOIN tracks_with_title t ON l.track_id = t.id -JOIN releases r ON t.release_id = r.id -WHERE l.listened_at BETWEEN $1 AND $2 -GROUP BY t.id, t.title, t.musicbrainz_id, t.release_id, r.image -ORDER BY listen_count DESC, t.id + x.id, + x.title, + x.musicbrainz_id, + x.release_id, + x.image, + x.listen_count, + x.artists, + RANK() OVER (ORDER BY x.listen_count DESC) AS rank +FROM ( + SELECT + t.id, + t.title, + t.musicbrainz_id, + t.release_id, + r.image, + COUNT(*) AS listen_count, + get_artists_for_track(t.id) AS artists + FROM listens l + JOIN tracks_with_title t ON l.track_id = t.id + JOIN releases r ON t.release_id = r.id + WHERE l.listened_at BETWEEN $1 AND $2 + GROUP BY t.id, t.title, t.musicbrainz_id, t.release_id, r.image +) x +ORDER BY x.listen_count DESC, x.id LIMIT $3 OFFSET $4 ` @@ -329,6 +366,7 @@ type GetTopTracksPaginatedRow struct { Image *uuid.UUID ListenCount int64 Artists []byte + Rank int64 } func (q *Queries) GetTopTracksPaginated(ctx context.Context, arg GetTopTracksPaginatedParams) ([]GetTopTracksPaginatedRow, error) { @@ -353,6 +391,7 @@ func (q *Queries) GetTopTracksPaginated(ctx context.Context, arg GetTopTracksPag &i.Image, &i.ListenCount, &i.Artists, + &i.Rank, ); err != nil { return nil, err } diff --git a/internal/summary/summary.go b/internal/summary/summary.go index 518121f..7a2b9d7 100644 --- a/internal/summary/summary.go +++ b/internal/summary/summary.go @@ -9,20 +9,20 @@ import ( ) type Summary struct { - Title string `json:"title,omitempty"` - TopArtists []*models.Artist `json:"top_artists"` // ListenCount and TimeListened are overriden with stats from timeframe - TopAlbums []*models.Album `json:"top_albums"` // ListenCount and TimeListened are overriden with stats from timeframe - TopTracks []*models.Track `json:"top_tracks"` // ListenCount and TimeListened are overriden with stats from timeframe - MinutesListened int `json:"minutes_listened"` - AvgMinutesPerDay int `json:"avg_minutes_listened_per_day"` - Plays int `json:"plays"` - AvgPlaysPerDay float32 `json:"avg_plays_per_day"` - UniqueTracks int `json:"unique_tracks"` - UniqueAlbums int `json:"unique_albums"` - UniqueArtists int `json:"unique_artists"` - NewTracks int `json:"new_tracks"` - NewAlbums int `json:"new_albums"` - NewArtists int `json:"new_artists"` + Title string `json:"title,omitempty"` + TopArtists []db.RankedItem[*models.Artist] `json:"top_artists"` // ListenCount and TimeListened are overriden with stats from timeframe + TopAlbums []db.RankedItem[*models.Album] `json:"top_albums"` // ListenCount and TimeListened are overriden with stats from timeframe + TopTracks []db.RankedItem[*models.Track] `json:"top_tracks"` // ListenCount and TimeListened are overriden with stats from timeframe + MinutesListened int `json:"minutes_listened"` + AvgMinutesPerDay int `json:"avg_minutes_listened_per_day"` + Plays int `json:"plays"` + AvgPlaysPerDay float32 `json:"avg_plays_per_day"` + UniqueTracks int `json:"unique_tracks"` + UniqueAlbums int `json:"unique_albums"` + UniqueArtists int `json:"unique_artists"` + NewTracks int `json:"new_tracks"` + NewAlbums int `json:"new_albums"` + NewArtists int `json:"new_artists"` } func GenerateSummary(ctx context.Context, store db.DB, userId int32, timeframe db.Timeframe, title string) (summary *Summary, err error) { @@ -37,16 +37,16 @@ func GenerateSummary(ctx context.Context, store db.DB, userId int32, timeframe d summary.TopArtists = topArtists.Items // replace ListenCount and TimeListened with stats from timeframe for i, artist := range summary.TopArtists { - timelistened, err := store.CountTimeListenedToItem(ctx, db.TimeListenedOpts{ArtistID: artist.ID, Timeframe: timeframe}) + timelistened, err := store.CountTimeListenedToItem(ctx, db.TimeListenedOpts{ArtistID: artist.Item.ID, Timeframe: timeframe}) if err != nil { return nil, fmt.Errorf("GenerateSummary: %w", err) } - listens, err := store.CountListensToItem(ctx, db.TimeListenedOpts{ArtistID: artist.ID, Timeframe: timeframe}) + listens, err := store.CountListensToItem(ctx, db.TimeListenedOpts{ArtistID: artist.Item.ID, Timeframe: timeframe}) if err != nil { return nil, fmt.Errorf("GenerateSummary: %w", err) } - summary.TopArtists[i].TimeListened = timelistened - summary.TopArtists[i].ListenCount = listens + summary.TopArtists[i].Item.TimeListened = timelistened + summary.TopArtists[i].Item.ListenCount = listens } topAlbums, err := store.GetTopAlbumsPaginated(ctx, db.GetItemsOpts{Page: 1, Limit: 5, Timeframe: timeframe}) @@ -56,16 +56,16 @@ func GenerateSummary(ctx context.Context, store db.DB, userId int32, timeframe d summary.TopAlbums = topAlbums.Items // replace ListenCount and TimeListened with stats from timeframe for i, album := range summary.TopAlbums { - timelistened, err := store.CountTimeListenedToItem(ctx, db.TimeListenedOpts{AlbumID: album.ID, Timeframe: timeframe}) + timelistened, err := store.CountTimeListenedToItem(ctx, db.TimeListenedOpts{AlbumID: album.Item.ID, Timeframe: timeframe}) if err != nil { return nil, fmt.Errorf("GenerateSummary: %w", err) } - listens, err := store.CountListensToItem(ctx, db.TimeListenedOpts{AlbumID: album.ID, Timeframe: timeframe}) + listens, err := store.CountListensToItem(ctx, db.TimeListenedOpts{AlbumID: album.Item.ID, Timeframe: timeframe}) if err != nil { return nil, fmt.Errorf("GenerateSummary: %w", err) } - summary.TopAlbums[i].TimeListened = timelistened - summary.TopAlbums[i].ListenCount = listens + summary.TopAlbums[i].Item.TimeListened = timelistened + summary.TopAlbums[i].Item.ListenCount = listens } topTracks, err := store.GetTopTracksPaginated(ctx, db.GetItemsOpts{Page: 1, Limit: 5, Timeframe: timeframe}) @@ -75,16 +75,16 @@ func GenerateSummary(ctx context.Context, store db.DB, userId int32, timeframe d summary.TopTracks = topTracks.Items // replace ListenCount and TimeListened with stats from timeframe for i, track := range summary.TopTracks { - timelistened, err := store.CountTimeListenedToItem(ctx, db.TimeListenedOpts{TrackID: track.ID, Timeframe: timeframe}) + timelistened, err := store.CountTimeListenedToItem(ctx, db.TimeListenedOpts{TrackID: track.Item.ID, Timeframe: timeframe}) if err != nil { return nil, fmt.Errorf("GenerateSummary: %w", err) } - listens, err := store.CountListensToItem(ctx, db.TimeListenedOpts{TrackID: track.ID, Timeframe: timeframe}) + listens, err := store.CountListensToItem(ctx, db.TimeListenedOpts{TrackID: track.Item.ID, Timeframe: timeframe}) if err != nil { return nil, fmt.Errorf("GenerateSummary: %w", err) } - summary.TopTracks[i].TimeListened = timelistened - summary.TopTracks[i].ListenCount = listens + summary.TopTracks[i].Item.TimeListened = timelistened + summary.TopTracks[i].Item.ListenCount = listens } t1, t2 := db.TimeframeToTimeRange(timeframe) From c0de721a7cee0506f9b44cd2193019b038fcdaf6 Mon Sep 17 00:00:00 2001 From: Gabe Farrell Date: Thu, 15 Jan 2026 21:27:46 -0500 Subject: [PATCH 18/37] chore: ignore README for docker workflow --- .github/workflows/docker.yml | 1 + 1 file changed, 1 insertion(+) diff --git a/.github/workflows/docker.yml b/.github/workflows/docker.yml index 95d893e..466a4f6 100644 --- a/.github/workflows/docker.yml +++ b/.github/workflows/docker.yml @@ -17,6 +17,7 @@ on: - main paths-ignore: - "docs/**" + - "README.md" workflow_dispatch: From d08e05220f7a092810d7ebaeb8374e334f9cae62 Mon Sep 17 00:00:00 2001 From: Gabe Farrell Date: Thu, 15 Jan 2026 22:01:25 -0500 Subject: [PATCH 19/37] docs: add disclaimer about subsonic config --- docs/src/content/docs/reference/configuration.md | 4 ++++ 1 file changed, 4 insertions(+) diff --git a/docs/src/content/docs/reference/configuration.md b/docs/src/content/docs/reference/configuration.md index 4e806a0..67c4a2b 100644 --- a/docs/src/content/docs/reference/configuration.md +++ b/docs/src/content/docs/reference/configuration.md @@ -78,6 +78,10 @@ If the environment variable is defined without **and** with the suffix at the sa ##### KOITO_SUBSONIC_PARAMS - Required: `true` if KOITO_SUBSONIC_URL is set - Description: The `u`, `t`, and `s` authentication parameters to use for authenticated requests to your subsonic server, in the format `u=XXX&t=XXX&s=XXX`. An easy way to find them is to open the network tab in the developer tools of your browser of choice and copy them from a request. +:::caution +If Koito is unable to validate your Subsonic configuration, it will fail to start. If you notice your container isn't running after +changing these parameters, check the logs! +::: ##### KOITO_SKIP_IMPORT - Default: `false` - Description: Skips running the importer on startup. From 5e294b839c9aa5a936b0dda256d5f9b8b3123e02 Mon Sep 17 00:00:00 2001 From: Gabe Farrell <90876006+gabehf@users.noreply.github.com> Date: Fri, 16 Jan 2026 01:03:23 -0500 Subject: [PATCH 20/37] feat: all time rank display (#149) * add all time rank to item pages * fix artist albums component * add no rows check * fix rewind page --- client/api/api.ts | 9 +- client/app/components/ArtistAlbums.tsx | 18 ++- client/app/components/rewind/Rewind.tsx | 6 +- .../app/components/rewind/RewindTopItem.tsx | 18 ++- client/app/routes/MediaItems/Album.tsx | 1 + client/app/routes/MediaItems/Artist.tsx | 1 + client/app/routes/MediaItems/MediaLayout.tsx | 11 +- client/app/routes/MediaItems/Track.tsx | 1 + db/queries/artist.sql | 20 +++ db/queries/release.sql | 19 +++ db/queries/track.sql | 18 +++ internal/db/psql/album.go | 64 ++++---- internal/db/psql/artist.go | 138 ++++++------------ internal/db/psql/track.go | 73 ++++----- internal/models/album.go | 8 +- internal/models/artist.go | 1 + internal/models/track.go | 1 + internal/repository/artist.sql.go | 33 +++++ internal/repository/release.sql.go | 32 ++++ internal/repository/track.sql.go | 31 ++++ 20 files changed, 301 insertions(+), 202 deletions(-) diff --git a/client/api/api.ts b/client/api/api.ts index ff69b78..bd2430b 100644 --- a/client/api/api.ts +++ b/client/api/api.ts @@ -367,6 +367,7 @@ type Track = { musicbrainz_id: string; time_listened: number; first_listen: number; + all_time_rank: number; }; type Artist = { id: number; @@ -378,6 +379,7 @@ type Artist = { time_listened: number; first_listen: number; is_primary: boolean; + all_time_rank: number; }; type Album = { id: number; @@ -389,6 +391,7 @@ type Album = { musicbrainz_id: string; time_listened: number; first_listen: number; + all_time_rank: number; }; type Alias = { id: number; @@ -459,9 +462,9 @@ type NowPlaying = { }; type RewindStats = { title: string; - top_artists: Artist[]; - top_albums: Album[]; - top_tracks: Track[]; + top_artists: Ranked[]; + top_albums: Ranked[]; + top_tracks: Ranked[]; minutes_listened: number; avg_minutes_listened_per_day: number; plays: number; diff --git a/client/app/components/ArtistAlbums.tsx b/client/app/components/ArtistAlbums.tsx index 922b5ce..dda7de8 100644 --- a/client/app/components/ArtistAlbums.tsx +++ b/client/app/components/ArtistAlbums.tsx @@ -8,11 +8,11 @@ interface Props { period: string; } -export default function ArtistAlbums({ artistId, name, period }: Props) { +export default function ArtistAlbums({ artistId, name }: Props) { const { isPending, isError, data, error } = useQuery({ queryKey: [ "top-albums", - { limit: 99, period: "all_time", artist_id: artistId, page: 0 }, + { limit: 99, period: "all_time", artist_id: artistId }, ], queryFn: ({ queryKey }) => getTopAlbums(queryKey[1] as getItemsArgs), }); @@ -39,16 +39,20 @@ export default function ArtistAlbums({ artistId, name, period }: Props) {

Albums featuring {name}

{data.items.map((item) => ( - + {item.title}
-

{item.title}

+

{item.item.title}

- {item.listen_count} play{item.listen_count > 1 ? "s" : ""} + {item.item.listen_count} play + {item.item.listen_count > 1 ? "s" : ""}

diff --git a/client/app/components/rewind/Rewind.tsx b/client/app/components/rewind/Rewind.tsx index 2553b35..a22fe15 100644 --- a/client/app/components/rewind/Rewind.tsx +++ b/client/app/components/rewind/Rewind.tsx @@ -8,9 +8,9 @@ interface Props { } export default function Rewind(props: Props) { - const artistimg = props.stats.top_artists[0]?.image; - const albumimg = props.stats.top_albums[0]?.image; - const trackimg = props.stats.top_tracks[0]?.image; + const artistimg = props.stats.top_artists[0]?.item.image; + const albumimg = props.stats.top_albums[0]?.item.image; + const trackimg = props.stats.top_tracks[0]?.item.image; if ( !props.stats.top_artists[0] || !props.stats.top_albums[0] || diff --git a/client/app/components/rewind/RewindTopItem.tsx b/client/app/components/rewind/RewindTopItem.tsx index ffbe488..5093768 100644 --- a/client/app/components/rewind/RewindTopItem.tsx +++ b/client/app/components/rewind/RewindTopItem.tsx @@ -1,7 +1,9 @@ +import type { Ranked } from "api/api"; + type TopItemProps = { title: string; imageSrc: string; - items: T[]; + items: Ranked[]; getLabel: (item: T) => string; includeTime?: boolean; }; @@ -28,23 +30,23 @@ export function RewindTopItem<
-

{getLabel(top)}

+

{getLabel(top.item)}

- {`${top.listen_count} plays`} + {`${top.item.listen_count} plays`} {includeTime - ? ` (${Math.floor(top.time_listened / 60)} minutes)` + ? ` (${Math.floor(top.item.time_listened / 60)} minutes)` : ``}
{rest.map((e) => ( -
- {getLabel(e)} +
+ {getLabel(e.item)} - {` - ${e.listen_count} plays`} + {` - ${e.item.listen_count} plays`} {includeTime - ? ` (${Math.floor(e.time_listened / 60)} minutes)` + ? ` (${Math.floor(e.item.time_listened / 60)} minutes)` : ``}
diff --git a/client/app/routes/MediaItems/Album.tsx b/client/app/routes/MediaItems/Album.tsx index 0de544a..e6f413e 100644 --- a/client/app/routes/MediaItems/Album.tsx +++ b/client/app/routes/MediaItems/Album.tsx @@ -30,6 +30,7 @@ export default function Album() { title={album.title} img={album.image} id={album.id} + rank={album.all_time_rank} musicbrainzId={album.musicbrainz_id} imgItemId={album.id} mergeFunc={mergeAlbums} diff --git a/client/app/routes/MediaItems/Artist.tsx b/client/app/routes/MediaItems/Artist.tsx index f2600be..a23e4cd 100644 --- a/client/app/routes/MediaItems/Artist.tsx +++ b/client/app/routes/MediaItems/Artist.tsx @@ -36,6 +36,7 @@ export default function Artist() { title={artist.name} img={artist.image} id={artist.id} + rank={artist.all_time_rank} musicbrainzId={artist.musicbrainz_id} imgItemId={artist.id} mergeFunc={mergeArtists} diff --git a/client/app/routes/MediaItems/MediaLayout.tsx b/client/app/routes/MediaItems/MediaLayout.tsx index c675fc6..eaf100b 100644 --- a/client/app/routes/MediaItems/MediaLayout.tsx +++ b/client/app/routes/MediaItems/MediaLayout.tsx @@ -28,6 +28,7 @@ interface Props { title: string; img: string; id: number; + rank: number; musicbrainzId: string; imgItemId: number; mergeFunc: MergeFunc; @@ -96,7 +97,15 @@ export default function MediaLayout(props: Props) {

{props.type}

-

{props.title}

+
+

+ {props.title} + + {" "} + #{props.rank} + +

+
{props.subContent}
diff --git a/client/app/routes/MediaItems/Track.tsx b/client/app/routes/MediaItems/Track.tsx index 20258c1..6b6690e 100644 --- a/client/app/routes/MediaItems/Track.tsx +++ b/client/app/routes/MediaItems/Track.tsx @@ -34,6 +34,7 @@ export default function Track() { title={track.title} img={track.image} id={track.id} + rank={track.all_time_rank} musicbrainzId={track.musicbrainz_id} imgItemId={track.album_id} mergeFunc={mergeTracks} diff --git a/db/queries/artist.sql b/db/queries/artist.sql index 863de32..deaad60 100644 --- a/db/queries/artist.sql +++ b/db/queries/artist.sql @@ -81,6 +81,26 @@ FROM ( ORDER BY x.listen_count DESC, x.id LIMIT $3 OFFSET $4; +-- name: GetArtistAllTimeRank :one +SELECT + artist_id, + rank +FROM ( + SELECT + x.artist_id, + RANK() OVER (ORDER BY x.listen_count DESC) AS rank + FROM ( + SELECT + at.artist_id, + COUNT(*) AS listen_count + FROM listens l + JOIN tracks t ON l.track_id = t.id + JOIN artist_tracks at ON t.id = at.track_id + GROUP BY at.artist_id + ) x + ) +WHERE artist_id = $1; + -- name: CountTopArtists :one SELECT COUNT(DISTINCT at.artist_id) AS total_count FROM listens l diff --git a/db/queries/release.sql b/db/queries/release.sql index cb548ed..47aac86 100644 --- a/db/queries/release.sql +++ b/db/queries/release.sql @@ -83,6 +83,25 @@ FROM ( ORDER BY listen_count DESC, x.id LIMIT $3 OFFSET $4; +-- name: GetReleaseAllTimeRank :one +SELECT + release_id, + rank +FROM ( + SELECT + x.release_id, + RANK() OVER (ORDER BY x.listen_count DESC) AS rank + FROM ( + SELECT + t.release_id, + COUNT(*) AS listen_count + FROM listens l + JOIN tracks t ON l.track_id = t.id + GROUP BY t.release_id + ) x + ) +WHERE release_id = $1; + -- name: CountTopReleases :one SELECT COUNT(DISTINCT r.id) AS total_count FROM listens l diff --git a/db/queries/track.sql b/db/queries/track.sql index 24be467..c69bed5 100644 --- a/db/queries/track.sql +++ b/db/queries/track.sql @@ -124,6 +124,24 @@ FROM ( ORDER BY x.listen_count DESC, x.id LIMIT $3 OFFSET $4; +-- name: GetTrackAllTimeRank :one +SELECT + id, + rank +FROM ( + SELECT + x.id, + RANK() OVER (ORDER BY x.listen_count DESC) AS rank + FROM ( + SELECT + t.id, + COUNT(*) AS listen_count + FROM listens l + JOIN tracks_with_title t ON l.track_id = t.id + GROUP BY t.id) x + ) y +WHERE id = $1; + -- name: CountTopTracks :one SELECT COUNT(DISTINCT l.track_id) AS total_count FROM listens l diff --git a/internal/db/psql/album.go b/internal/db/psql/album.go index 630cf1f..f4c614c 100644 --- a/internal/db/psql/album.go +++ b/internal/db/psql/album.go @@ -23,32 +23,13 @@ func (d *Psql) GetAlbum(ctx context.Context, opts db.GetAlbumOpts) (*models.Albu var err error var ret = new(models.Album) - if opts.ID != 0 { - l.Debug().Msgf("Fetching album from DB with id %d", opts.ID) - row, err := d.q.GetRelease(ctx, opts.ID) - if err != nil { - return nil, fmt.Errorf("GetAlbum: %w", err) - } - ret.ID = row.ID - ret.MbzID = row.MusicBrainzID - ret.Title = row.Title - ret.Image = row.Image - ret.VariousArtists = row.VariousArtists - err = json.Unmarshal(row.Artists, &ret.Artists) - if err != nil { - return nil, fmt.Errorf("GetAlbum: json.Unmarshal: %w", err) - } - } else if opts.MusicBrainzID != uuid.Nil { + if opts.MusicBrainzID != uuid.Nil { l.Debug().Msgf("Fetching album from DB with MusicBrainz Release ID %s", opts.MusicBrainzID) row, err := d.q.GetReleaseByMbzID(ctx, &opts.MusicBrainzID) if err != nil { return nil, fmt.Errorf("GetAlbum: %w", err) } - ret.ID = row.ID - ret.MbzID = row.MusicBrainzID - ret.Title = row.Title - ret.Image = row.Image - ret.VariousArtists = row.VariousArtists + opts.ID = row.ID } else if opts.ArtistID != 0 && opts.Title != "" { l.Debug().Msgf("Fetching album from DB with artist_id %d and title %s", opts.ArtistID, opts.Title) row, err := d.q.GetReleaseByArtistAndTitle(ctx, repository.GetReleaseByArtistAndTitleParams{ @@ -58,11 +39,7 @@ func (d *Psql) GetAlbum(ctx context.Context, opts db.GetAlbumOpts) (*models.Albu if err != nil { return nil, fmt.Errorf("GetAlbum: %w", err) } - ret.ID = row.ID - ret.MbzID = row.MusicBrainzID - ret.Title = row.Title - ret.Image = row.Image - ret.VariousArtists = row.VariousArtists + opts.ID = row.ID } else if opts.ArtistID != 0 && len(opts.Titles) > 0 { l.Debug().Msgf("Fetching release group from DB with artist_id %d and titles %v", opts.ArtistID, opts.Titles) row, err := d.q.GetReleaseByArtistAndTitles(ctx, repository.GetReleaseByArtistAndTitlesParams{ @@ -72,19 +49,19 @@ func (d *Psql) GetAlbum(ctx context.Context, opts db.GetAlbumOpts) (*models.Albu if err != nil { return nil, fmt.Errorf("GetAlbum: %w", err) } - ret.ID = row.ID - ret.MbzID = row.MusicBrainzID - ret.Title = row.Title - ret.Image = row.Image - ret.VariousArtists = row.VariousArtists - } else { - return nil, errors.New("GetAlbum: insufficient information to get album") + opts.ID = row.ID + } + + l.Debug().Msgf("Fetching album from DB with id %d", opts.ID) + row, err := d.q.GetRelease(ctx, opts.ID) + if err != nil { + return nil, fmt.Errorf("GetAlbum: %w", err) } count, err := d.q.CountListensFromRelease(ctx, repository.CountListensFromReleaseParams{ ListenedAt: time.Unix(0, 0), ListenedAt_2: time.Now(), - ReleaseID: ret.ID, + ReleaseID: opts.ID, }) if err != nil { return nil, fmt.Errorf("GetAlbum: CountListensFromRelease: %w", err) @@ -92,17 +69,32 @@ func (d *Psql) GetAlbum(ctx context.Context, opts db.GetAlbumOpts) (*models.Albu seconds, err := d.CountTimeListenedToItem(ctx, db.TimeListenedOpts{ Timeframe: db.Timeframe{Period: db.PeriodAllTime}, - AlbumID: ret.ID, + AlbumID: opts.ID, }) if err != nil { return nil, fmt.Errorf("GetAlbum: CountTimeListenedToItem: %w", err) } - firstListen, err := d.q.GetFirstListenFromRelease(ctx, ret.ID) + firstListen, err := d.q.GetFirstListenFromRelease(ctx, opts.ID) if err != nil && !errors.Is(err, pgx.ErrNoRows) { return nil, fmt.Errorf("GetAlbum: GetFirstListenFromRelease: %w", err) } + rank, err := d.q.GetReleaseAllTimeRank(ctx, opts.ID) + if err != nil && !errors.Is(err, pgx.ErrNoRows) { + return nil, fmt.Errorf("GetAlbum: GetReleaseAllTimeRank: %w", err) + } + + ret.ID = row.ID + ret.MbzID = row.MusicBrainzID + ret.Title = row.Title + ret.Image = row.Image + ret.VariousArtists = row.VariousArtists + err = json.Unmarshal(row.Artists, &ret.Artists) + if err != nil { + return nil, fmt.Errorf("GetAlbum: json.Unmarshal: %w", err) + } + ret.AllTimeRank = rank.Rank ret.ListenCount = count ret.TimeListened = seconds ret.FirstListen = firstListen.ListenedAt.Unix() diff --git a/internal/db/psql/artist.go b/internal/db/psql/artist.go index a67fc4c..7bb50ec 100644 --- a/internal/db/psql/artist.go +++ b/internal/db/psql/artist.go @@ -20,114 +20,60 @@ import ( // this function sucks because sqlc keeps making new types for rows that are the same func (d *Psql) GetArtist(ctx context.Context, opts db.GetArtistOpts) (*models.Artist, error) { l := logger.FromContext(ctx) - if opts.ID != 0 { - l.Debug().Msgf("Fetching artist from DB with id %d", opts.ID) - row, err := d.q.GetArtist(ctx, opts.ID) - if err != nil { - return nil, fmt.Errorf("GetArtist: GetArtist by ID: %w", err) - } - count, err := d.q.CountListensFromArtist(ctx, repository.CountListensFromArtistParams{ - ListenedAt: time.Unix(0, 0), - ListenedAt_2: time.Now(), - ArtistID: row.ID, - }) - if err != nil { - return nil, fmt.Errorf("GetArtist: CountListensFromArtist: %w", err) - } - seconds, err := d.CountTimeListenedToItem(ctx, db.TimeListenedOpts{ - Timeframe: db.Timeframe{Period: db.PeriodAllTime}, - ArtistID: row.ID, - }) - if err != nil { - return nil, fmt.Errorf("GetArtist: CountTimeListenedToItem: %w", err) - } - firstListen, err := d.q.GetFirstListenFromArtist(ctx, row.ID) - if err != nil && !errors.Is(err, pgx.ErrNoRows) { - return nil, fmt.Errorf("GetAlbum: GetFirstListenFromArtist: %w", err) - } - return &models.Artist{ - ID: row.ID, - MbzID: row.MusicBrainzID, - Name: row.Name, - Aliases: row.Aliases, - Image: row.Image, - ListenCount: count, - TimeListened: seconds, - FirstListen: firstListen.ListenedAt.Unix(), - }, nil - } else if opts.MusicBrainzID != uuid.Nil { + if opts.MusicBrainzID != uuid.Nil { l.Debug().Msgf("Fetching artist from DB with MusicBrainz ID %s", opts.MusicBrainzID) row, err := d.q.GetArtistByMbzID(ctx, &opts.MusicBrainzID) if err != nil { return nil, fmt.Errorf("GetArtist: GetArtistByMbzID: %w", err) } - count, err := d.q.CountListensFromArtist(ctx, repository.CountListensFromArtistParams{ - ListenedAt: time.Unix(0, 0), - ListenedAt_2: time.Now(), - ArtistID: row.ID, - }) - if err != nil { - return nil, fmt.Errorf("GetArtist: CountListensFromArtist: %w", err) - } - seconds, err := d.CountTimeListenedToItem(ctx, db.TimeListenedOpts{ - Timeframe: db.Timeframe{Period: db.PeriodAllTime}, - ArtistID: row.ID, - }) - if err != nil { - return nil, fmt.Errorf("GetArtist: CountTimeListenedToItem: %w", err) - } - firstListen, err := d.q.GetFirstListenFromArtist(ctx, row.ID) - if err != nil && !errors.Is(err, pgx.ErrNoRows) { - return nil, fmt.Errorf("GetAlbum: GetFirstListenFromArtist: %w", err) - } - return &models.Artist{ - ID: row.ID, - MbzID: row.MusicBrainzID, - Name: row.Name, - Aliases: row.Aliases, - Image: row.Image, - ListenCount: count, - TimeListened: seconds, - FirstListen: firstListen.ListenedAt.Unix(), - }, nil + opts.ID = row.ID } else if opts.Name != "" { l.Debug().Msgf("Fetching artist from DB with name '%s'", opts.Name) row, err := d.q.GetArtistByName(ctx, opts.Name) if err != nil { return nil, fmt.Errorf("GetArtist: GetArtistByName: %w", err) } - count, err := d.q.CountListensFromArtist(ctx, repository.CountListensFromArtistParams{ - ListenedAt: time.Unix(0, 0), - ListenedAt_2: time.Now(), - ArtistID: row.ID, - }) - if err != nil { - return nil, fmt.Errorf("GetArtist: CountListensFromArtist: %w", err) - } - seconds, err := d.CountTimeListenedToItem(ctx, db.TimeListenedOpts{ - Timeframe: db.Timeframe{Period: db.PeriodAllTime}, - ArtistID: row.ID, - }) - if err != nil { - return nil, fmt.Errorf("GetArtist: CountTimeListenedToItem: %w", err) - } - firstListen, err := d.q.GetFirstListenFromArtist(ctx, row.ID) - if err != nil && !errors.Is(err, pgx.ErrNoRows) { - return nil, fmt.Errorf("GetAlbum: GetFirstListenFromArtist: %w", err) - } - return &models.Artist{ - ID: row.ID, - MbzID: row.MusicBrainzID, - Name: row.Name, - Aliases: row.Aliases, - Image: row.Image, - ListenCount: count, - TimeListened: seconds, - FirstListen: firstListen.ListenedAt.Unix(), - }, nil - } else { - return nil, errors.New("insufficient information to get artist") + opts.ID = row.ID } + l.Debug().Msgf("Fetching artist from DB with id %d", opts.ID) + row, err := d.q.GetArtist(ctx, opts.ID) + if err != nil { + return nil, fmt.Errorf("GetArtist: GetArtist by ID: %w", err) + } + count, err := d.q.CountListensFromArtist(ctx, repository.CountListensFromArtistParams{ + ListenedAt: time.Unix(0, 0), + ListenedAt_2: time.Now(), + ArtistID: row.ID, + }) + if err != nil { + return nil, fmt.Errorf("GetArtist: CountListensFromArtist: %w", err) + } + seconds, err := d.CountTimeListenedToItem(ctx, db.TimeListenedOpts{ + Timeframe: db.Timeframe{Period: db.PeriodAllTime}, + ArtistID: row.ID, + }) + if err != nil { + return nil, fmt.Errorf("GetArtist: CountTimeListenedToItem: %w", err) + } + firstListen, err := d.q.GetFirstListenFromArtist(ctx, row.ID) + if err != nil && !errors.Is(err, pgx.ErrNoRows) { + return nil, fmt.Errorf("GetAlbum: GetFirstListenFromArtist: %w", err) + } + rank, err := d.q.GetArtistAllTimeRank(ctx, opts.ID) + if err != nil && !errors.Is(err, pgx.ErrNoRows) { + return nil, fmt.Errorf("GetArtist: GetArtistAllTimeRank: %w", err) + } + return &models.Artist{ + ID: row.ID, + MbzID: row.MusicBrainzID, + Name: row.Name, + Aliases: row.Aliases, + Image: row.Image, + ListenCount: count, + TimeListened: seconds, + AllTimeRank: rank.Rank, + FirstListen: firstListen.ListenedAt.Unix(), + }, nil } // Inserts all unique aliases into the DB with specified source diff --git a/internal/db/psql/track.go b/internal/db/psql/track.go index d511de6..743a20e 100644 --- a/internal/db/psql/track.go +++ b/internal/db/psql/track.go @@ -21,37 +21,13 @@ func (d *Psql) GetTrack(ctx context.Context, opts db.GetTrackOpts) (*models.Trac l := logger.FromContext(ctx) var track models.Track - if opts.ID != 0 { - l.Debug().Msgf("Fetching track from DB with id %d", opts.ID) - t, err := d.q.GetTrack(ctx, opts.ID) - if err != nil { - return nil, fmt.Errorf("GetTrack: GetTrack By ID: %w", err) - } - track = models.Track{ - ID: t.ID, - MbzID: t.MusicBrainzID, - Title: t.Title, - AlbumID: t.ReleaseID, - Image: t.Image, - Duration: t.Duration, - } - err = json.Unmarshal(t.Artists, &track.Artists) - if err != nil { - return nil, fmt.Errorf("GetTrack: json.Unmarshal: %w", err) - } - } else if opts.MusicBrainzID != uuid.Nil { + if opts.MusicBrainzID != uuid.Nil { l.Debug().Msgf("Fetching track from DB with MusicBrainz ID %s", opts.MusicBrainzID) t, err := d.q.GetTrackByMbzID(ctx, &opts.MusicBrainzID) if err != nil { return nil, fmt.Errorf("GetTrack: GetTrackByMbzID: %w", err) } - track = models.Track{ - ID: t.ID, - MbzID: t.MusicBrainzID, - Title: t.Title, - AlbumID: t.ReleaseID, - Duration: t.Duration, - } + opts.ID = t.ID } else if len(opts.ArtistIDs) > 0 && opts.ReleaseID != 0 { l.Debug().Msgf("Fetching track from DB from release id %d with title '%s' and artist id(s) '%v'", opts.ReleaseID, opts.Title, opts.ArtistIDs) t, err := d.q.GetTrackByTrackInfo(ctx, repository.GetTrackByTrackInfoParams{ @@ -62,21 +38,19 @@ func (d *Psql) GetTrack(ctx context.Context, opts db.GetTrackOpts) (*models.Trac if err != nil { return nil, fmt.Errorf("GetTrack: GetTrackByTrackInfo: %w", err) } - track = models.Track{ - ID: t.ID, - MbzID: t.MusicBrainzID, - Title: t.Title, - AlbumID: t.ReleaseID, - Duration: t.Duration, - } - } else { - return nil, errors.New("GetTrack: insufficient information to get track") + opts.ID = t.ID + } + + l.Debug().Msgf("Fetching track from DB with id %d", opts.ID) + t, err := d.q.GetTrack(ctx, opts.ID) + if err != nil { + return nil, fmt.Errorf("GetTrack: GetTrack By ID: %w", err) } count, err := d.q.CountListensFromTrack(ctx, repository.CountListensFromTrackParams{ ListenedAt: time.Unix(0, 0), ListenedAt_2: time.Now(), - TrackID: track.ID, + TrackID: opts.ID, }) if err != nil { return nil, fmt.Errorf("GetTrack: CountListensFromTrack: %w", err) @@ -84,20 +58,37 @@ func (d *Psql) GetTrack(ctx context.Context, opts db.GetTrackOpts) (*models.Trac seconds, err := d.CountTimeListenedToItem(ctx, db.TimeListenedOpts{ Timeframe: db.Timeframe{Period: db.PeriodAllTime}, - TrackID: track.ID, + TrackID: opts.ID, }) if err != nil { return nil, fmt.Errorf("GetTrack: CountTimeListenedToItem: %w", err) } - firstListen, err := d.q.GetFirstListenFromTrack(ctx, track.ID) + firstListen, err := d.q.GetFirstListenFromTrack(ctx, opts.ID) if err != nil && !errors.Is(err, pgx.ErrNoRows) { return nil, fmt.Errorf("GetAlbum: GetFirstListenFromRelease: %w", err) } + rank, err := d.q.GetTrackAllTimeRank(ctx, opts.ID) + if err != nil && !errors.Is(err, pgx.ErrNoRows) { + return nil, fmt.Errorf("GetAlbum: GetTrackAllTimeRank: %w", err) + } - track.ListenCount = count - track.TimeListened = seconds - track.FirstListen = firstListen.ListenedAt.Unix() + track = models.Track{ + ID: t.ID, + MbzID: t.MusicBrainzID, + Title: t.Title, + AlbumID: t.ReleaseID, + Image: t.Image, + Duration: t.Duration, + AllTimeRank: rank.Rank, + ListenCount: count, + TimeListened: seconds, + FirstListen: firstListen.ListenedAt.Unix(), + } + err = json.Unmarshal(t.Artists, &track.Artists) + if err != nil { + return nil, fmt.Errorf("GetTrack: json.Unmarshal: %w", err) + } return &track, nil } diff --git a/internal/models/album.go b/internal/models/album.go index 24948f9..a295fe9 100644 --- a/internal/models/album.go +++ b/internal/models/album.go @@ -12,11 +12,5 @@ type Album struct { ListenCount int64 `json:"listen_count"` TimeListened int64 `json:"time_listened"` FirstListen int64 `json:"first_listen"` + AllTimeRank int64 `json:"all_time_rank"` } - -// type SimpleAlbum struct { -// ID int32 `json:"id"` -// Title string `json:"title"` -// VariousArtists bool `json:"is_various_artists"` -// Image uuid.UUID `json:"image"` -// } diff --git a/internal/models/artist.go b/internal/models/artist.go index 7784e51..07f09e6 100644 --- a/internal/models/artist.go +++ b/internal/models/artist.go @@ -12,6 +12,7 @@ type Artist struct { TimeListened int64 `json:"time_listened"` FirstListen int64 `json:"first_listen"` IsPrimary bool `json:"is_primary,omitempty"` + AllTimeRank int64 `json:"all_time_rank"` } type SimpleArtist struct { diff --git a/internal/models/track.go b/internal/models/track.go index 8eb802c..4cb5b04 100644 --- a/internal/models/track.go +++ b/internal/models/track.go @@ -13,4 +13,5 @@ type Track struct { AlbumID int32 `json:"album_id"` TimeListened int64 `json:"time_listened"` FirstListen int64 `json:"first_listen"` + AllTimeRank int64 `json:"all_time_rank"` } diff --git a/internal/repository/artist.sql.go b/internal/repository/artist.sql.go index 3722291..96f00f2 100644 --- a/internal/repository/artist.sql.go +++ b/internal/repository/artist.sql.go @@ -134,6 +134,39 @@ func (q *Queries) GetArtist(ctx context.Context, id int32) (GetArtistRow, error) return i, err } +const getArtistAllTimeRank = `-- name: GetArtistAllTimeRank :one +SELECT + artist_id, + rank +FROM ( + SELECT + x.artist_id, + RANK() OVER (ORDER BY x.listen_count DESC) AS rank + FROM ( + SELECT + at.artist_id, + COUNT(*) AS listen_count + FROM listens l + JOIN tracks t ON l.track_id = t.id + JOIN artist_tracks at ON t.id = at.track_id + GROUP BY at.artist_id + ) x + ) +WHERE artist_id = $1 +` + +type GetArtistAllTimeRankRow struct { + ArtistID int32 + Rank int64 +} + +func (q *Queries) GetArtistAllTimeRank(ctx context.Context, artistID int32) (GetArtistAllTimeRankRow, error) { + row := q.db.QueryRow(ctx, getArtistAllTimeRank, artistID) + var i GetArtistAllTimeRankRow + err := row.Scan(&i.ArtistID, &i.Rank) + return i, err +} + const getArtistByImage = `-- name: GetArtistByImage :one SELECT id, musicbrainz_id, image, image_source FROM artists WHERE image = $1 LIMIT 1 ` diff --git a/internal/repository/release.sql.go b/internal/repository/release.sql.go index 76789d0..6d12da4 100644 --- a/internal/repository/release.sql.go +++ b/internal/repository/release.sql.go @@ -141,6 +141,38 @@ func (q *Queries) GetRelease(ctx context.Context, id int32) (GetReleaseRow, erro return i, err } +const getReleaseAllTimeRank = `-- name: GetReleaseAllTimeRank :one +SELECT + release_id, + rank +FROM ( + SELECT + x.release_id, + RANK() OVER (ORDER BY x.listen_count DESC) AS rank + FROM ( + SELECT + t.release_id, + COUNT(*) AS listen_count + FROM listens l + JOIN tracks t ON l.track_id = t.id + GROUP BY t.release_id + ) x + ) +WHERE release_id = $1 +` + +type GetReleaseAllTimeRankRow struct { + ReleaseID int32 + Rank int64 +} + +func (q *Queries) GetReleaseAllTimeRank(ctx context.Context, releaseID int32) (GetReleaseAllTimeRankRow, error) { + row := q.db.QueryRow(ctx, getReleaseAllTimeRank, releaseID) + var i GetReleaseAllTimeRankRow + err := row.Scan(&i.ReleaseID, &i.Rank) + return i, err +} + const getReleaseByArtistAndTitle = `-- name: GetReleaseByArtistAndTitle :one SELECT r.id, r.musicbrainz_id, r.image, r.various_artists, r.image_source, r.title FROM releases_with_title r diff --git a/internal/repository/track.sql.go b/internal/repository/track.sql.go index a18d87a..e2aa084 100644 --- a/internal/repository/track.sql.go +++ b/internal/repository/track.sql.go @@ -438,6 +438,37 @@ func (q *Queries) GetTrack(ctx context.Context, id int32) (GetTrackRow, error) { return i, err } +const getTrackAllTimeRank = `-- name: GetTrackAllTimeRank :one +SELECT + id, + rank +FROM ( + SELECT + x.id, + RANK() OVER (ORDER BY x.listen_count DESC) AS rank + FROM ( + SELECT + t.id, + COUNT(*) AS listen_count + FROM listens l + JOIN tracks_with_title t ON l.track_id = t.id + GROUP BY t.id) x + ) y +WHERE id = $1 +` + +type GetTrackAllTimeRankRow struct { + ID int32 + Rank int64 +} + +func (q *Queries) GetTrackAllTimeRank(ctx context.Context, id int32) (GetTrackAllTimeRankRow, error) { + row := q.db.QueryRow(ctx, getTrackAllTimeRank, id) + var i GetTrackAllTimeRankRow + err := row.Scan(&i.ID, &i.Rank) + return i, err +} + const getTrackByMbzID = `-- name: GetTrackByMbzID :one SELECT id, musicbrainz_id, duration, release_id, title FROM tracks_with_title WHERE musicbrainz_id = $1 LIMIT 1 From 1a8099e902298f2b9aeef38f07164a338c4e06a9 Mon Sep 17 00:00:00 2001 From: Gabe Farrell <90876006+gabehf@users.noreply.github.com> Date: Tue, 20 Jan 2026 12:10:54 -0500 Subject: [PATCH 21/37] feat: refetch missing images on startup (#160) * artist image refetching * album image refetching * remove unused var --- .env.example | 5 + .gitignore | 1 + Makefile | 9 +- db/queries/artist.sql | 9 ++ engine/engine.go | 14 ++- engine/handlers/replace_image.go | 3 +- internal/catalog/images.go | 147 +++++++++++++++++++++++++----- internal/db/db.go | 2 + internal/db/psql/album.go | 3 + internal/db/psql/artist.go | 3 + internal/db/psql/images.go | 23 +++++ internal/images/deezer.go | 3 + internal/images/imagesrc.go | 46 +++++++--- internal/images/subsonic.go | 6 +- internal/repository/artist.sql.go | 41 +++++++++ 15 files changed, 271 insertions(+), 44 deletions(-) create mode 100644 .env.example diff --git a/.env.example b/.env.example new file mode 100644 index 0000000..d5ed451 --- /dev/null +++ b/.env.example @@ -0,0 +1,5 @@ +KOITO_ALLOWED_HOSTS=* +KOITO_LOG_LEVEL=debug +KOITO_CONFIG_DIR=test_config_dir +KOITO_DATABASE_URL=postgres://postgres:secret@localhost:5432?sslmode=disable +TZ=Etc/UTC diff --git a/.gitignore b/.gitignore index bade026..083bb78 100644 --- a/.gitignore +++ b/.gitignore @@ -1 +1,2 @@ test_config_dir +.env diff --git a/Makefile b/Makefile index b437622..99455ac 100644 --- a/Makefile +++ b/Makefile @@ -1,3 +1,8 @@ +ifneq (,$(wildcard ./.env)) + include .env + export +endif + .PHONY: all test clean client postgres.schemadump: @@ -28,10 +33,10 @@ postgres.remove-scratch: docker stop koito-scratch && docker rm koito-scratch api.debug: postgres.start - KOITO_ALLOWED_HOSTS=* KOITO_LOG_LEVEL=debug KOITO_CONFIG_DIR=test_config_dir KOITO_DATABASE_URL=postgres://postgres:secret@localhost:5432?sslmode=disable go run cmd/api/main.go + go run cmd/api/main.go api.scratch: postgres.run-scratch - KOITO_ALLOWED_HOSTS=* KOITO_LOG_LEVEL=debug KOITO_CONFIG_DIR=test_config_dir/scratch KOITO_DATABASE_URL=postgres://postgres:secret@localhost:5433?sslmode=disable go run cmd/api/main.go + KOITO_DATABASE_URL=postgres://postgres:secret@localhost:5433?sslmode=disable go run cmd/api/main.go api.test: go test ./... -timeout 60s diff --git a/db/queries/artist.sql b/db/queries/artist.sql index deaad60..70a2fdd 100644 --- a/db/queries/artist.sql +++ b/db/queries/artist.sql @@ -56,6 +56,15 @@ LEFT JOIN artist_aliases aa ON a.id = aa.artist_id WHERE a.musicbrainz_id = $1 GROUP BY a.id, a.musicbrainz_id, a.image, a.image_source, a.name; +-- name: GetArtistsWithoutImages :many +SELECT + * +FROM artists_with_name +WHERE image IS NULL + AND id > $2 +ORDER BY id ASC +LIMIT $1; + -- name: GetTopArtistsPaginated :many SELECT x.id, diff --git a/engine/engine.go b/engine/engine.go index 31fe552..9374819 100644 --- a/engine/engine.go +++ b/engine/engine.go @@ -211,6 +211,8 @@ func Run( } }() + l.Info().Msg("Engine: Beginning startup tasks...") + l.Debug().Msg("Engine: Checking import configuration") if !cfg.SkipImport() { go func() { @@ -218,18 +220,14 @@ func Run( }() } - // l.Info().Msg("Creating test export file") - // go func() { - // err := export.ExportData(ctx, "koito", store) - // if err != nil { - // l.Err(err).Msg("Failed to generate export file") - // } - // }() - l.Info().Msg("Engine: Pruning orphaned images") go catalog.PruneOrphanedImages(logger.NewContext(l), store) l.Info().Msg("Engine: Running duration backfill task") go catalog.BackfillTrackDurationsFromMusicBrainz(ctx, store, mbzC) + l.Info().Msg("Engine: Attempting to fetch missing artist images") + go catalog.FetchMissingArtistImages(ctx, store) + l.Info().Msg("Engine: Attempting to fetch missing album images") + go catalog.FetchMissingAlbumImages(ctx, store) l.Info().Msg("Engine: Initialization finished") quit := make(chan os.Signal, 1) diff --git a/engine/handlers/replace_image.go b/engine/handlers/replace_image.go index 66c0bbe..9a2835d 100644 --- a/engine/handlers/replace_image.go +++ b/engine/handlers/replace_image.go @@ -9,6 +9,7 @@ import ( "github.com/gabehf/koito/internal/catalog" "github.com/gabehf/koito/internal/cfg" "github.com/gabehf/koito/internal/db" + "github.com/gabehf/koito/internal/images" "github.com/gabehf/koito/internal/logger" "github.com/gabehf/koito/internal/utils" "github.com/google/uuid" @@ -75,7 +76,7 @@ func ReplaceImageHandler(store db.DB) http.HandlerFunc { fileUrl := r.FormValue("image_url") if fileUrl != "" { l.Debug().Msg("ReplaceImageHandler: Image identified as remote file") - err = catalog.ValidateImageURL(fileUrl) + err = images.ValidateImageURL(fileUrl) if err != nil { l.Debug().AnErr("error", err).Msg("ReplaceImageHandler: Invalid image URL") utils.WriteError(w, "url is invalid or not an image file", http.StatusBadRequest) diff --git a/internal/catalog/images.go b/internal/catalog/images.go index bf5aa26..4193a39 100644 --- a/internal/catalog/images.go +++ b/internal/catalog/images.go @@ -13,7 +13,9 @@ import ( "github.com/gabehf/koito/internal/cfg" "github.com/gabehf/koito/internal/db" + "github.com/gabehf/koito/internal/images" "github.com/gabehf/koito/internal/logger" + "github.com/gabehf/koito/internal/utils" "github.com/google/uuid" "github.com/h2non/bimg" ) @@ -78,30 +80,10 @@ func SourceImageDir() string { } } -// ValidateImageURL checks if the URL points to a valid image by performing a HEAD request. -func ValidateImageURL(url string) error { - resp, err := http.Head(url) - if err != nil { - return fmt.Errorf("ValidateImageURL: http.Head: %w", err) - } - defer resp.Body.Close() - - if resp.StatusCode != http.StatusOK { - return fmt.Errorf("ValidateImageURL: HEAD request failed, status code: %d", resp.StatusCode) - } - - contentType := resp.Header.Get("Content-Type") - if !strings.HasPrefix(contentType, "image/") { - return fmt.Errorf("ValidateImageURL: URL does not point to an image, content type: %s", contentType) - } - - return nil -} - // DownloadAndCacheImage downloads an image from the given URL, then calls CompressAndSaveImage. func DownloadAndCacheImage(ctx context.Context, id uuid.UUID, url string, size ImageSize) error { l := logger.FromContext(ctx) - err := ValidateImageURL(url) + err := images.ValidateImageURL(url) if err != nil { return fmt.Errorf("DownloadAndCacheImage: %w", err) } @@ -285,3 +267,126 @@ func pruneDirImgs(ctx context.Context, store db.DB, path string, memo map[string } return count, nil } + +func FetchMissingArtistImages(ctx context.Context, store db.DB) error { + l := logger.FromContext(ctx) + l.Info().Msg("FetchMissingArtistImages: Starting backfill of missing artist images") + + var from int32 = 0 + + for { + l.Debug().Int32("ID", from).Msg("Fetching artist images to backfill from ID") + artists, err := store.ArtistsWithoutImages(ctx, from) + if err != nil { + return fmt.Errorf("FetchMissingArtistImages: failed to fetch artists for image backfill: %w", err) + } + + if len(artists) == 0 { + if from == 0 { + l.Info().Msg("FetchMissingArtistImages: No artists with missing images found") + } else { + l.Info().Msg("FetchMissingArtistImages: Finished fetching missing artist images") + } + return nil + } + + for _, artist := range artists { + from = artist.ID + + l.Debug(). + Str("title", artist.Name). + Msg("FetchMissingArtistImages: Attempting to fetch missing artist image") + + var aliases []string + if aliasrow, err := store.GetAllArtistAliases(ctx, artist.ID); err != nil { + aliases = utils.FlattenAliases(aliasrow) + } else { + aliases = []string{artist.Name} + } + + var imgid uuid.UUID + imgUrl, imgErr := images.GetArtistImage(ctx, images.ArtistImageOpts{ + Aliases: aliases, + }) + if imgErr == nil && imgUrl != "" { + imgid = uuid.New() + err = store.UpdateArtist(ctx, db.UpdateArtistOpts{ + ID: artist.ID, + Image: imgid, + ImageSrc: imgUrl, + }) + if err != nil { + l.Err(err). + Str("title", artist.Name). + Msg("FetchMissingArtistImages: Failed to update artist with image in database") + continue + } + l.Info(). + Str("name", artist.Name). + Msg("FetchMissingArtistImages: Successfully fetched missing artist image") + } else { + l.Err(err). + Str("name", artist.Name). + Msg("FetchMissingArtistImages: Failed to fetch artist image") + } + } + } +} +func FetchMissingAlbumImages(ctx context.Context, store db.DB) error { + l := logger.FromContext(ctx) + l.Info().Msg("FetchMissingAlbumImages: Starting backfill of missing album images") + + var from int32 = 0 + + for { + l.Debug().Int32("ID", from).Msg("Fetching album images to backfill from ID") + albums, err := store.AlbumsWithoutImages(ctx, from) + if err != nil { + return fmt.Errorf("FetchMissingAlbumImages: failed to fetch albums for image backfill: %w", err) + } + + if len(albums) == 0 { + if from == 0 { + l.Info().Msg("FetchMissingAlbumImages: No albums with missing images found") + } else { + l.Info().Msg("FetchMissingAlbumImages: Finished fetching missing album images") + } + return nil + } + + for _, album := range albums { + from = album.ID + + l.Debug(). + Str("title", album.Title). + Msg("FetchMissingAlbumImages: Attempting to fetch missing album image") + + var imgid uuid.UUID + imgUrl, imgErr := images.GetAlbumImage(ctx, images.AlbumImageOpts{ + Artists: utils.FlattenSimpleArtistNames(album.Artists), + Album: album.Title, + }) + if imgErr == nil && imgUrl != "" { + imgid = uuid.New() + err = store.UpdateAlbum(ctx, db.UpdateAlbumOpts{ + ID: album.ID, + Image: imgid, + ImageSrc: imgUrl, + }) + if err != nil { + l.Err(err). + Str("title", album.Title). + Msg("FetchMissingAlbumImages: Failed to update album with image in database") + continue + } + l.Info(). + Str("name", album.Title). + Msg("FetchMissingAlbumImages: Successfully fetched missing album image") + } else { + l.Err(err). + Str("name", album.Title). + Msg("FetchMissingAlbumImages: Failed to fetch album image") + } + } + } +} diff --git a/internal/db/db.go b/internal/db/db.go index a0f0f80..97badac 100644 --- a/internal/db/db.go +++ b/internal/db/db.go @@ -88,6 +88,7 @@ type DB interface { // in seconds CountTimeListenedToItem(ctx context.Context, opts TimeListenedOpts) (int64, error) CountUsers(ctx context.Context) (int64, error) + // Search SearchArtists(ctx context.Context, q string) ([]*models.Artist, error) @@ -105,6 +106,7 @@ type DB interface { ImageHasAssociation(ctx context.Context, image uuid.UUID) (bool, error) GetImageSource(ctx context.Context, image uuid.UUID) (string, error) AlbumsWithoutImages(ctx context.Context, from int32) ([]*models.Album, error) + ArtistsWithoutImages(ctx context.Context, from int32) ([]*models.Artist, error) GetExportPage(ctx context.Context, opts GetExportPageOpts) ([]*ExportItem, error) Ping(ctx context.Context) error Close(ctx context.Context) diff --git a/internal/db/psql/album.go b/internal/db/psql/album.go index f4c614c..758c287 100644 --- a/internal/db/psql/album.go +++ b/internal/db/psql/album.go @@ -274,6 +274,9 @@ func (d *Psql) UpdateAlbum(ctx context.Context, opts db.UpdateAlbumOpts) error { } } if opts.Image != uuid.Nil { + if opts.ImageSrc == "" { + return fmt.Errorf("UpdateAlbum: image source must be provided when updating an image") + } l.Debug().Msgf("Updating release with ID %d with image %s", opts.ID, opts.Image) err := qtx.UpdateReleaseImage(ctx, repository.UpdateReleaseImageParams{ ID: opts.ID, diff --git a/internal/db/psql/artist.go b/internal/db/psql/artist.go index 7bb50ec..859a490 100644 --- a/internal/db/psql/artist.go +++ b/internal/db/psql/artist.go @@ -210,6 +210,9 @@ func (d *Psql) UpdateArtist(ctx context.Context, opts db.UpdateArtistOpts) error } } if opts.Image != uuid.Nil { + if opts.ImageSrc == "" { + return fmt.Errorf("UpdateAlbum: image source must be provided when updating an image") + } l.Debug().Msgf("Updating artist with id %d with image %s", opts.ID, opts.Image) err = qtx.UpdateArtistImage(ctx, repository.UpdateArtistImageParams{ ID: opts.ID, diff --git a/internal/db/psql/images.go b/internal/db/psql/images.go index 49e2850..eef0d8f 100644 --- a/internal/db/psql/images.go +++ b/internal/db/psql/images.go @@ -72,3 +72,26 @@ func (d *Psql) AlbumsWithoutImages(ctx context.Context, from int32) ([]*models.A } return albums, nil } + +// returns nil, nil on no results +func (d *Psql) ArtistsWithoutImages(ctx context.Context, from int32) ([]*models.Artist, error) { + rows, err := d.q.GetArtistsWithoutImages(ctx, repository.GetArtistsWithoutImagesParams{ + Limit: 20, + ID: from, + }) + if errors.Is(err, pgx.ErrNoRows) { + return nil, nil + } else if err != nil { + return nil, fmt.Errorf("ArtistsWithoutImages: %w", err) + } + + ret := make([]*models.Artist, len(rows)) + for i, row := range rows { + ret[i] = &models.Artist{ + ID: row.ID, + Name: row.Name, + MbzID: row.MusicBrainzID, + } + } + return ret, nil +} diff --git a/internal/images/deezer.go b/internal/images/deezer.go index 8fb7b27..2ced676 100644 --- a/internal/images/deezer.go +++ b/internal/images/deezer.go @@ -110,6 +110,9 @@ func (c *DeezerClient) getEntity(ctx context.Context, endpoint string, result an return nil } +// Deezer behavior is that it serves a default image when it can't find one for an artist, so +// this function will just download the default image thinking that it is an actual artist image. +// I don't know how to fix this yet. func (c *DeezerClient) GetArtistImages(ctx context.Context, aliases []string) (string, error) { l := logger.FromContext(ctx) resp := new(DeezerArtistResponse) diff --git a/internal/images/imagesrc.go b/internal/images/imagesrc.go index 21eec65..b49e9dd 100644 --- a/internal/images/imagesrc.go +++ b/internal/images/imagesrc.go @@ -5,6 +5,7 @@ import ( "context" "fmt" "net/http" + "strings" "sync" "github.com/gabehf/koito/internal/logger" @@ -67,19 +68,23 @@ func GetArtistImage(ctx context.Context, opts ArtistImageOpts) (string, error) { if imgsrc.subsonicEnabled { img, err := imgsrc.subsonicC.GetArtistImage(ctx, opts.Aliases[0]) if err != nil { - return "", err - } - if img != "" { + l.Debug().Err(err).Msg("GetArtistImage: Could not find artist image from Subsonic") + } else if img != "" { return img, nil } - l.Debug().Msg("Could not find artist image from Subsonic") + } else { + l.Debug().Msg("GetArtistImage: Subsonic image fetching is disabled") } - if imgsrc.deezerC != nil { + if imgsrc.deezerEnabled { img, err := imgsrc.deezerC.GetArtistImages(ctx, opts.Aliases) if err != nil { + l.Debug().Err(err).Msg("GetArtistImage: Could not find artist image from Deezer") return "", err + } else if img != "" { + return img, nil } - return img, nil + } else { + l.Debug().Msg("GetArtistImage: Deezer image fetching is disabled") } l.Warn().Msg("GetArtistImage: No image providers are enabled") return "", nil @@ -89,7 +94,7 @@ func GetAlbumImage(ctx context.Context, opts AlbumImageOpts) (string, error) { if imgsrc.subsonicEnabled { img, err := imgsrc.subsonicC.GetAlbumImage(ctx, opts.Artists[0], opts.Album) if err != nil { - return "", err + l.Debug().Err(err).Msg("GetAlbumImage: Could not find artist image from Subsonic") } if img != "" { return img, nil @@ -102,29 +107,28 @@ func GetAlbumImage(ctx context.Context, opts AlbumImageOpts) (string, error) { url := fmt.Sprintf(caaBaseUrl+"/release/%s/front", opts.ReleaseMbzID.String()) resp, err := http.DefaultClient.Head(url) if err != nil { - return "", err + l.Debug().Err(err).Msg("GetAlbumImage: Could not find artist image from CoverArtArchive with Release MBID") } if resp.StatusCode == 200 { return url, nil } - l.Debug().Str("url", url).Str("status", resp.Status).Msg("Could not find album cover from CoverArtArchive with MusicBrainz release ID") } if opts.ReleaseGroupMbzID != nil && *opts.ReleaseGroupMbzID != uuid.Nil { url := fmt.Sprintf(caaBaseUrl+"/release-group/%s/front", opts.ReleaseGroupMbzID.String()) resp, err := http.DefaultClient.Head(url) if err != nil { - return "", err + l.Debug().Err(err).Msg("GetAlbumImage: Could not find artist image from CoverArtArchive with Release Group MBID") } if resp.StatusCode == 200 { return url, nil } - l.Debug().Str("url", url).Str("status", resp.Status).Msg("Could not find album cover from CoverArtArchive with MusicBrainz release group ID") } } if imgsrc.deezerEnabled { l.Debug().Msg("Attempting to find album image from Deezer") img, err := imgsrc.deezerC.GetAlbumImages(ctx, opts.Artists, opts.Album) if err != nil { + l.Debug().Err(err).Msg("GetAlbumImage: Could not find artist image from Deezer") return "", err } return img, nil @@ -132,3 +136,23 @@ func GetAlbumImage(ctx context.Context, opts AlbumImageOpts) (string, error) { l.Warn().Msg("GetAlbumImage: No image providers are enabled") return "", nil } + +// ValidateImageURL checks if the URL points to a valid image by performing a HEAD request. +func ValidateImageURL(url string) error { + resp, err := http.Head(url) + if err != nil { + return fmt.Errorf("ValidateImageURL: http.Head: %w", err) + } + defer resp.Body.Close() + + if resp.StatusCode != http.StatusOK { + return fmt.Errorf("ValidateImageURL: HEAD request failed, status code: %d", resp.StatusCode) + } + + contentType := resp.Header.Get("Content-Type") + if !strings.HasPrefix(contentType, "image/") { + return fmt.Errorf("ValidateImageURL: URL does not point to an image, content type: %s", contentType) + } + + return nil +} diff --git a/internal/images/subsonic.go b/internal/images/subsonic.go index 961b4c2..6241b09 100644 --- a/internal/images/subsonic.go +++ b/internal/images/subsonic.go @@ -129,9 +129,13 @@ func (c *SubsonicClient) GetArtistImage(ctx context.Context, artist string) (str if err != nil { return "", fmt.Errorf("GetArtistImage: %v", err) } - l.Debug().Any("subsonic_response", resp).Send() + l.Debug().Any("subsonic_response", resp).Msg("") if len(resp.SubsonicResponse.SearchResult3.Artist) < 1 || resp.SubsonicResponse.SearchResult3.Artist[0].ArtistImageUrl == "" { return "", fmt.Errorf("GetArtistImage: failed to get artist art") } + // Subsonic seems to have a tendency to return an artist image even though the url is a 404 + if err = ValidateImageURL(resp.SubsonicResponse.SearchResult3.Artist[0].ArtistImageUrl); err != nil { + return "", fmt.Errorf("GetArtistImage: failed to get validate image url") + } return resp.SubsonicResponse.SearchResult3.Artist[0].ArtistImageUrl, nil } diff --git a/internal/repository/artist.sql.go b/internal/repository/artist.sql.go index 96f00f2..8506975 100644 --- a/internal/repository/artist.sql.go +++ b/internal/repository/artist.sql.go @@ -254,6 +254,47 @@ func (q *Queries) GetArtistByName(ctx context.Context, alias string) (GetArtistB return i, err } +const getArtistsWithoutImages = `-- name: GetArtistsWithoutImages :many +SELECT + id, musicbrainz_id, image, image_source, name +FROM artists_with_name +WHERE image IS NULL + AND id > $2 +ORDER BY id ASC +LIMIT $1 +` + +type GetArtistsWithoutImagesParams struct { + Limit int32 + ID int32 +} + +func (q *Queries) GetArtistsWithoutImages(ctx context.Context, arg GetArtistsWithoutImagesParams) ([]ArtistsWithName, error) { + rows, err := q.db.Query(ctx, getArtistsWithoutImages, arg.Limit, arg.ID) + if err != nil { + return nil, err + } + defer rows.Close() + var items []ArtistsWithName + for rows.Next() { + var i ArtistsWithName + if err := rows.Scan( + &i.ID, + &i.MusicBrainzID, + &i.Image, + &i.ImageSource, + &i.Name, + ); err != nil { + return nil, err + } + items = append(items, i) + } + if err := rows.Err(); err != nil { + return nil, err + } + return items, nil +} + const getReleaseArtists = `-- name: GetReleaseArtists :many SELECT a.id, a.musicbrainz_id, a.image, a.image_source, a.name, From 56ac73d12b4a92d55a3be23099a8ce538ec89346 Mon Sep 17 00:00:00 2001 From: Gabe Farrell <90876006+gabehf@users.noreply.github.com> Date: Wed, 21 Jan 2026 14:54:52 -0500 Subject: [PATCH 22/37] fix: improve subsonic image searching (#164) --- internal/catalog/images.go | 5 ++-- internal/images/imagesrc.go | 5 ++-- internal/images/subsonic.go | 55 +++++++++++++++++++++++++++++++------ 3 files changed, 53 insertions(+), 12 deletions(-) diff --git a/internal/catalog/images.go b/internal/catalog/images.go index 4193a39..72b6efd 100644 --- a/internal/catalog/images.go +++ b/internal/catalog/images.go @@ -363,8 +363,9 @@ func FetchMissingAlbumImages(ctx context.Context, store db.DB) error { var imgid uuid.UUID imgUrl, imgErr := images.GetAlbumImage(ctx, images.AlbumImageOpts{ - Artists: utils.FlattenSimpleArtistNames(album.Artists), - Album: album.Title, + Artists: utils.FlattenSimpleArtistNames(album.Artists), + Album: album.Title, + ReleaseMbzID: album.MbzID, }) if imgErr == nil && imgUrl != "" { imgid = uuid.New() diff --git a/internal/images/imagesrc.go b/internal/images/imagesrc.go index b49e9dd..717b862 100644 --- a/internal/images/imagesrc.go +++ b/internal/images/imagesrc.go @@ -31,6 +31,7 @@ var imgsrc ImageSource type ArtistImageOpts struct { Aliases []string + MBID *uuid.UUID } type AlbumImageOpts struct { @@ -66,7 +67,7 @@ func Shutdown() { func GetArtistImage(ctx context.Context, opts ArtistImageOpts) (string, error) { l := logger.FromContext(ctx) if imgsrc.subsonicEnabled { - img, err := imgsrc.subsonicC.GetArtistImage(ctx, opts.Aliases[0]) + img, err := imgsrc.subsonicC.GetArtistImage(ctx, opts.MBID, opts.Aliases[0]) if err != nil { l.Debug().Err(err).Msg("GetArtistImage: Could not find artist image from Subsonic") } else if img != "" { @@ -92,7 +93,7 @@ func GetArtistImage(ctx context.Context, opts ArtistImageOpts) (string, error) { func GetAlbumImage(ctx context.Context, opts AlbumImageOpts) (string, error) { l := logger.FromContext(ctx) if imgsrc.subsonicEnabled { - img, err := imgsrc.subsonicC.GetAlbumImage(ctx, opts.Artists[0], opts.Album) + img, err := imgsrc.subsonicC.GetAlbumImage(ctx, opts.ReleaseMbzID, opts.Artists[0], opts.Album) if err != nil { l.Debug().Err(err).Msg("GetAlbumImage: Could not find artist image from Subsonic") } diff --git a/internal/images/subsonic.go b/internal/images/subsonic.go index 6241b09..4fd55c0 100644 --- a/internal/images/subsonic.go +++ b/internal/images/subsonic.go @@ -11,6 +11,7 @@ import ( "github.com/gabehf/koito/internal/cfg" "github.com/gabehf/koito/internal/logger" "github.com/gabehf/koito/queue" + "github.com/google/uuid" ) type SubsonicClient struct { @@ -26,6 +27,8 @@ type SubsonicAlbumResponse struct { SearchResult3 struct { Album []struct { CoverArt string `json:"coverArt"` + Artist string `json:"artist"` + MBID string `json:"musicBrainzId"` } `json:"album"` } `json:"searchResult3"` } `json:"subsonic-response"` @@ -43,7 +46,7 @@ type SubsonicArtistResponse struct { } const ( - subsonicAlbumSearchFmtStr = "/rest/search3?%s&f=json&query=%s&v=1.13.0&c=koito&artistCount=0&songCount=0&albumCount=1" + subsonicAlbumSearchFmtStr = "/rest/search3?%s&f=json&query=%s&v=1.13.0&c=koito&artistCount=0&songCount=0&albumCount=10" subsonicArtistSearchFmtStr = "/rest/search3?%s&f=json&query=%s&v=1.13.0&c=koito&artistCount=1&songCount=0&albumCount=0" subsonicCoverArtFmtStr = "/rest/getCoverArt?%s&id=%s&v=1.13.0&c=koito" ) @@ -106,25 +109,61 @@ func (c *SubsonicClient) getEntity(ctx context.Context, endpoint string, result return nil } -func (c *SubsonicClient) GetAlbumImage(ctx context.Context, artist, album string) (string, error) { +func (c *SubsonicClient) GetAlbumImage(ctx context.Context, mbid *uuid.UUID, artist, album string) (string, error) { l := logger.FromContext(ctx) resp := new(SubsonicAlbumResponse) l.Debug().Msgf("Finding album image for %s from artist %s", album, artist) - err := c.getEntity(ctx, fmt.Sprintf(subsonicAlbumSearchFmtStr, c.authParams, url.QueryEscape(artist+" "+album)), resp) + // first try mbid search + if mbid != nil { + l.Debug().Str("mbid", mbid.String()).Msg("Searching album image by MBID") + err := c.getEntity(ctx, fmt.Sprintf(subsonicAlbumSearchFmtStr, c.authParams, url.QueryEscape(mbid.String())), resp) + if err != nil { + return "", fmt.Errorf("GetAlbumImage: %v", err) + } + l.Debug().Any("subsonic_response", resp).Msg("") + if len(resp.SubsonicResponse.SearchResult3.Album) >= 1 { + return cfg.SubsonicUrl() + fmt.Sprintf(subsonicCoverArtFmtStr, c.authParams, url.QueryEscape(resp.SubsonicResponse.SearchResult3.Album[0].CoverArt)), nil + } + } + // else do artist match + l.Debug().Str("title", album).Str("artist", artist).Msg("Searching album image by title and artist") + err := c.getEntity(ctx, fmt.Sprintf(subsonicAlbumSearchFmtStr, c.authParams, url.QueryEscape(album)), resp) if err != nil { return "", fmt.Errorf("GetAlbumImage: %v", err) } - l.Debug().Any("subsonic_response", resp).Send() - if len(resp.SubsonicResponse.SearchResult3.Album) < 1 || resp.SubsonicResponse.SearchResult3.Album[0].CoverArt == "" { - return "", fmt.Errorf("GetAlbumImage: failed to get album art") + l.Debug().Any("subsonic_response", resp).Msg("") + if len(resp.SubsonicResponse.SearchResult3.Album) < 1 { + return "", fmt.Errorf("GetAlbumImage: failed to get album art from subsonic") } - return cfg.SubsonicUrl() + fmt.Sprintf(subsonicCoverArtFmtStr, c.authParams, url.QueryEscape(resp.SubsonicResponse.SearchResult3.Album[0].CoverArt)), nil + for _, album := range resp.SubsonicResponse.SearchResult3.Album { + if album.Artist == artist { + return cfg.SubsonicUrl() + fmt.Sprintf(subsonicCoverArtFmtStr, c.authParams, url.QueryEscape(resp.SubsonicResponse.SearchResult3.Album[0].CoverArt)), nil + } + } + return "", fmt.Errorf("GetAlbumImage: failed to get album art from subsonic") } -func (c *SubsonicClient) GetArtistImage(ctx context.Context, artist string) (string, error) { +func (c *SubsonicClient) GetArtistImage(ctx context.Context, mbid *uuid.UUID, artist string) (string, error) { l := logger.FromContext(ctx) resp := new(SubsonicArtistResponse) l.Debug().Msgf("Finding artist image for %s", artist) + // first try mbid search + if mbid != nil { + l.Debug().Str("mbid", mbid.String()).Msg("Searching artist image by MBID") + err := c.getEntity(ctx, fmt.Sprintf(subsonicArtistSearchFmtStr, c.authParams, url.QueryEscape(mbid.String())), resp) + if err != nil { + return "", fmt.Errorf("GetArtistImage: %v", err) + } + l.Debug().Any("subsonic_response", resp).Msg("") + if len(resp.SubsonicResponse.SearchResult3.Artist) < 1 || resp.SubsonicResponse.SearchResult3.Artist[0].ArtistImageUrl == "" { + return "", fmt.Errorf("GetArtistImage: failed to get artist art") + } + // Subsonic seems to have a tendency to return an artist image even though the url is a 404 + if err = ValidateImageURL(resp.SubsonicResponse.SearchResult3.Artist[0].ArtistImageUrl); err != nil { + return "", fmt.Errorf("GetArtistImage: failed to get validate image url") + } + } + l.Debug().Str("artist", artist).Msg("Searching artist image by name") err := c.getEntity(ctx, fmt.Sprintf(subsonicArtistSearchFmtStr, c.authParams, url.QueryEscape(artist)), resp) if err != nil { return "", fmt.Errorf("GetArtistImage: %v", err) From e7ba34710cf598c3cf9920a7d0671738f6616c09 Mon Sep 17 00:00:00 2001 From: Gabe Farrell <90876006+gabehf@users.noreply.github.com> Date: Wed, 21 Jan 2026 16:03:05 -0500 Subject: [PATCH 23/37] feat: lastfm image support (#166) * feat: lastfm image support * docs --- .../content/docs/reference/configuration.md | 3 + engine/engine.go | 1 + internal/cfg/cfg.go | 9 + internal/images/imagesrc.go | 37 ++- internal/images/lastfm.go | 298 ++++++++++++++++++ 5 files changed, 345 insertions(+), 3 deletions(-) create mode 100644 internal/images/lastfm.go diff --git a/docs/src/content/docs/reference/configuration.md b/docs/src/content/docs/reference/configuration.md index 67c4a2b..6eae82b 100644 --- a/docs/src/content/docs/reference/configuration.md +++ b/docs/src/content/docs/reference/configuration.md @@ -82,6 +82,9 @@ If the environment variable is defined without **and** with the suffix at the sa If Koito is unable to validate your Subsonic configuration, it will fail to start. If you notice your container isn't running after changing these parameters, check the logs! ::: +##### KOITO_LASTFM_API_KEY +- Required: `false` +- Description: Your LastFM API key, which will be used for fetching images if provided. You can get an API key [here](https://www.last.fm/api/authentication), ##### KOITO_SKIP_IMPORT - Default: `false` - Description: Skips running the importer on startup. diff --git a/engine/engine.go b/engine/engine.go index 9374819..7de9254 100644 --- a/engine/engine.go +++ b/engine/engine.go @@ -138,6 +138,7 @@ func Run( EnableCAA: !cfg.CoverArtArchiveDisabled(), EnableDeezer: !cfg.DeezerDisabled(), EnableSubsonic: cfg.SubsonicEnabled(), + EnableLastFM: cfg.LastFMApiKey() != "", }) l.Info().Msg("Engine: Image sources initialized") diff --git a/internal/cfg/cfg.go b/internal/cfg/cfg.go index 9e537eb..36478b1 100644 --- a/internal/cfg/cfg.go +++ b/internal/cfg/cfg.go @@ -38,6 +38,7 @@ const ( DISABLE_MUSICBRAINZ_ENV = "KOITO_DISABLE_MUSICBRAINZ" SUBSONIC_URL_ENV = "KOITO_SUBSONIC_URL" SUBSONIC_PARAMS_ENV = "KOITO_SUBSONIC_PARAMS" + LASTFM_API_KEY_ENV = "KOITO_LASTFM_API_KEY" SKIP_IMPORT_ENV = "KOITO_SKIP_IMPORT" ALLOWED_HOSTS_ENV = "KOITO_ALLOWED_HOSTS" CORS_ORIGINS_ENV = "KOITO_CORS_ALLOWED_ORIGINS" @@ -72,6 +73,7 @@ type config struct { disableMusicBrainz bool subsonicUrl string subsonicParams string + lastfmApiKey string subsonicEnabled bool skipImport bool fetchImageDuringImport bool @@ -165,6 +167,7 @@ func loadConfig(getenv func(string) string, version string) (*config, error) { if cfg.subsonicEnabled && (cfg.subsonicUrl == "" || cfg.subsonicParams == "") { return nil, fmt.Errorf("loadConfig: invalid configuration: both %s and %s must be set in order to use subsonic image fetching", SUBSONIC_URL_ENV, SUBSONIC_PARAMS_ENV) } + cfg.lastfmApiKey = getenv(LASTFM_API_KEY_ENV) cfg.skipImport = parseBool(getenv(SKIP_IMPORT_ENV)) cfg.userAgent = fmt.Sprintf("Koito %s (contact@koito.io)", version) @@ -361,6 +364,12 @@ func SubsonicParams() string { return globalConfig.subsonicParams } +func LastFMApiKey() string { + lock.RLock() + defer lock.RUnlock() + return globalConfig.lastfmApiKey +} + func SkipImport() bool { lock.RLock() defer lock.RUnlock() diff --git a/internal/images/imagesrc.go b/internal/images/imagesrc.go index 717b862..46fe87a 100644 --- a/internal/images/imagesrc.go +++ b/internal/images/imagesrc.go @@ -17,6 +17,8 @@ type ImageSource struct { deezerC *DeezerClient subsonicEnabled bool subsonicC *SubsonicClient + lastfmEnabled bool + lastfmC *LastFMClient caaEnabled bool } type ImageSourceOpts struct { @@ -24,6 +26,7 @@ type ImageSourceOpts struct { EnableCAA bool EnableDeezer bool EnableSubsonic bool + EnableLastFM bool } var once sync.Once @@ -57,6 +60,10 @@ func Initialize(opts ImageSourceOpts) { imgsrc.subsonicEnabled = true imgsrc.subsonicC = NewSubsonicClient() } + if opts.EnableLastFM { + imgsrc.lastfmEnabled = true + imgsrc.lastfmC = NewLastFMClient() + } }) } @@ -76,6 +83,16 @@ func GetArtistImage(ctx context.Context, opts ArtistImageOpts) (string, error) { } else { l.Debug().Msg("GetArtistImage: Subsonic image fetching is disabled") } + if imgsrc.lastfmEnabled { + img, err := imgsrc.lastfmC.GetArtistImage(ctx, opts.MBID, opts.Aliases[0]) + if err != nil { + l.Debug().Err(err).Msg("GetArtistImage: Could not find artist image from LastFM") + } else if img != "" { + return img, nil + } + } else { + l.Debug().Msg("GetArtistImage: LastFM image fetching is disabled") + } if imgsrc.deezerEnabled { img, err := imgsrc.deezerC.GetArtistImages(ctx, opts.Aliases) if err != nil { @@ -90,6 +107,7 @@ func GetArtistImage(ctx context.Context, opts ArtistImageOpts) (string, error) { l.Warn().Msg("GetArtistImage: No image providers are enabled") return "", nil } + func GetAlbumImage(ctx context.Context, opts AlbumImageOpts) (string, error) { l := logger.FromContext(ctx) if imgsrc.subsonicEnabled { @@ -109,9 +127,12 @@ func GetAlbumImage(ctx context.Context, opts AlbumImageOpts) (string, error) { resp, err := http.DefaultClient.Head(url) if err != nil { l.Debug().Err(err).Msg("GetAlbumImage: Could not find artist image from CoverArtArchive with Release MBID") - } - if resp.StatusCode == 200 { - return url, nil + } else { + if resp.StatusCode == 200 { + return url, nil + } else { + l.Debug().Int("status", resp.StatusCode).Msg("GetAlbumImage: Got non-OK response from CoverArtArchive") + } } } if opts.ReleaseGroupMbzID != nil && *opts.ReleaseGroupMbzID != uuid.Nil { @@ -125,6 +146,16 @@ func GetAlbumImage(ctx context.Context, opts AlbumImageOpts) (string, error) { } } } + if imgsrc.lastfmEnabled { + img, err := imgsrc.lastfmC.GetAlbumImage(ctx, opts.ReleaseMbzID, opts.Artists[0], opts.Album) + if err != nil { + l.Debug().Err(err).Msg("GetAlbumImage: Could not find artist image from Subsonic") + } + if img != "" { + return img, nil + } + l.Debug().Msg("Could not find album cover from Subsonic") + } if imgsrc.deezerEnabled { l.Debug().Msg("Attempting to find album image from Deezer") img, err := imgsrc.deezerC.GetAlbumImages(ctx, opts.Artists, opts.Album) diff --git a/internal/images/lastfm.go b/internal/images/lastfm.go new file mode 100644 index 0000000..f35f6a3 --- /dev/null +++ b/internal/images/lastfm.go @@ -0,0 +1,298 @@ +package images + +import ( + "context" + "encoding/json" + "fmt" + "io" + "net/http" + "net/url" + "strings" + + "github.com/gabehf/koito/internal/cfg" + "github.com/gabehf/koito/internal/logger" + "github.com/gabehf/koito/queue" + "github.com/google/uuid" +) + +// i told gemini to write this cuz i figured it would be simple enough and +// it looks like it just works? maybe ai is actually worth one quintillion gallons of water + +type LastFMClient struct { + apiKey string + baseUrl string + userAgent string + requestQueue *queue.RequestQueue +} + +// LastFM JSON structures use "#text" for the value of XML-mapped fields +type lastFMImage struct { + URL string `json:"#text"` + Size string `json:"size"` +} + +type lastFMAlbumResponse struct { + Album struct { + Name string `json:"name"` + Image []lastFMImage `json:"image"` + } `json:"album"` + Error int `json:"error"` + Message string `json:"message"` +} + +type lastFMArtistResponse struct { + Artist struct { + Name string `json:"name"` + Image []lastFMImage `json:"image"` + } `json:"artist"` + Error int `json:"error"` + Message string `json:"message"` +} + +const ( + lastFMApiBaseUrl = "http://ws.audioscrobbler.com/2.0/" +) + +func NewLastFMClient() *LastFMClient { + ret := new(LastFMClient) + ret.apiKey = cfg.LastFMApiKey() + ret.baseUrl = lastFMApiBaseUrl + ret.userAgent = cfg.UserAgent() + ret.requestQueue = queue.NewRequestQueue(5, 5) + return ret +} + +func (c *LastFMClient) queue(ctx context.Context, req *http.Request) ([]byte, error) { + l := logger.FromContext(ctx) + req.Header.Set("User-Agent", c.userAgent) + req.Header.Set("Accept", "application/json") + + resultChan := c.requestQueue.Enqueue(func(client *http.Client, done chan<- queue.RequestResult) { + resp, err := client.Do(req) + if err != nil { + l.Debug().Err(err).Str("url", req.URL.String()).Msg("Failed to contact LastFM") + done <- queue.RequestResult{Err: err} + return + } + defer resp.Body.Close() + + // LastFM might return 200 OK even for API errors (like "Artist not found"), + // so we rely on parsing the JSON body for logic errors later, + // but we still check for HTTP protocol failures here. + if resp.StatusCode >= 500 { + err = fmt.Errorf("received server error from LastFM: %s", resp.Status) + done <- queue.RequestResult{Body: nil, Err: err} + return + } + + body, err := io.ReadAll(resp.Body) + done <- queue.RequestResult{Body: body, Err: err} + }) + + result := <-resultChan + return result.Body, result.Err +} + +func (c *LastFMClient) getEntity(ctx context.Context, params url.Values, result any) error { + l := logger.FromContext(ctx) + + // Add standard parameters + params.Set("api_key", c.apiKey) + params.Set("format", "json") + + // Construct URL + reqUrl, _ := url.Parse(c.baseUrl) + reqUrl.RawQuery = params.Encode() + + l.Debug().Msgf("Sending request to LastFM: GET %s", reqUrl.String()) + + req, err := http.NewRequest("GET", reqUrl.String(), nil) + if err != nil { + return fmt.Errorf("getEntity: %w", err) + } + + l.Debug().Msg("Adding LastFM request to queue") + body, err := c.queue(ctx, req) + if err != nil { + l.Err(err).Msg("LastFM request failed") + return fmt.Errorf("getEntity: %w", err) + } + + err = json.Unmarshal(body, result) + if err != nil { + l.Err(err).Msg("Failed to unmarshal LastFM response") + return fmt.Errorf("getEntity: %w", err) + } + + return nil +} + +// selectBestImage picks the largest available image from the LastFM slice +func (c *LastFMClient) selectBestImage(images []lastFMImage) string { + // Rank preference: mega > extralarge > large > medium > small + // Since LastFM usually returns them in order of size, we could take the last one, + // but a map lookup is safer against API changes. + + imgMap := make(map[string]string) + for _, img := range images { + if img.URL != "" { + imgMap[img.Size] = img.URL + } + } + + if url, ok := imgMap["mega"]; ok { + if err := ValidateImageURL(overrideImgSize(url)); err == nil { + return overrideImgSize(url) + } else { + return url + } + } + if url, ok := imgMap["extralarge"]; ok { + if err := ValidateImageURL(overrideImgSize(url)); err == nil { + return overrideImgSize(url) + } else { + return url + } + } + if url, ok := imgMap["large"]; ok { + if err := ValidateImageURL(overrideImgSize(url)); err == nil { + return overrideImgSize(url) + } else { + return url + } + } + if url, ok := imgMap["medium"]; ok { + return url + } + if url, ok := imgMap["small"]; ok { + return url + } + + return "" +} + +// lastfm seems to only return a 300x300 image even for "mega" and "extralarge" images, so I'm cheating +func overrideImgSize(url string) string { + return strings.Replace(url, "300x300", "600x600", 1) +} + +func (c *LastFMClient) GetAlbumImage(ctx context.Context, mbid *uuid.UUID, artist, album string) (string, error) { + l := logger.FromContext(ctx) + resp := new(lastFMAlbumResponse) + l.Debug().Msgf("Finding album image for %s from artist %s", album, artist) + + // Helper to run the fetch + fetch := func(query paramsBuilder) error { + params := url.Values{} + params.Set("method", "album.getInfo") + query(params) + return c.getEntity(ctx, params, resp) + } + + // 1. Try MBID search first + if mbid != nil { + l.Debug().Str("mbid", mbid.String()).Msg("Searching album image by MBID") + err := fetch(func(p url.Values) { + p.Set("mbid", mbid.String()) + }) + + // If success and no API error code + if err == nil && resp.Error == 0 && len(resp.Album.Image) > 0 { + best := c.selectBestImage(resp.Album.Image) + if best != "" { + return best, nil + } + } else if resp.Error != 0 { + l.Debug().Int("api_error", resp.Error).Msg("LastFM MBID lookup failed, falling back to name") + } + } + + // 2. Fallback to Artist + Album name match + l.Debug().Str("title", album).Str("artist", artist).Msg("Searching album image by title and artist") + + // Clear previous response structure just in case + resp = new(lastFMAlbumResponse) + + err := fetch(func(p url.Values) { + p.Set("artist", artist) + p.Set("album", album) + // Auto-correct spelling is useful for name lookups + p.Set("autocorrect", "1") + }) + + if err != nil { + return "", fmt.Errorf("GetAlbumImage: %v", err) + } + + if resp.Error != 0 { + return "", fmt.Errorf("GetAlbumImage: LastFM API error %d: %s", resp.Error, resp.Message) + } + + best := c.selectBestImage(resp.Album.Image) + if best == "" { + return "", fmt.Errorf("GetAlbumImage: no suitable image found") + } + + return best, nil +} + +func (c *LastFMClient) GetArtistImage(ctx context.Context, mbid *uuid.UUID, artist string) (string, error) { + l := logger.FromContext(ctx) + resp := new(lastFMArtistResponse) + l.Debug().Msgf("Finding artist image for %s", artist) + + fetch := func(query paramsBuilder) error { + params := url.Values{} + params.Set("method", "artist.getInfo") + query(params) + return c.getEntity(ctx, params, resp) + } + + // 1. Try MBID search + if mbid != nil { + l.Debug().Str("mbid", mbid.String()).Msg("Searching artist image by MBID") + err := fetch(func(p url.Values) { + p.Set("mbid", mbid.String()) + }) + + if err == nil && resp.Error == 0 && len(resp.Artist.Image) > 0 { + best := c.selectBestImage(resp.Artist.Image) + if best != "" { + // Validate to match Subsonic implementation behavior + if err := ValidateImageURL(best); err == nil { + return best, nil + } + } + } + } + + // 2. Fallback to Artist name + l.Debug().Str("artist", artist).Msg("Searching artist image by name") + resp = new(lastFMArtistResponse) + + err := fetch(func(p url.Values) { + p.Set("artist", artist) + p.Set("autocorrect", "1") + }) + + if err != nil { + return "", fmt.Errorf("GetArtistImage: %v", err) + } + + if resp.Error != 0 { + return "", fmt.Errorf("GetArtistImage: LastFM API error %d: %s", resp.Error, resp.Message) + } + + best := c.selectBestImage(resp.Artist.Image) + if best == "" { + return "", fmt.Errorf("GetArtistImage: no suitable image found") + } + + if err := ValidateImageURL(best); err != nil { + return "", fmt.Errorf("GetArtistImage: failed to validate image url") + } + + return best, nil +} + +type paramsBuilder func(url.Values) From c59c6c3baa602e609115a07334d14dc942c7532f Mon Sep 17 00:00:00 2001 From: onespaceman Date: Wed, 21 Jan 2026 16:03:27 -0500 Subject: [PATCH 24/37] QOL changes to client (#165) --- client/app/app.css | 31 +++++++------------- client/app/components/modals/DeleteModal.tsx | 2 +- client/app/components/modals/MergeModal.tsx | 13 ++++---- client/app/components/modals/Modal.tsx | 30 +++++++++++++++++-- 4 files changed, 46 insertions(+), 30 deletions(-) diff --git a/client/app/app.css b/client/app/app.css index 217e955..eb5e7f6 100644 --- a/client/app/app.css +++ b/client/app/app.css @@ -130,30 +130,21 @@ h4 { text-decoration: underline; } -input[type="text"] { - border: 1px solid var(--color-bg); -} -input[type="text"]:focus { - outline: none; - border: 1px solid var(--color-fg-tertiary); -} +input[type="text"], +input[type="password"], textarea { border: 1px solid var(--color-bg); } +input[type="checkbox"] { + height: fit-content; +} +input:focus, +button:focus, +a:focus, +select:focus, textarea:focus { - outline: none; - border: 1px solid var(--color-fg-tertiary); -} -input[type="password"] { - border: 1px solid var(--color-bg); -} -input[type="password"]:focus { - outline: none; - border: 1px solid var(--color-fg-tertiary); -} -input[type="checkbox"]:focus { - outline: none; - border: 1px solid var(--color-fg-tertiary); + border-color: transparent; + outline: 2px solid var(--color-fg-tertiary); } button:hover { diff --git a/client/app/components/modals/DeleteModal.tsx b/client/app/components/modals/DeleteModal.tsx index 06bfdaf..227951e 100644 --- a/client/app/components/modals/DeleteModal.tsx +++ b/client/app/components/modals/DeleteModal.tsx @@ -20,7 +20,7 @@ export default function DeleteModal({ open, setOpen, title, id, type }: Props) { setLoading(true); deleteItem(type.toLowerCase(), id).then((r) => { if (r.ok) { - navigate("/"); + navigate(-1); } else { console.log(r); } diff --git a/client/app/components/modals/MergeModal.tsx b/client/app/components/modals/MergeModal.tsx index 61e2618..c78681d 100644 --- a/client/app/components/modals/MergeModal.tsx +++ b/client/app/components/modals/MergeModal.tsx @@ -19,7 +19,7 @@ interface Props { } export default function MergeModal(props: Props) { - const [query, setQuery] = useState(""); + const [query, setQuery] = useState(props.currentTitle); const [data, setData] = useState(); const [debouncedQuery, setDebouncedQuery] = useState(query); const [mergeTarget, setMergeTarget] = useState<{ title: string; id: number }>( @@ -101,11 +101,12 @@ export default function MergeModal(props: Props) { { setQuery(e.target.value); e.target.select()}} onChange={(e) => setQuery(e.target.value)} /> @@ -128,7 +129,7 @@ export default function MergeModal(props: Props) { > Merge Items -
+
{(props.type.toLowerCase() === "album" || props.type.toLowerCase() === "artist") && ( -
+
{ const handleKeyDown = (e: KeyboardEvent) => { - if (e.key === 'Escape') onClose(); + // Close on Escape key + if (e.key === 'Escape') { + onClose() + // Trap tab navigation to the modal + } else if (e.key === 'Tab') { + if (modalRef.current) { + const focusableEls = modalRef.current.querySelectorAll( + 'button:not(:disabled), [href], input:not(:disabled), select:not(:disabled), textarea:not(:disabled), [tabindex]:not([tabindex="-1"])' + ); + const firstEl = focusableEls[0]; + const lastEl = focusableEls[focusableEls.length - 1]; + const activeEl = document.activeElement + + if (e.shiftKey && activeEl === firstEl) { + e.preventDefault(); + lastEl.focus(); + } else if (!e.shiftKey && activeEl === lastEl) { + e.preventDefault(); + firstEl.focus(); + } else if (!Array.from(focusableEls).find(node => node.isEqualNode(activeEl))) { + e.preventDefault(); + firstEl.focus(); + } + } + }; }; if (isOpen) document.addEventListener('keydown', handleKeyDown); return () => document.removeEventListener('keydown', handleKeyDown); @@ -70,13 +94,13 @@ export function Modal({ }`} style={{ maxWidth: maxW ?? 600, height: h ?? '' }} > + {children} - {children}
, document.body From 16cee8cfcababb84e93ba4793fb57e53993a942b Mon Sep 17 00:00:00 2001 From: Gabe Farrell <90876006+gabehf@users.noreply.github.com> Date: Wed, 21 Jan 2026 17:30:59 -0500 Subject: [PATCH 25/37] fix: speedup top-artists and top-albums queries (#167) --- db/queries/release.sql | 8 +-- db/queries/track.sql | 110 +++++++++++++---------------- internal/repository/release.sql.go | 12 ++-- internal/repository/track.sql.go | 110 +++++++++++++---------------- 4 files changed, 112 insertions(+), 128 deletions(-) diff --git a/db/queries/release.sql b/db/queries/release.sql index 47aac86..23bd2f2 100644 --- a/db/queries/release.sql +++ b/db/queries/release.sql @@ -48,12 +48,12 @@ WHERE r.title = ANY ($1::TEXT[]) -- name: GetTopReleasesFromArtist :many SELECT x.*, + get_artists_for_release(x.id) AS artists, RANK() OVER (ORDER BY x.listen_count DESC) AS rank FROM ( SELECT r.*, - COUNT(*) AS listen_count, - get_artists_for_release(r.id) AS artists + COUNT(*) AS listen_count FROM listens l JOIN tracks t ON l.track_id = t.id JOIN releases_with_title r ON t.release_id = r.id @@ -68,12 +68,12 @@ LIMIT $3 OFFSET $4; -- name: GetTopReleasesPaginated :many SELECT x.*, + get_artists_for_release(x.id) AS artists, RANK() OVER (ORDER BY x.listen_count DESC) AS rank FROM ( SELECT r.*, - COUNT(*) AS listen_count, - get_artists_for_release(r.id) AS artists + COUNT(*) AS listen_count FROM listens l JOIN tracks t ON l.track_id = t.id JOIN releases_with_title r ON t.release_id = r.id diff --git a/db/queries/track.sql b/db/queries/track.sql index c69bed5..3be4d7e 100644 --- a/db/queries/track.sql +++ b/db/queries/track.sql @@ -39,90 +39,82 @@ HAVING COUNT(DISTINCT at.artist_id) = cardinality($3::int[]); -- name: GetTopTracksPaginated :many SELECT - x.id, - x.title, - x.musicbrainz_id, - x.release_id, - x.image, + x.track_id AS id, + t.title, + t.musicbrainz_id, + t.release_id, + r.image, x.listen_count, - x.artists, - RANK() OVER (ORDER BY x.listen_count DESC) AS rank + get_artists_for_track(x.track_id) AS artists, + x.rank FROM ( SELECT - t.id, - t.title, - t.musicbrainz_id, - t.release_id, - r.image, + track_id, COUNT(*) AS listen_count, - get_artists_for_track(t.id) AS artists - FROM listens l - JOIN tracks_with_title t ON l.track_id = t.id - JOIN releases r ON t.release_id = r.id - WHERE l.listened_at BETWEEN $1 AND $2 - GROUP BY t.id, t.title, t.musicbrainz_id, t.release_id, r.image + RANK() OVER (ORDER BY COUNT(*) DESC) as rank + FROM listens + WHERE listened_at BETWEEN $1 AND $2 + GROUP BY track_id + ORDER BY listen_count DESC + LIMIT $3 OFFSET $4 ) x -ORDER BY x.listen_count DESC, x.id -LIMIT $3 OFFSET $4; +JOIN tracks_with_title t ON x.track_id = t.id +JOIN releases r ON t.release_id = r.id +ORDER BY x.listen_count DESC, x.track_id; -- name: GetTopTracksByArtistPaginated :many SELECT - x.id, - x.title, - x.musicbrainz_id, - x.release_id, - x.image, + x.track_id AS id, + t.title, + t.musicbrainz_id, + t.release_id, + r.image, x.listen_count, - x.artists, - RANK() OVER (ORDER BY x.listen_count DESC) AS rank + get_artists_for_track(x.track_id) AS artists, + x.rank FROM ( SELECT - t.id, - t.title, - t.musicbrainz_id, - t.release_id, - r.image, + l.track_id, COUNT(*) AS listen_count, - get_artists_for_track(t.id) AS artists + RANK() OVER (ORDER BY COUNT(*) DESC) as rank FROM listens l - JOIN tracks_with_title t ON l.track_id = t.id - JOIN releases r ON t.release_id = r.id - JOIN artist_tracks at ON at.track_id = t.id + JOIN artist_tracks at ON l.track_id = at.track_id WHERE l.listened_at BETWEEN $1 AND $2 - AND at.artist_id = $5 - GROUP BY t.id, t.title, t.musicbrainz_id, t.release_id, r.image + AND at.artist_id = $5 + GROUP BY l.track_id + ORDER BY listen_count DESC + LIMIT $3 OFFSET $4 ) x -ORDER BY x.listen_count DESC, x.id -LIMIT $3 OFFSET $4; +JOIN tracks_with_title t ON x.track_id = t.id +JOIN releases r ON t.release_id = r.id +ORDER BY x.listen_count DESC, x.track_id; -- name: GetTopTracksInReleasePaginated :many SELECT - x.id, - x.title, - x.musicbrainz_id, - x.release_id, - x.image, + x.track_id AS id, + t.title, + t.musicbrainz_id, + t.release_id, + r.image, x.listen_count, - x.artists, - RANK() OVER (ORDER BY x.listen_count DESC) AS rank + get_artists_for_track(x.track_id) AS artists, + x.rank FROM ( SELECT - t.id, - t.title, - t.musicbrainz_id, - t.release_id, - r.image, + l.track_id, COUNT(*) AS listen_count, - get_artists_for_track(t.id) AS artists + RANK() OVER (ORDER BY COUNT(*) DESC) as rank FROM listens l - JOIN tracks_with_title t ON l.track_id = t.id - JOIN releases r ON t.release_id = r.id + JOIN tracks t ON l.track_id = t.id WHERE l.listened_at BETWEEN $1 AND $2 - AND t.release_id = $5 - GROUP BY t.id, t.title, t.musicbrainz_id, t.release_id, r.image + AND t.release_id = $5 + GROUP BY l.track_id + ORDER BY listen_count DESC + LIMIT $3 OFFSET $4 ) x -ORDER BY x.listen_count DESC, x.id -LIMIT $3 OFFSET $4; +JOIN tracks_with_title t ON x.track_id = t.id +JOIN releases r ON t.release_id = r.id +ORDER BY x.listen_count DESC, x.track_id; -- name: GetTrackAllTimeRank :one SELECT diff --git a/internal/repository/release.sql.go b/internal/repository/release.sql.go index 6d12da4..f62e086 100644 --- a/internal/repository/release.sql.go +++ b/internal/repository/release.sql.go @@ -353,13 +353,13 @@ func (q *Queries) GetReleasesWithoutImages(ctx context.Context, arg GetReleasesW const getTopReleasesFromArtist = `-- name: GetTopReleasesFromArtist :many SELECT - x.id, x.musicbrainz_id, x.image, x.various_artists, x.image_source, x.title, x.listen_count, x.artists, + x.id, x.musicbrainz_id, x.image, x.various_artists, x.image_source, x.title, x.listen_count, + get_artists_for_release(x.id) AS artists, RANK() OVER (ORDER BY x.listen_count DESC) AS rank FROM ( SELECT r.id, r.musicbrainz_id, r.image, r.various_artists, r.image_source, r.title, - COUNT(*) AS listen_count, - get_artists_for_release(r.id) AS artists + COUNT(*) AS listen_count FROM listens l JOIN tracks t ON l.track_id = t.id JOIN releases_with_title r ON t.release_id = r.id @@ -430,13 +430,13 @@ func (q *Queries) GetTopReleasesFromArtist(ctx context.Context, arg GetTopReleas const getTopReleasesPaginated = `-- name: GetTopReleasesPaginated :many SELECT - x.id, x.musicbrainz_id, x.image, x.various_artists, x.image_source, x.title, x.listen_count, x.artists, + x.id, x.musicbrainz_id, x.image, x.various_artists, x.image_source, x.title, x.listen_count, + get_artists_for_release(x.id) AS artists, RANK() OVER (ORDER BY x.listen_count DESC) AS rank FROM ( SELECT r.id, r.musicbrainz_id, r.image, r.various_artists, r.image_source, r.title, - COUNT(*) AS listen_count, - get_artists_for_release(r.id) AS artists + COUNT(*) AS listen_count FROM listens l JOIN tracks t ON l.track_id = t.id JOIN releases_with_title r ON t.release_id = r.id diff --git a/internal/repository/track.sql.go b/internal/repository/track.sql.go index e2aa084..b376198 100644 --- a/internal/repository/track.sql.go +++ b/internal/repository/track.sql.go @@ -155,33 +155,30 @@ func (q *Queries) GetAllTracksFromArtist(ctx context.Context, artistID int32) ([ const getTopTracksByArtistPaginated = `-- name: GetTopTracksByArtistPaginated :many SELECT - x.id, - x.title, - x.musicbrainz_id, - x.release_id, - x.image, + x.track_id AS id, + t.title, + t.musicbrainz_id, + t.release_id, + r.image, x.listen_count, - x.artists, - RANK() OVER (ORDER BY x.listen_count DESC) AS rank + get_artists_for_track(x.track_id) AS artists, + x.rank FROM ( SELECT - t.id, - t.title, - t.musicbrainz_id, - t.release_id, - r.image, + l.track_id, COUNT(*) AS listen_count, - get_artists_for_track(t.id) AS artists + RANK() OVER (ORDER BY COUNT(*) DESC) as rank FROM listens l - JOIN tracks_with_title t ON l.track_id = t.id - JOIN releases r ON t.release_id = r.id - JOIN artist_tracks at ON at.track_id = t.id + JOIN artist_tracks at ON l.track_id = at.track_id WHERE l.listened_at BETWEEN $1 AND $2 - AND at.artist_id = $5 - GROUP BY t.id, t.title, t.musicbrainz_id, t.release_id, r.image + AND at.artist_id = $5 + GROUP BY l.track_id + ORDER BY listen_count DESC + LIMIT $3 OFFSET $4 ) x -ORDER BY x.listen_count DESC, x.id -LIMIT $3 OFFSET $4 +JOIN tracks_with_title t ON x.track_id = t.id +JOIN releases r ON t.release_id = r.id +ORDER BY x.listen_count DESC, x.track_id ` type GetTopTracksByArtistPaginatedParams struct { @@ -240,32 +237,30 @@ func (q *Queries) GetTopTracksByArtistPaginated(ctx context.Context, arg GetTopT const getTopTracksInReleasePaginated = `-- name: GetTopTracksInReleasePaginated :many SELECT - x.id, - x.title, - x.musicbrainz_id, - x.release_id, - x.image, + x.track_id AS id, + t.title, + t.musicbrainz_id, + t.release_id, + r.image, x.listen_count, - x.artists, - RANK() OVER (ORDER BY x.listen_count DESC) AS rank + get_artists_for_track(x.track_id) AS artists, + x.rank FROM ( SELECT - t.id, - t.title, - t.musicbrainz_id, - t.release_id, - r.image, + l.track_id, COUNT(*) AS listen_count, - get_artists_for_track(t.id) AS artists + RANK() OVER (ORDER BY COUNT(*) DESC) as rank FROM listens l - JOIN tracks_with_title t ON l.track_id = t.id - JOIN releases r ON t.release_id = r.id + JOIN tracks t ON l.track_id = t.id WHERE l.listened_at BETWEEN $1 AND $2 - AND t.release_id = $5 - GROUP BY t.id, t.title, t.musicbrainz_id, t.release_id, r.image + AND t.release_id = $5 + GROUP BY l.track_id + ORDER BY listen_count DESC + LIMIT $3 OFFSET $4 ) x -ORDER BY x.listen_count DESC, x.id -LIMIT $3 OFFSET $4 +JOIN tracks_with_title t ON x.track_id = t.id +JOIN releases r ON t.release_id = r.id +ORDER BY x.listen_count DESC, x.track_id ` type GetTopTracksInReleasePaginatedParams struct { @@ -324,31 +319,28 @@ func (q *Queries) GetTopTracksInReleasePaginated(ctx context.Context, arg GetTop const getTopTracksPaginated = `-- name: GetTopTracksPaginated :many SELECT - x.id, - x.title, - x.musicbrainz_id, - x.release_id, - x.image, + x.track_id AS id, + t.title, + t.musicbrainz_id, + t.release_id, + r.image, x.listen_count, - x.artists, - RANK() OVER (ORDER BY x.listen_count DESC) AS rank + get_artists_for_track(x.track_id) AS artists, + x.rank FROM ( SELECT - t.id, - t.title, - t.musicbrainz_id, - t.release_id, - r.image, + track_id, COUNT(*) AS listen_count, - get_artists_for_track(t.id) AS artists - FROM listens l - JOIN tracks_with_title t ON l.track_id = t.id - JOIN releases r ON t.release_id = r.id - WHERE l.listened_at BETWEEN $1 AND $2 - GROUP BY t.id, t.title, t.musicbrainz_id, t.release_id, r.image + RANK() OVER (ORDER BY COUNT(*) DESC) as rank + FROM listens + WHERE listened_at BETWEEN $1 AND $2 + GROUP BY track_id + ORDER BY listen_count DESC + LIMIT $3 OFFSET $4 ) x -ORDER BY x.listen_count DESC, x.id -LIMIT $3 OFFSET $4 +JOIN tracks_with_title t ON x.track_id = t.id +JOIN releases r ON t.release_id = r.id +ORDER BY x.listen_count DESC, x.track_id ` type GetTopTracksPaginatedParams struct { From cb4d17787597f5a3826adb8c37cff8c836ebdfda Mon Sep 17 00:00:00 2001 From: Gabe Farrell <90876006+gabehf@users.noreply.github.com> Date: Thu, 22 Jan 2026 15:33:38 -0500 Subject: [PATCH 26/37] fix: release associations and add cleanup migration (#168) * fix: release associations and add cleanup migration * fix: incorrect test --- .../000005_rm_orphan_artist_releases.sql | 9 ++++++ db/queries/etc.sql | 10 +++++-- engine/import_test.go | 7 +++++ internal/db/psql/merge.go | 2 +- internal/db/psql/merge_test.go | 22 +++++++------- internal/db/psql/track.go | 30 ++++++++++++++++++- internal/db/psql/track_test.go | 26 +++++++++++++++- internal/repository/etc.sql.go | 10 +++++-- test_assets/koito_export_test.json | 16 +++++----- 9 files changed, 106 insertions(+), 26 deletions(-) create mode 100644 db/migrations/000005_rm_orphan_artist_releases.sql diff --git a/db/migrations/000005_rm_orphan_artist_releases.sql b/db/migrations/000005_rm_orphan_artist_releases.sql new file mode 100644 index 0000000..bfb361f --- /dev/null +++ b/db/migrations/000005_rm_orphan_artist_releases.sql @@ -0,0 +1,9 @@ +-- +goose Up +DELETE FROM artist_releases ar +WHERE NOT EXISTS ( + SELECT 1 + FROM artist_tracks at + JOIN tracks t ON at.track_id = t.id + WHERE at.artist_id = ar.artist_id + AND t.release_id = ar.release_id +); diff --git a/db/queries/etc.sql b/db/queries/etc.sql index 44139b8..38465f2 100644 --- a/db/queries/etc.sql +++ b/db/queries/etc.sql @@ -3,7 +3,13 @@ DO $$ BEGIN DELETE FROM tracks WHERE id NOT IN (SELECT l.track_id FROM listens l); DELETE FROM releases WHERE id NOT IN (SELECT t.release_id FROM tracks t); --- DELETE FROM releases WHERE release_group_id NOT IN (SELECT t.release_group_id FROM tracks t); --- DELETE FROM releases WHERE release_group_id NOT IN (SELECT rg.id FROM release_groups rg); DELETE FROM artists WHERE id NOT IN (SELECT at.artist_id FROM artist_tracks at); + DELETE FROM artist_releases ar + WHERE NOT EXISTS ( + SELECT 1 + FROM artist_tracks at + JOIN tracks t ON at.track_id = t.id + WHERE at.artist_id = ar.artist_id + AND t.release_id = ar.release_id + ); END $$; diff --git a/engine/import_test.go b/engine/import_test.go index 2a802aa..bb5c18e 100644 --- a/engine/import_test.go +++ b/engine/import_test.go @@ -276,6 +276,7 @@ func TestImportKoito(t *testing.T) { giriReleaseMBID := uuid.MustParse("ac1f8da0-21d7-426e-83b0-befff06f0871") suzukiMBID := uuid.MustParse("30f851bb-dba3-4e9b-811c-5f27f595c86a") nijinoTrackMBID := uuid.MustParse("a4f26836-3894-46c1-acac-227808308687") + lp3MBID := uuid.MustParse("d0ec30bd-7cdc-417c-979d-5a0631b8a161") input, err := os.ReadFile(src) require.NoError(t, err) @@ -312,6 +313,12 @@ func TestImportKoito(t *testing.T) { aliases, err := store.GetAllAlbumAliases(ctx, album.ID) require.NoError(t, err) assert.Contains(t, utils.FlattenAliases(aliases), "Nijinoiroyo Azayakadeare (NELKE ver.)") + // ensure album associations are saved + album, err = store.GetAlbum(ctx, db.GetAlbumOpts{MusicBrainzID: lp3MBID}) + require.NoError(t, err) + assert.Contains(t, utils.FlattenSimpleArtistNames(album.Artists), "Elizabeth Powell") + assert.Contains(t, utils.FlattenSimpleArtistNames(album.Artists), "Rachel Goswell") + assert.Contains(t, utils.FlattenSimpleArtistNames(album.Artists), "American Football") // ensure all tracks are saved track, err := store.GetTrack(ctx, db.GetTrackOpts{MusicBrainzID: nijinoTrackMBID}) diff --git a/internal/db/psql/merge.go b/internal/db/psql/merge.go index d9e24b6..dd375c5 100644 --- a/internal/db/psql/merge.go +++ b/internal/db/psql/merge.go @@ -52,7 +52,7 @@ func (d *Psql) MergeTracks(ctx context.Context, fromId, toId int32) error { } err = qtx.CleanOrphanedEntries(ctx) if err != nil { - l.Err(err).Msg("Failed to clean orphaned entries") + l.Err(err).Msg("MergeTracks: Failed to clean orphaned entries") return err } return tx.Commit(ctx) diff --git a/internal/db/psql/merge_test.go b/internal/db/psql/merge_test.go index 08169fb..38e843a 100644 --- a/internal/db/psql/merge_test.go +++ b/internal/db/psql/merge_test.go @@ -12,27 +12,27 @@ func setupTestDataForMerge(t *testing.T) { truncateTestData(t) // Insert artists err := store.Exec(context.Background(), - `INSERT INTO artists (musicbrainz_id, image, image_source) + `INSERT INTO artists (musicbrainz_id, image, image_source) VALUES ('00000000-0000-0000-0000-000000000001', '10000000-0000-0000-0000-000000000000', 'source.com'), ('00000000-0000-0000-0000-000000000002', NULL, NULL)`) require.NoError(t, err) err = store.Exec(context.Background(), - `INSERT INTO artist_aliases (artist_id, alias, source, is_primary) + `INSERT INTO artist_aliases (artist_id, alias, source, is_primary) VALUES (1, 'Artist One', 'Testing', true), (2, 'Artist Two', 'Testing', true)`) require.NoError(t, err) // Insert albums err = store.Exec(context.Background(), - `INSERT INTO releases (musicbrainz_id, image, image_source) + `INSERT INTO releases (musicbrainz_id, image, image_source) VALUES ('11111111-1111-1111-1111-111111111111', '20000000-0000-0000-0000-000000000000', 'source.com'), ('22222222-2222-2222-2222-222222222222', NULL, NULL), (NULL, NULL, NULL)`) require.NoError(t, err) err = store.Exec(context.Background(), - `INSERT INTO release_aliases (release_id, alias, source, is_primary) + `INSERT INTO release_aliases (release_id, alias, source, is_primary) VALUES (1, 'Album One', 'Testing', true), (2, 'Album Two', 'Testing', true), (3, 'Album Three', 'Testing', true)`) @@ -40,7 +40,7 @@ func setupTestDataForMerge(t *testing.T) { // Insert tracks err = store.Exec(context.Background(), - `INSERT INTO tracks (musicbrainz_id, release_id) + `INSERT INTO tracks (musicbrainz_id, release_id) VALUES ('33333333-3333-3333-3333-333333333333', 1), ('44444444-4444-4444-4444-444444444444', 2), ('55555555-5555-5555-5555-555555555555', 1), @@ -48,7 +48,7 @@ func setupTestDataForMerge(t *testing.T) { require.NoError(t, err) err = store.Exec(context.Background(), - `INSERT INTO track_aliases (track_id, alias, source, is_primary) + `INSERT INTO track_aliases (track_id, alias, source, is_primary) VALUES (1, 'Track One', 'Testing', true), (2, 'Track Two', 'Testing', true), (3, 'Track Three', 'Testing', true), @@ -57,18 +57,18 @@ func setupTestDataForMerge(t *testing.T) { // Associate artists with albums and tracks err = store.Exec(context.Background(), - `INSERT INTO artist_releases (artist_id, release_id) + `INSERT INTO artist_releases (artist_id, release_id) VALUES (1, 1), (2, 2), (1, 3)`) require.NoError(t, err) err = store.Exec(context.Background(), - `INSERT INTO artist_tracks (artist_id, track_id) + `INSERT INTO artist_tracks (artist_id, track_id) VALUES (1, 1), (2, 2), (1, 3), (1, 4)`) require.NoError(t, err) // Insert listens err = store.Exec(context.Background(), - `INSERT INTO listens (user_id, track_id, listened_at) + `INSERT INTO listens (user_id, track_id, listened_at) VALUES (1, 1, NOW() - INTERVAL '1 day'), (1, 2, NOW() - INTERVAL '2 days'), (1, 3, NOW() - INTERVAL '3 days'), @@ -90,14 +90,14 @@ func TestMergeTracks(t *testing.T) { require.NoError(t, err) assert.Equal(t, 2, count, "expected all listens to be merged into Track 2") - // Verify artist is associated with album + // Verify old artist is not associated with album exists, err := store.RowExists(ctx, ` SELECT EXISTS ( SELECT 1 FROM artist_releases WHERE release_id = $1 AND artist_id = $2 )`, 2, 1) require.NoError(t, err) - assert.True(t, exists, "expected old artist to be associated with album") + assert.False(t, exists) truncateTestData(t) } diff --git a/internal/db/psql/track.go b/internal/db/psql/track.go index 743a20e..d4cc616 100644 --- a/internal/db/psql/track.go +++ b/internal/db/psql/track.go @@ -137,6 +137,13 @@ func (d *Psql) SaveTrack(ctx context.Context, opts db.SaveTrackOpts) (*models.Tr if err != nil { return nil, fmt.Errorf("SaveTrack: AssociateArtistToTrack: %w", err) } + err = qtx.AssociateArtistToRelease(ctx, repository.AssociateArtistToReleaseParams{ + ArtistID: aid, + ReleaseID: trackRow.ReleaseID, + }) + if err != nil { + return nil, fmt.Errorf("SaveTrack: AssociateArtistToTrack: %w", err) + } } // insert primary alias err = qtx.InsertTrackAlias(ctx, repository.InsertTrackAliasParams{ @@ -233,7 +240,28 @@ func (d *Psql) SaveTrackAliases(ctx context.Context, id int32, aliases []string, } func (d *Psql) DeleteTrack(ctx context.Context, id int32) error { - return d.q.DeleteTrack(ctx, id) + l := logger.FromContext(ctx) + tx, err := d.conn.BeginTx(ctx, pgx.TxOptions{}) + if err != nil { + l.Err(err).Msg("Failed to begin transaction") + return fmt.Errorf("DeleteTrack: %w", err) + } + defer tx.Rollback(ctx) + qtx := d.q.WithTx(tx) + + err = qtx.DeleteTrack(ctx, id) + if err != nil { + return fmt.Errorf("DeleteTrack: DeleteTrack: %w", err) + } + + // also clean orphaned entries to ensure artists are disassociated with releases where + // they no longer have any tracks on the release + err = qtx.CleanOrphanedEntries(ctx) + if err != nil { + return fmt.Errorf("DeleteTrack: CleanOrphanedEntries: %w", err) + } + + return tx.Commit(ctx) } func (d *Psql) DeleteTrackAlias(ctx context.Context, id int32, alias string) error { diff --git a/internal/db/psql/track_test.go b/internal/db/psql/track_test.go index 7fa58d4..f0ecd09 100644 --- a/internal/db/psql/track_test.go +++ b/internal/db/psql/track_test.go @@ -62,7 +62,7 @@ func testDataForTracks(t *testing.T) { VALUES (1, 1), (2, 2)`) require.NoError(t, err) - // Associate tracks with artists + // Insert listens err = store.Exec(context.Background(), `INSERT INTO listens (user_id, track_id, listened_at) VALUES (1, 1, NOW()), (1, 2, NOW())`) @@ -228,3 +228,27 @@ func TestDeleteTrack(t *testing.T) { _, err = store.Count(ctx, `SELECT * FROM tracks WHERE id = 2`) require.ErrorIs(t, err, pgx.ErrNoRows) // no rows error } + +func TestReleaseAssociations(t *testing.T) { + testDataForTracks(t) + ctx := context.Background() + + track, err := store.SaveTrack(ctx, db.SaveTrackOpts{ + Title: "Track Three", + AlbumID: 2, + ArtistIDs: []int32{2, 1}, // Artist Two feat. Artist One + Duration: 100, + }) + require.NoError(t, err) + count, err := store.Count(ctx, `SELECT COUNT(*) FROM artist_releases WHERE release_id = 2`) + require.NoError(t, err) + require.Equal(t, 2, count, "expected release to be associated with artist from inserted track") + + err = store.DeleteTrack(ctx, track.ID) + require.NoError(t, err) + + count, err = store.Count(ctx, `SELECT COUNT(*) FROM artist_releases WHERE release_id = 2`) + require.NoError(t, err) + require.Equal(t, 1, count, "expected artist no longer on release to be disassociated from release") + +} diff --git a/internal/repository/etc.sql.go b/internal/repository/etc.sql.go index ed902ea..484f5c4 100644 --- a/internal/repository/etc.sql.go +++ b/internal/repository/etc.sql.go @@ -15,11 +15,17 @@ BEGIN DELETE FROM tracks WHERE id NOT IN (SELECT l.track_id FROM listens l); DELETE FROM releases WHERE id NOT IN (SELECT t.release_id FROM tracks t); DELETE FROM artists WHERE id NOT IN (SELECT at.artist_id FROM artist_tracks at); + DELETE FROM artist_releases ar + WHERE NOT EXISTS ( + SELECT 1 + FROM artist_tracks at + JOIN tracks t ON at.track_id = t.id + WHERE at.artist_id = ar.artist_id + AND t.release_id = ar.release_id + ); END $$ ` -// DELETE FROM releases WHERE release_group_id NOT IN (SELECT t.release_group_id FROM tracks t); -// DELETE FROM releases WHERE release_group_id NOT IN (SELECT rg.id FROM release_groups rg); func (q *Queries) CleanOrphanedEntries(ctx context.Context) error { _, err := q.db.Exec(ctx, cleanOrphanedEntries) return err diff --git a/test_assets/koito_export_test.json b/test_assets/koito_export_test.json index b7ce463..e2cd8ea 100644 --- a/test_assets/koito_export_test.json +++ b/test_assets/koito_export_test.json @@ -18,7 +18,7 @@ }, "album": { "image_url": "https://cdn-images.dzcdn.net/images/cover/1f54d600d0ce5c88a6b2fd75659ec796/1000x1000-000000-80-0-0.jpg", - "mbid": null, + "mbid": "d0ec30bd-7cdc-417c-979d-5a0631b8a161", "aliases": [ { "alias": "American Football (LP3)", @@ -70,7 +70,7 @@ }, "album": { "image_url": "https://cdn-images.dzcdn.net/images/cover/1f54d600d0ce5c88a6b2fd75659ec796/1000x1000-000000-80-0-0.jpg", - "mbid": null, + "mbid": "d0ec30bd-7cdc-417c-979d-5a0631b8a161", "aliases": [ { "alias": "American Football (LP3)", @@ -122,7 +122,7 @@ }, "album": { "image_url": "https://cdn-images.dzcdn.net/images/cover/1f54d600d0ce5c88a6b2fd75659ec796/1000x1000-000000-80-0-0.jpg", - "mbid": null, + "mbid": "d0ec30bd-7cdc-417c-979d-5a0631b8a161", "aliases": [ { "alias": "American Football (LP3)", @@ -174,7 +174,7 @@ }, "album": { "image_url": "https://cdn-images.dzcdn.net/images/cover/1f54d600d0ce5c88a6b2fd75659ec796/1000x1000-000000-80-0-0.jpg", - "mbid": null, + "mbid": "d0ec30bd-7cdc-417c-979d-5a0631b8a161", "aliases": [ { "alias": "American Football (LP3)", @@ -226,7 +226,7 @@ }, "album": { "image_url": "https://cdn-images.dzcdn.net/images/cover/1f54d600d0ce5c88a6b2fd75659ec796/1000x1000-000000-80-0-0.jpg", - "mbid": null, + "mbid": "d0ec30bd-7cdc-417c-979d-5a0631b8a161", "aliases": [ { "alias": "American Football (LP3)", @@ -278,7 +278,7 @@ }, "album": { "image_url": "https://cdn-images.dzcdn.net/images/cover/1f54d600d0ce5c88a6b2fd75659ec796/1000x1000-000000-80-0-0.jpg", - "mbid": null, + "mbid": "d0ec30bd-7cdc-417c-979d-5a0631b8a161", "aliases": [ { "alias": "American Football (LP3)", @@ -330,7 +330,7 @@ }, "album": { "image_url": "https://cdn-images.dzcdn.net/images/cover/1f54d600d0ce5c88a6b2fd75659ec796/1000x1000-000000-80-0-0.jpg", - "mbid": null, + "mbid": "d0ec30bd-7cdc-417c-979d-5a0631b8a161", "aliases": [ { "alias": "American Football (LP3)", @@ -703,4 +703,4 @@ ] } ] -} \ No newline at end of file +} From 08fc9eed86d657bab524c4a52cb8b4569df172b4 Mon Sep 17 00:00:00 2001 From: Gabe Farrell <90876006+gabehf@users.noreply.github.com> Date: Thu, 22 Jan 2026 17:01:46 -0500 Subject: [PATCH 27/37] fix: correct interest bucket queries (#169) --- db/queries/interest.sql | 211 ++++++++++++--------------- internal/db/psql/interest.go | 26 ++-- internal/repository/interest.sql.go | 217 +++++++++++++--------------- 3 files changed, 204 insertions(+), 250 deletions(-) diff --git a/db/queries/interest.sql b/db/queries/interest.sql index 389c75b..874f4cd 100644 --- a/db/queries/interest.sql +++ b/db/queries/interest.sql @@ -1,162 +1,139 @@ -- name: GetGroupedListensFromArtist :many -WITH artist_listens AS ( +WITH bounds AS ( SELECT - l.listened_at + MIN(l.listened_at) AS start_time, + NOW() AS end_time FROM listens l JOIN tracks t ON t.id = l.track_id JOIN artist_tracks at ON at.track_id = t.id WHERE at.artist_id = $1 ), -bounds AS ( +stats AS ( SELECT - MIN(listened_at) AS start_time, - MAX(listened_at) AS end_time - FROM artist_listens + start_time, + end_time, + EXTRACT(EPOCH FROM (end_time - start_time)) AS total_seconds, + ((end_time - start_time) / sqlc.arg(bucket_count)::int) AS bucket_interval + FROM bounds ), -bucketed AS ( +bucket_series AS ( + SELECT generate_series(0, sqlc.arg(bucket_count)::int - 1) AS idx +), +listen_indices AS ( SELECT LEAST( - sqlc.arg(bucket_count) - 1, + sqlc.arg(bucket_count)::int - 1, FLOOR( - ( - EXTRACT(EPOCH FROM (al.listened_at - b.start_time)) - / - NULLIF(EXTRACT(EPOCH FROM (b.end_time - b.start_time)), 0) - ) * sqlc.arg(bucket_count) + (EXTRACT(EPOCH FROM (l.listened_at - s.start_time)) / NULLIF(s.total_seconds, 0)) + * sqlc.arg(bucket_count)::int )::int - ) AS bucket_idx, - b.start_time, - b.end_time - FROM artist_listens al - CROSS JOIN bounds b -), -aggregated AS ( - SELECT - start_time - + ( - bucket_idx * (end_time - start_time) - / sqlc.arg(bucket_count) - ) AS bucket_start, - start_time - + ( - (bucket_idx + 1) * (end_time - start_time) - / sqlc.arg(bucket_count) - ) AS bucket_end, - COUNT(*) AS listen_count - FROM bucketed - GROUP BY bucket_idx, start_time, end_time + ) AS bucket_idx + FROM listens l + JOIN tracks t ON t.id = l.track_id + JOIN artist_tracks at ON at.track_id = t.id + CROSS JOIN stats s + WHERE at.artist_id = $1 + AND s.start_time IS NOT NULL ) SELECT - bucket_start::timestamptz, - bucket_end::timestamptz, - listen_count -FROM aggregated -ORDER BY bucket_start; + (s.start_time + (s.bucket_interval * bs.idx))::timestamptz AS bucket_start, + (s.start_time + (s.bucket_interval * (bs.idx + 1)))::timestamptz AS bucket_end, + COUNT(li.bucket_idx) AS listen_count +FROM bucket_series bs +CROSS JOIN stats s +LEFT JOIN listen_indices li ON bs.idx = li.bucket_idx +WHERE s.start_time IS NOT NULL +GROUP BY bs.idx, s.start_time, s.bucket_interval +ORDER BY bs.idx; -- name: GetGroupedListensFromRelease :many -WITH artist_listens AS ( +WITH bounds AS ( SELECT - l.listened_at + MIN(l.listened_at) AS start_time, + NOW() AS end_time FROM listens l JOIN tracks t ON t.id = l.track_id WHERE t.release_id = $1 ), -bounds AS ( +stats AS ( SELECT - MIN(listened_at) AS start_time, - MAX(listened_at) AS end_time - FROM artist_listens + start_time, + end_time, + EXTRACT(EPOCH FROM (end_time - start_time)) AS total_seconds, + ((end_time - start_time) / sqlc.arg(bucket_count)::int) AS bucket_interval + FROM bounds ), -bucketed AS ( +bucket_series AS ( + SELECT generate_series(0, sqlc.arg(bucket_count)::int - 1) AS idx +), +listen_indices AS ( SELECT LEAST( - sqlc.arg(bucket_count) - 1, + sqlc.arg(bucket_count)::int - 1, FLOOR( - ( - EXTRACT(EPOCH FROM (al.listened_at - b.start_time)) - / - NULLIF(EXTRACT(EPOCH FROM (b.end_time - b.start_time)), 0) - ) * sqlc.arg(bucket_count) + (EXTRACT(EPOCH FROM (l.listened_at - s.start_time)) / NULLIF(s.total_seconds, 0)) + * sqlc.arg(bucket_count)::int )::int - ) AS bucket_idx, - b.start_time, - b.end_time - FROM artist_listens al - CROSS JOIN bounds b -), -aggregated AS ( - SELECT - start_time - + ( - bucket_idx * (end_time - start_time) - / sqlc.arg(bucket_count) - ) AS bucket_start, - start_time - + ( - (bucket_idx + 1) * (end_time - start_time) - / sqlc.arg(bucket_count) - ) AS bucket_end, - COUNT(*) AS listen_count - FROM bucketed - GROUP BY bucket_idx, start_time, end_time + ) AS bucket_idx + FROM listens l + JOIN tracks t ON t.id = l.track_id + CROSS JOIN stats s + WHERE t.release_id = $1 + AND s.start_time IS NOT NULL ) SELECT - bucket_start::timestamptz, - bucket_end::timestamptz, - listen_count -FROM aggregated -ORDER BY bucket_start; + (s.start_time + (s.bucket_interval * bs.idx))::timestamptz AS bucket_start, + (s.start_time + (s.bucket_interval * (bs.idx + 1)))::timestamptz AS bucket_end, + COUNT(li.bucket_idx) AS listen_count +FROM bucket_series bs +CROSS JOIN stats s +LEFT JOIN listen_indices li ON bs.idx = li.bucket_idx +WHERE s.start_time IS NOT NULL +GROUP BY bs.idx, s.start_time, s.bucket_interval +ORDER BY bs.idx; -- name: GetGroupedListensFromTrack :many -WITH artist_listens AS ( +WITH bounds AS ( SELECT - l.listened_at + MIN(l.listened_at) AS start_time, + NOW() AS end_time FROM listens l JOIN tracks t ON t.id = l.track_id WHERE t.id = $1 ), -bounds AS ( +stats AS ( SELECT - MIN(listened_at) AS start_time, - MAX(listened_at) AS end_time - FROM artist_listens + start_time, + end_time, + EXTRACT(EPOCH FROM (end_time - start_time)) AS total_seconds, + ((end_time - start_time) / sqlc.arg(bucket_count)::int) AS bucket_interval + FROM bounds ), -bucketed AS ( +bucket_series AS ( + SELECT generate_series(0, sqlc.arg(bucket_count)::int - 1) AS idx +), +listen_indices AS ( SELECT LEAST( - sqlc.arg(bucket_count) - 1, + sqlc.arg(bucket_count)::int - 1, FLOOR( - ( - EXTRACT(EPOCH FROM (al.listened_at - b.start_time)) - / - NULLIF(EXTRACT(EPOCH FROM (b.end_time - b.start_time)), 0) - ) * sqlc.arg(bucket_count) + (EXTRACT(EPOCH FROM (l.listened_at - s.start_time)) / NULLIF(s.total_seconds, 0)) + * sqlc.arg(bucket_count)::int )::int - ) AS bucket_idx, - b.start_time, - b.end_time - FROM artist_listens al - CROSS JOIN bounds b -), -aggregated AS ( - SELECT - start_time - + ( - bucket_idx * (end_time - start_time) - / sqlc.arg(bucket_count) - ) AS bucket_start, - start_time - + ( - (bucket_idx + 1) * (end_time - start_time) - / sqlc.arg(bucket_count) - ) AS bucket_end, - COUNT(*) AS listen_count - FROM bucketed - GROUP BY bucket_idx, start_time, end_time + ) AS bucket_idx + FROM listens l + JOIN tracks t ON t.id = l.track_id + CROSS JOIN stats s + WHERE t.id = $1 + AND s.start_time IS NOT NULL ) SELECT - bucket_start::timestamptz, - bucket_end::timestamptz, - listen_count -FROM aggregated -ORDER BY bucket_start; + (s.start_time + (s.bucket_interval * bs.idx))::timestamptz AS bucket_start, + (s.start_time + (s.bucket_interval * (bs.idx + 1)))::timestamptz AS bucket_end, + COUNT(li.bucket_idx) AS listen_count +FROM bucket_series bs +CROSS JOIN stats s +LEFT JOIN listen_indices li ON bs.idx = li.bucket_idx +WHERE s.start_time IS NOT NULL +GROUP BY bs.idx, s.start_time, s.bucket_interval +ORDER BY bs.idx; diff --git a/internal/db/psql/interest.go b/internal/db/psql/interest.go index 9e8a623..0c8f4eb 100644 --- a/internal/db/psql/interest.go +++ b/internal/db/psql/interest.go @@ -14,54 +14,54 @@ func (d *Psql) GetInterest(ctx context.Context, opts db.GetInterestOpts) ([]db.I return nil, errors.New("GetInterest: bucket count must be provided") } - ret := make([]db.InterestBucket, opts.Buckets) + ret := make([]db.InterestBucket, 0) if opts.ArtistID != 0 { resp, err := d.q.GetGroupedListensFromArtist(ctx, repository.GetGroupedListensFromArtistParams{ ArtistID: opts.ArtistID, - BucketCount: opts.Buckets, + BucketCount: int32(opts.Buckets), }) if err != nil { return nil, fmt.Errorf("GetInterest: GetGroupedListensFromArtist: %w", err) } - for i, v := range resp { - ret[i] = db.InterestBucket{ + for _, v := range resp { + ret = append(ret, db.InterestBucket{ BucketStart: v.BucketStart, BucketEnd: v.BucketEnd, ListenCount: v.ListenCount, - } + }) } return ret, nil } else if opts.AlbumID != 0 { resp, err := d.q.GetGroupedListensFromRelease(ctx, repository.GetGroupedListensFromReleaseParams{ ReleaseID: opts.AlbumID, - BucketCount: opts.Buckets, + BucketCount: int32(opts.Buckets), }) if err != nil { return nil, fmt.Errorf("GetInterest: GetGroupedListensFromRelease: %w", err) } - for i, v := range resp { - ret[i] = db.InterestBucket{ + for _, v := range resp { + ret = append(ret, db.InterestBucket{ BucketStart: v.BucketStart, BucketEnd: v.BucketEnd, ListenCount: v.ListenCount, - } + }) } return ret, nil } else if opts.TrackID != 0 { resp, err := d.q.GetGroupedListensFromTrack(ctx, repository.GetGroupedListensFromTrackParams{ ID: opts.TrackID, - BucketCount: opts.Buckets, + BucketCount: int32(opts.Buckets), }) if err != nil { return nil, fmt.Errorf("GetInterest: GetGroupedListensFromTrack: %w", err) } - for i, v := range resp { - ret[i] = db.InterestBucket{ + for _, v := range resp { + ret = append(ret, db.InterestBucket{ BucketStart: v.BucketStart, BucketEnd: v.BucketEnd, ListenCount: v.ListenCount, - } + }) } return ret, nil } else { diff --git a/internal/repository/interest.sql.go b/internal/repository/interest.sql.go index 27c1920..ae77764 100644 --- a/internal/repository/interest.sql.go +++ b/internal/repository/interest.sql.go @@ -11,64 +11,57 @@ import ( ) const getGroupedListensFromArtist = `-- name: GetGroupedListensFromArtist :many -WITH artist_listens AS ( +WITH bounds AS ( SELECT - l.listened_at + MIN(l.listened_at) AS start_time, + NOW() AS end_time FROM listens l JOIN tracks t ON t.id = l.track_id JOIN artist_tracks at ON at.track_id = t.id WHERE at.artist_id = $1 ), -bounds AS ( +stats AS ( SELECT - MIN(listened_at) AS start_time, - MAX(listened_at) AS end_time - FROM artist_listens + start_time, + end_time, + EXTRACT(EPOCH FROM (end_time - start_time)) AS total_seconds, + ((end_time - start_time) / $2::int) AS bucket_interval + FROM bounds ), -bucketed AS ( +bucket_series AS ( + SELECT generate_series(0, $2::int - 1) AS idx +), +listen_indices AS ( SELECT LEAST( - $2 - 1, + $2::int - 1, FLOOR( - ( - EXTRACT(EPOCH FROM (al.listened_at - b.start_time)) - / - NULLIF(EXTRACT(EPOCH FROM (b.end_time - b.start_time)), 0) - ) * $2 + (EXTRACT(EPOCH FROM (l.listened_at - s.start_time)) / NULLIF(s.total_seconds, 0)) + * $2::int )::int - ) AS bucket_idx, - b.start_time, - b.end_time - FROM artist_listens al - CROSS JOIN bounds b -), -aggregated AS ( - SELECT - start_time - + ( - bucket_idx * (end_time - start_time) - / $2 - ) AS bucket_start, - start_time - + ( - (bucket_idx + 1) * (end_time - start_time) - / $2 - ) AS bucket_end, - COUNT(*) AS listen_count - FROM bucketed - GROUP BY bucket_idx, start_time, end_time + ) AS bucket_idx + FROM listens l + JOIN tracks t ON t.id = l.track_id + JOIN artist_tracks at ON at.track_id = t.id + CROSS JOIN stats s + WHERE at.artist_id = $1 + AND s.start_time IS NOT NULL ) SELECT - bucket_start::timestamptz, - bucket_end::timestamptz, - listen_count -FROM aggregated -ORDER BY bucket_start + (s.start_time + (s.bucket_interval * bs.idx))::timestamptz AS bucket_start, + (s.start_time + (s.bucket_interval * (bs.idx + 1)))::timestamptz AS bucket_end, + COUNT(li.bucket_idx) AS listen_count +FROM bucket_series bs +CROSS JOIN stats s +LEFT JOIN listen_indices li ON bs.idx = li.bucket_idx +WHERE s.start_time IS NOT NULL +GROUP BY bs.idx, s.start_time, s.bucket_interval +ORDER BY bs.idx ` type GetGroupedListensFromArtistParams struct { ArtistID int32 - BucketCount interface{} + BucketCount int32 } type GetGroupedListensFromArtistRow struct { @@ -98,63 +91,55 @@ func (q *Queries) GetGroupedListensFromArtist(ctx context.Context, arg GetGroupe } const getGroupedListensFromRelease = `-- name: GetGroupedListensFromRelease :many -WITH artist_listens AS ( +WITH bounds AS ( SELECT - l.listened_at + MIN(l.listened_at) AS start_time, + NOW() AS end_time FROM listens l JOIN tracks t ON t.id = l.track_id WHERE t.release_id = $1 ), -bounds AS ( +stats AS ( SELECT - MIN(listened_at) AS start_time, - MAX(listened_at) AS end_time - FROM artist_listens + start_time, + end_time, + EXTRACT(EPOCH FROM (end_time - start_time)) AS total_seconds, + ((end_time - start_time) / $2::int) AS bucket_interval + FROM bounds ), -bucketed AS ( +bucket_series AS ( + SELECT generate_series(0, $2::int - 1) AS idx +), +listen_indices AS ( SELECT LEAST( - $2 - 1, + $2::int - 1, FLOOR( - ( - EXTRACT(EPOCH FROM (al.listened_at - b.start_time)) - / - NULLIF(EXTRACT(EPOCH FROM (b.end_time - b.start_time)), 0) - ) * $2 + (EXTRACT(EPOCH FROM (l.listened_at - s.start_time)) / NULLIF(s.total_seconds, 0)) + * $2::int )::int - ) AS bucket_idx, - b.start_time, - b.end_time - FROM artist_listens al - CROSS JOIN bounds b -), -aggregated AS ( - SELECT - start_time - + ( - bucket_idx * (end_time - start_time) - / $2 - ) AS bucket_start, - start_time - + ( - (bucket_idx + 1) * (end_time - start_time) - / $2 - ) AS bucket_end, - COUNT(*) AS listen_count - FROM bucketed - GROUP BY bucket_idx, start_time, end_time + ) AS bucket_idx + FROM listens l + JOIN tracks t ON t.id = l.track_id + CROSS JOIN stats s + WHERE t.release_id = $1 + AND s.start_time IS NOT NULL ) SELECT - bucket_start::timestamptz, - bucket_end::timestamptz, - listen_count -FROM aggregated -ORDER BY bucket_start + (s.start_time + (s.bucket_interval * bs.idx))::timestamptz AS bucket_start, + (s.start_time + (s.bucket_interval * (bs.idx + 1)))::timestamptz AS bucket_end, + COUNT(li.bucket_idx) AS listen_count +FROM bucket_series bs +CROSS JOIN stats s +LEFT JOIN listen_indices li ON bs.idx = li.bucket_idx +WHERE s.start_time IS NOT NULL +GROUP BY bs.idx, s.start_time, s.bucket_interval +ORDER BY bs.idx ` type GetGroupedListensFromReleaseParams struct { ReleaseID int32 - BucketCount interface{} + BucketCount int32 } type GetGroupedListensFromReleaseRow struct { @@ -184,63 +169,55 @@ func (q *Queries) GetGroupedListensFromRelease(ctx context.Context, arg GetGroup } const getGroupedListensFromTrack = `-- name: GetGroupedListensFromTrack :many -WITH artist_listens AS ( +WITH bounds AS ( SELECT - l.listened_at + MIN(l.listened_at) AS start_time, + NOW() AS end_time FROM listens l JOIN tracks t ON t.id = l.track_id WHERE t.id = $1 ), -bounds AS ( +stats AS ( SELECT - MIN(listened_at) AS start_time, - MAX(listened_at) AS end_time - FROM artist_listens + start_time, + end_time, + EXTRACT(EPOCH FROM (end_time - start_time)) AS total_seconds, + ((end_time - start_time) / $2::int) AS bucket_interval + FROM bounds ), -bucketed AS ( +bucket_series AS ( + SELECT generate_series(0, $2::int - 1) AS idx +), +listen_indices AS ( SELECT LEAST( - $2 - 1, + $2::int - 1, FLOOR( - ( - EXTRACT(EPOCH FROM (al.listened_at - b.start_time)) - / - NULLIF(EXTRACT(EPOCH FROM (b.end_time - b.start_time)), 0) - ) * $2 + (EXTRACT(EPOCH FROM (l.listened_at - s.start_time)) / NULLIF(s.total_seconds, 0)) + * $2::int )::int - ) AS bucket_idx, - b.start_time, - b.end_time - FROM artist_listens al - CROSS JOIN bounds b -), -aggregated AS ( - SELECT - start_time - + ( - bucket_idx * (end_time - start_time) - / $2 - ) AS bucket_start, - start_time - + ( - (bucket_idx + 1) * (end_time - start_time) - / $2 - ) AS bucket_end, - COUNT(*) AS listen_count - FROM bucketed - GROUP BY bucket_idx, start_time, end_time + ) AS bucket_idx + FROM listens l + JOIN tracks t ON t.id = l.track_id + CROSS JOIN stats s + WHERE t.id = $1 + AND s.start_time IS NOT NULL ) SELECT - bucket_start::timestamptz, - bucket_end::timestamptz, - listen_count -FROM aggregated -ORDER BY bucket_start + (s.start_time + (s.bucket_interval * bs.idx))::timestamptz AS bucket_start, + (s.start_time + (s.bucket_interval * (bs.idx + 1)))::timestamptz AS bucket_end, + COUNT(li.bucket_idx) AS listen_count +FROM bucket_series bs +CROSS JOIN stats s +LEFT JOIN listen_indices li ON bs.idx = li.bucket_idx +WHERE s.start_time IS NOT NULL +GROUP BY bs.idx, s.start_time, s.bucket_interval +ORDER BY bs.idx ` type GetGroupedListensFromTrackParams struct { ID int32 - BucketCount interface{} + BucketCount int32 } type GetGroupedListensFromTrackRow struct { From 1ed055d0986e1c3c15424a501a544f4b88a51542 Mon Sep 17 00:00:00 2001 From: Gabe Farrell <90876006+gabehf@users.noreply.github.com> Date: Thu, 22 Jan 2026 21:31:14 -0500 Subject: [PATCH 28/37] fix: ui tweaks and fixes (#170) * add subtle gradient to home page * tweak autumn theme primary color * reduce home page top margin on mobile * use focus-active instead of focus for outline * fix gradient on rewind page * align checkbox on login form * i forgot what the pseudo class was called --- client/app/app.css | 10 +++++----- client/app/components/modals/LoginForm.tsx | 2 +- client/app/routes/Home.tsx | 16 ++++++++-------- client/app/routes/RewindPage.tsx | 2 +- client/app/styles/themes.css.ts | 2 +- 5 files changed, 16 insertions(+), 16 deletions(-) diff --git a/client/app/app.css b/client/app/app.css index eb5e7f6..bc60042 100644 --- a/client/app/app.css +++ b/client/app/app.css @@ -138,11 +138,11 @@ textarea { input[type="checkbox"] { height: fit-content; } -input:focus, -button:focus, -a:focus, -select:focus, -textarea:focus { +input:focus-visible, +button:focus-visible, +a:focus-visible, +select:focus-visible, +textarea:focus-visible { border-color: transparent; outline: 2px solid var(--color-fg-tertiary); } diff --git a/client/app/components/modals/LoginForm.tsx b/client/app/components/modals/LoginForm.tsx index 66ae6cb..1078476 100644 --- a/client/app/components/modals/LoginForm.tsx +++ b/client/app/components/modals/LoginForm.tsx @@ -54,7 +54,7 @@ export default function LoginForm() { className="w-full mx-auto fg bg rounded p-2" onChange={(e) => setPassword(e.target.value)} /> -
+
-
+
+
@@ -33,7 +30,10 @@ export default function Home() { - +
diff --git a/client/app/routes/RewindPage.tsx b/client/app/routes/RewindPage.tsx index 71a1ef6..4d60065 100644 --- a/client/app/routes/RewindPage.tsx +++ b/client/app/routes/RewindPage.tsx @@ -59,7 +59,7 @@ export default function RewindPage() { useEffect(() => { if (!stats.top_artists[0]) return; - const img = (stats.top_artists[0] as any)?.image; + const img = (stats.top_artists[0] as any)?.item.image; if (!img) return; average(imageUrl(img, "small"), { amount: 1 }).then((color) => { diff --git a/client/app/styles/themes.css.ts b/client/app/styles/themes.css.ts index d5390ae..1a3a57d 100644 --- a/client/app/styles/themes.css.ts +++ b/client/app/styles/themes.css.ts @@ -92,7 +92,7 @@ export const themes: Record = { fg: "#fef9f3", fgSecondary: "#dbc6b0", fgTertiary: "#a3917a", - primary: "#d97706", + primary: "#F0850A", primaryDim: "#b45309", accent: "#8c4c28", accentDim: "#6b3b1f", From 937f9062b546a68bc045cf7749a0810a02a06fd8 Mon Sep 17 00:00:00 2001 From: Gabe Farrell <90876006+gabehf@users.noreply.github.com> Date: Sat, 24 Jan 2026 13:19:04 -0500 Subject: [PATCH 29/37] fix: include time zone name overrides and add KOITO_FORCE_TZ cfg option (#176) * timezone overrides and force_tz option * docs for force_tz * add link to time zone names in docs --- .../content/docs/reference/configuration.md | 2 + engine/engine.go | 4 + engine/handlers/handlers.go | 133 +++++++++++++++++- internal/cfg/cfg.go | 15 ++ 4 files changed, 153 insertions(+), 1 deletion(-) diff --git a/docs/src/content/docs/reference/configuration.md b/docs/src/content/docs/reference/configuration.md index 6eae82b..2af573c 100644 --- a/docs/src/content/docs/reference/configuration.md +++ b/docs/src/content/docs/reference/configuration.md @@ -64,6 +64,8 @@ If the environment variable is defined without **and** with the suffix at the sa ##### KOITO_CONFIG_DIR - Default: `/etc/koito` - Description: The location where import folders and image caches are stored. +##### KOITO_FORCE_TZ +- Description: A canonical IANA database time zone name (https://en.wikipedia.org/wiki/List_of_tz_database_time_zones) that Koito will use to serve all clients. Overrides any timezones requested via a `tz` cookie or `tz` query parameter. Koito will fail to start if this value is invalid. ##### KOITO_DISABLE_DEEZER - Default: `false` - Description: Disables Deezer as a source for finding artist and album images. diff --git a/engine/engine.go b/engine/engine.go index 7de9254..979667e 100644 --- a/engine/engine.go +++ b/engine/engine.go @@ -96,6 +96,10 @@ func Run( defer store.Close(ctx) l.Info().Msg("Engine: Database connection established") + if cfg.ForceTZ() != nil { + l.Debug().Msgf("Engine: Forcing the use of timezone '%s'", cfg.ForceTZ().String()) + } + l.Debug().Msg("Engine: Initializing MusicBrainz client") var mbzC mbz.MusicBrainzCaller if !cfg.MusicBrainzDisabled() { diff --git a/engine/handlers/handlers.go b/engine/handlers/handlers.go index 06127aa..78bc228 100644 --- a/engine/handlers/handlers.go +++ b/engine/handlers/handlers.go @@ -6,7 +6,9 @@ import ( "strconv" "strings" "time" + _ "time/tzdata" + "github.com/gabehf/koito/internal/cfg" "github.com/gabehf/koito/internal/db" "github.com/gabehf/koito/internal/logger" ) @@ -107,14 +109,143 @@ func TimeframeFromRequest(r *http.Request) db.Timeframe { func parseTZ(r *http.Request) *time.Location { + // this map is obviously AI. + // i manually referenced as many links as I could and couldn't find any + // incorrect entries here so hopefully it is all correct. + overrides := map[string]string{ + // --- North America --- + "America/Indianapolis": "America/Indiana/Indianapolis", + "America/Knoxville": "America/Indiana/Knoxville", + "America/Louisville": "America/Kentucky/Louisville", + "America/Montreal": "America/Toronto", + "America/Shiprock": "America/Denver", + "America/Fort_Wayne": "America/Indiana/Indianapolis", + "America/Virgin": "America/Port_of_Spain", + "America/Santa_Isabel": "America/Tijuana", + "America/Ensenada": "America/Tijuana", + "America/Rosario": "America/Argentina/Cordoba", + "America/Jujuy": "America/Argentina/Jujuy", + "America/Mendoza": "America/Argentina/Mendoza", + "America/Catamarca": "America/Argentina/Catamarca", + "America/Cordoba": "America/Argentina/Cordoba", + "America/Buenos_Aires": "America/Argentina/Buenos_Aires", + "America/Coral_Harbour": "America/Atikokan", + "America/Atka": "America/Adak", + "US/Alaska": "America/Anchorage", + "US/Aleutian": "America/Adak", + "US/Arizona": "America/Phoenix", + "US/Central": "America/Chicago", + "US/Eastern": "America/New_York", + "US/East-Indiana": "America/Indiana/Indianapolis", + "US/Hawaii": "Pacific/Honolulu", + "US/Indiana-Starke": "America/Indiana/Knoxville", + "US/Michigan": "America/Detroit", + "US/Mountain": "America/Denver", + "US/Pacific": "America/Los_Angeles", + "US/Samoa": "Pacific/Pago_Pago", + "Canada/Atlantic": "America/Halifax", + "Canada/Central": "America/Winnipeg", + "Canada/Eastern": "America/Toronto", + "Canada/Mountain": "America/Edmonton", + "Canada/Newfoundland": "America/St_Johns", + "Canada/Pacific": "America/Vancouver", + + // --- Asia --- + "Asia/Calcutta": "Asia/Kolkata", + "Asia/Saigon": "Asia/Ho_Chi_Minh", + "Asia/Katmandu": "Asia/Kathmandu", + "Asia/Rangoon": "Asia/Yangon", + "Asia/Ulan_Bator": "Asia/Ulaanbaatar", + "Asia/Macao": "Asia/Macau", + "Asia/Tel_Aviv": "Asia/Jerusalem", + "Asia/Ashkhabad": "Asia/Ashgabat", + "Asia/Chungking": "Asia/Chongqing", + "Asia/Dacca": "Asia/Dhaka", + "Asia/Istanbul": "Europe/Istanbul", + "Asia/Kashgar": "Asia/Urumqi", + "Asia/Thimbu": "Asia/Thimphu", + "Asia/Ujung_Pandang": "Asia/Makassar", + "ROC": "Asia/Taipei", + "Iran": "Asia/Tehran", + "Israel": "Asia/Jerusalem", + "Japan": "Asia/Tokyo", + "Singapore": "Asia/Singapore", + "Hongkong": "Asia/Hong_Kong", + + // --- Europe --- + "Europe/Kiev": "Europe/Kyiv", + "Europe/Belfast": "Europe/London", + "Europe/Tiraspol": "Europe/Chisinau", + "Europe/Nicosia": "Asia/Nicosia", + "Europe/Moscow": "Europe/Moscow", + "W-SU": "Europe/Moscow", + "GB": "Europe/London", + "GB-Eire": "Europe/London", + "Eire": "Europe/Dublin", + "Poland": "Europe/Warsaw", + "Portugal": "Europe/Lisbon", + "Turkey": "Europe/Istanbul", + + // --- Australia / Pacific --- + "Australia/ACT": "Australia/Sydney", + "Australia/Canberra": "Australia/Sydney", + "Australia/LHI": "Australia/Lord_Howe", + "Australia/North": "Australia/Darwin", + "Australia/NSW": "Australia/Sydney", + "Australia/Queensland": "Australia/Brisbane", + "Australia/South": "Australia/Adelaide", + "Australia/Tasmania": "Australia/Hobart", + "Australia/Victoria": "Australia/Melbourne", + "Australia/West": "Australia/Perth", + "Australia/Yancowinna": "Australia/Broken_Hill", + "Pacific/Samoa": "Pacific/Pago_Pago", + "Pacific/Yap": "Pacific/Chuuk", + "Pacific/Truk": "Pacific/Chuuk", + "Pacific/Ponape": "Pacific/Pohnpei", + "NZ": "Pacific/Auckland", + "NZ-CHAT": "Pacific/Chatham", + + // --- Africa --- + "Africa/Asmera": "Africa/Asmara", + "Africa/Timbuktu": "Africa/Bamako", + "Egypt": "Africa/Cairo", + "Libya": "Africa/Tripoli", + + // --- Atlantic --- + "Atlantic/Faeroe": "Atlantic/Faroe", + "Atlantic/Jan_Mayen": "Europe/Oslo", + "Iceland": "Atlantic/Reykjavik", + + // --- Etc / Misc --- + "UTC": "UTC", + "Etc/UTC": "UTC", + "Etc/GMT": "UTC", + "GMT": "UTC", + "Zulu": "UTC", + "Universal": "UTC", + } + + if cfg.ForceTZ() != nil { + return cfg.ForceTZ() + } + if tz := r.URL.Query().Get("tz"); tz != "" { + if fixedTz, exists := overrides[tz]; exists { + tz = fixedTz + } if loc, err := time.LoadLocation(tz); err == nil { return loc } } if c, err := r.Cookie("tz"); err == nil { - if loc, err := time.LoadLocation(c.Value); err == nil { + var tz string + if fixedTz, exists := overrides[c.Value]; exists { + tz = fixedTz + } else { + tz = c.Value + } + if loc, err := time.LoadLocation(tz); err == nil { return loc } } diff --git a/internal/cfg/cfg.go b/internal/cfg/cfg.go index 36478b1..e74d6b9 100644 --- a/internal/cfg/cfg.go +++ b/internal/cfg/cfg.go @@ -49,6 +49,7 @@ const ( FETCH_IMAGES_DURING_IMPORT_ENV = "KOITO_FETCH_IMAGES_DURING_IMPORT" ARTIST_SEPARATORS_ENV = "KOITO_ARTIST_SEPARATORS_REGEX" LOGIN_GATE_ENV = "KOITO_LOGIN_GATE" + FORCE_TZ = "KOITO_FORCE_TZ" ) type config struct { @@ -87,6 +88,7 @@ type config struct { importAfter time.Time artistSeparators []*regexp.Regexp loginGate bool + forceTZ *time.Location } var ( @@ -213,6 +215,13 @@ func loadConfig(getenv func(string) string, version string) (*config, error) { cfg.loginGate = true } + if getenv(FORCE_TZ) != "" { + cfg.forceTZ, err = time.LoadLocation(getenv(FORCE_TZ)) + if err != nil { + return nil, fmt.Errorf("forced timezone '%s' is not a valid timezone", getenv(FORCE_TZ)) + } + } + switch strings.ToLower(getenv(LOG_LEVEL_ENV)) { case "debug": cfg.logLevel = 0 @@ -430,3 +439,9 @@ func LoginGate() bool { defer lock.RUnlock() return globalConfig.loginGate } + +func ForceTZ() *time.Location { + lock.RLock() + defer lock.RUnlock() + return globalConfig.forceTZ +} From c8a11ef018461f14a5e7c9fcf8fb69cfed0d7d0f Mon Sep 17 00:00:00 2001 From: Gabe Farrell <90876006+gabehf@users.noreply.github.com> Date: Sun, 25 Jan 2026 15:51:07 -0500 Subject: [PATCH 30/37] fix: ensure mbids in mbidmapping are discovered (#180) --- engine/import_test.go | 28 ++++++++++++++++++ internal/importer/listenbrainz.go | 19 ++++++++++-- test_assets/listenbrainz_shoko1_123456789.zip | Bin 0 -> 3184 bytes 3 files changed, 44 insertions(+), 3 deletions(-) create mode 100644 test_assets/listenbrainz_shoko1_123456789.zip diff --git a/engine/import_test.go b/engine/import_test.go index bb5c18e..fa69e73 100644 --- a/engine/import_test.go +++ b/engine/import_test.go @@ -264,6 +264,34 @@ func TestImportListenBrainz_MbzDisabled(t *testing.T) { truncateTestData(t) } +func TestImportListenBrainz_MBIDMapping(t *testing.T) { + + src := path.Join("..", "test_assets", "listenbrainz_shoko1_123456789.zip") + destDir := filepath.Join(cfg.ConfigDir(), "import") + dest := filepath.Join(destDir, "listenbrainz_shoko1_123456789.zip") + + // not going to make the dest dir because engine should make it already + + input, err := os.ReadFile(src) + require.NoError(t, err) + + require.NoError(t, os.WriteFile(dest, input, os.ModePerm)) + + engine.RunImporter(logger.Get(), store, &mbz.MbzErrorCaller{}) + + album, err := store.GetAlbum(context.Background(), db.GetAlbumOpts{MusicBrainzID: uuid.MustParse("177ebc28-0115-3897-8eb3-ebf74ce23790")}) + require.NoError(t, err) + assert.Equal(t, "Zombie", album.Title) + artist, err := store.GetArtist(context.Background(), db.GetArtistOpts{MusicBrainzID: uuid.MustParse("c98d40fd-f6cf-4b26-883e-eaa515ee2851")}) + require.NoError(t, err) + assert.Equal(t, "The Cranberries", artist.Name) + track, err := store.GetTrack(context.Background(), db.GetTrackOpts{MusicBrainzID: uuid.MustParse("3bbeb4e3-ab6d-460d-bfc5-de49e4251061")}) + require.NoError(t, err) + assert.Equal(t, "Zombie", track.Title) + + truncateTestData(t) +} + func TestImportKoito(t *testing.T) { src := path.Join("..", "test_assets", "koito_export_test.json") diff --git a/internal/importer/listenbrainz.go b/internal/importer/listenbrainz.go index 4187bbb..7c1a8bb 100644 --- a/internal/importer/listenbrainz.go +++ b/internal/importer/listenbrainz.go @@ -85,7 +85,14 @@ func ImportListenBrainzFile(ctx context.Context, store db.DB, mbzc mbz.MusicBrai } artistMbzIDs, err := utils.ParseUUIDSlice(payload.TrackMeta.AdditionalInfo.ArtistMBIDs) if err != nil { - l.Debug().Err(err).Msg("Failed to parse one or more uuids") + l.Debug().AnErr("error", err).Msg("ImportListenBrainzFile: Failed to parse one or more UUIDs") + } + if len(artistMbzIDs) < 1 { + l.Debug().AnErr("error", err).Msg("ImportListenBrainzFile: Attempting to parse artist UUIDs from mbid_mapping") + utils.ParseUUIDSlice(payload.TrackMeta.MBIDMapping.ArtistMBIDs) + if err != nil { + l.Debug().AnErr("error", err).Msg("ImportListenBrainzFile: Failed to parse one or more UUIDs") + } } rgMbzID, err := uuid.Parse(payload.TrackMeta.AdditionalInfo.ReleaseGroupMBID) if err != nil { @@ -93,11 +100,17 @@ func ImportListenBrainzFile(ctx context.Context, store db.DB, mbzc mbz.MusicBrai } releaseMbzID, err := uuid.Parse(payload.TrackMeta.AdditionalInfo.ReleaseMBID) if err != nil { - releaseMbzID = uuid.Nil + releaseMbzID, err = uuid.Parse(payload.TrackMeta.MBIDMapping.ReleaseMBID) + if err != nil { + releaseMbzID = uuid.Nil + } } recordingMbzID, err := uuid.Parse(payload.TrackMeta.AdditionalInfo.RecordingMBID) if err != nil { - recordingMbzID = uuid.Nil + recordingMbzID, err = uuid.Parse(payload.TrackMeta.MBIDMapping.RecordingMBID) + if err != nil { + recordingMbzID = uuid.Nil + } } var client string diff --git a/test_assets/listenbrainz_shoko1_123456789.zip b/test_assets/listenbrainz_shoko1_123456789.zip new file mode 100644 index 0000000000000000000000000000000000000000..14c97a2a104dca68ccb2e810fe24cd5039754322 GIT binary patch literal 3184 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 INq@fm2g3obEdT%j literal 0 HcmV?d00001 From 35e104c97e586e11fa36c1cc1094677f754c1acd Mon Sep 17 00:00:00 2001 From: Gabe Farrell <90876006+gabehf@users.noreply.github.com> Date: Mon, 26 Jan 2026 13:03:27 -0500 Subject: [PATCH 31/37] fix: gradient background on top charts (#181) --- client/app/routes/Charts/ChartLayout.tsx | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/client/app/routes/Charts/ChartLayout.tsx b/client/app/routes/Charts/ChartLayout.tsx index 02ee9bd..446f7d1 100644 --- a/client/app/routes/Charts/ChartLayout.tsx +++ b/client/app/routes/Charts/ChartLayout.tsx @@ -40,7 +40,7 @@ export default function ChartLayout({ useEffect(() => { if ((data?.items?.length ?? 0) === 0) return; - const img = (data.items[0] as any)?.image; + const img = (data.items[0] as any)?.item.image; if (!img) return; average(imageUrl(img, "small"), { amount: 1 }).then((color) => { From bf1c03e9fdfbeafc3c954ee151ca714b945d4e59 Mon Sep 17 00:00:00 2001 From: PythonGermany <97847597+PythonGermany@users.noreply.github.com> Date: Mon, 26 Jan 2026 19:43:01 +0100 Subject: [PATCH 32/37] docs: fix typo in index.mdx (#182) --- docs/src/content/docs/index.mdx | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/src/content/docs/index.mdx b/docs/src/content/docs/index.mdx index a4d1858..f590ebb 100644 --- a/docs/src/content/docs/index.mdx +++ b/docs/src/content/docs/index.mdx @@ -28,7 +28,7 @@ import { Card, CardGrid } from '@astrojs/starlight/components'; Koito can be connected to any music server or client that allows for custom ListenBrainz URLs. - Automatically relay listens submitted to your Koito instance to other ListenBrainz compatble servers. + Automatically relay listens submitted to your Koito instance to other ListenBrainz compatible servers. Koito automatically fetches data from MusicBrainz and images from Deezer and Cover Art Archive to compliment what is provided by your music server. From 42b32c79201260a5b251841cf371b2c5b58b9a52 Mon Sep 17 00:00:00 2001 From: Gabe Farrell <90876006+gabehf@users.noreply.github.com> Date: Mon, 26 Jan 2026 13:48:43 -0500 Subject: [PATCH 33/37] feat: add api key auth to web api (#183) --- engine/long_test.go | 32 +++++ engine/middleware/authenticate.go | 167 ++++++++++++++++++++++++ engine/middleware/validate.go | 125 ------------------ engine/routes.go | 12 +- internal/cfg/cfg.go | 201 ----------------------------- internal/cfg/getters.go | 206 ++++++++++++++++++++++++++++++ internal/cfg/setters.go | 7 + 7 files changed, 418 insertions(+), 332 deletions(-) create mode 100644 engine/middleware/authenticate.go delete mode 100644 engine/middleware/validate.go create mode 100644 internal/cfg/getters.go create mode 100644 internal/cfg/setters.go diff --git a/engine/long_test.go b/engine/long_test.go index 2ef5d4b..d916117 100644 --- a/engine/long_test.go +++ b/engine/long_test.go @@ -356,6 +356,38 @@ func TestDelete(t *testing.T) { truncateTestData(t) } +func TestLoginGate(t *testing.T) { + + t.Run("Submit Listens", doSubmitListens) + + req, err := http.NewRequest("DELETE", host()+"/apis/web/v1/artist?id=1", nil) + require.NoError(t, err) + req.Header.Add("Authorization", "Token "+apikey) + resp, err := http.DefaultClient.Do(req) + assert.NoError(t, err) + assert.Equal(t, 204, resp.StatusCode) + + cfg.SetLoginGate(true) + + req, err = http.NewRequest("GET", host()+"/apis/web/v1/artist?id=3", nil) + require.NoError(t, err) + // req.Header.Add("Authorization", "Token "+apikey) + resp, err = http.DefaultClient.Do(req) + assert.NoError(t, err) + assert.Equal(t, 401, resp.StatusCode) + + req, err = http.NewRequest("GET", host()+"/apis/web/v1/artist?id=3", nil) + require.NoError(t, err) + req.Header.Add("Authorization", "Token "+apikey) + resp, err = http.DefaultClient.Do(req) + assert.NoError(t, err) + assert.Equal(t, 200, resp.StatusCode) + + cfg.SetLoginGate(false) + + truncateTestData(t) +} + func TestAliasesAndSearch(t *testing.T) { t.Run("Submit Listens", doSubmitListens) diff --git a/engine/middleware/authenticate.go b/engine/middleware/authenticate.go new file mode 100644 index 0000000..a435473 --- /dev/null +++ b/engine/middleware/authenticate.go @@ -0,0 +1,167 @@ +package middleware + +import ( + "context" + "errors" + "fmt" + "net/http" + "strings" + "time" + + "github.com/gabehf/koito/internal/cfg" + "github.com/gabehf/koito/internal/db" + "github.com/gabehf/koito/internal/logger" + "github.com/gabehf/koito/internal/models" + "github.com/gabehf/koito/internal/utils" + "github.com/google/uuid" +) + +type MiddlwareContextKey string + +const ( + UserContextKey MiddlwareContextKey = "user" + apikeyContextKey MiddlwareContextKey = "apikeyID" +) + +type AuthMode int + +const ( + AuthModeSessionCookie AuthMode = iota + AuthModeAPIKey + AuthModeSessionOrAPIKey + AuthModeLoginGate +) + +func Authenticate(store db.DB, mode AuthMode) func(http.Handler) http.Handler { + return func(next http.Handler) http.Handler { + return http.HandlerFunc(func(w http.ResponseWriter, r *http.Request) { + ctx := r.Context() + l := logger.FromContext(ctx) + + var user *models.User + var err error + + switch mode { + case AuthModeSessionCookie: + user, err = validateSession(ctx, store, r) + + case AuthModeAPIKey: + user, err = validateAPIKey(ctx, store, r) + + case AuthModeSessionOrAPIKey: + user, err = validateSession(ctx, store, r) + if err != nil || user == nil { + user, err = validateAPIKey(ctx, store, r) + } + + case AuthModeLoginGate: + if cfg.LoginGate() { + user, err = validateSession(ctx, store, r) + if err != nil || user == nil { + user, err = validateAPIKey(ctx, store, r) + } + } else { + next.ServeHTTP(w, r) + } + } + + if err != nil { + l.Err(err).Msg("authentication failed") + utils.WriteError(w, "unauthorized", http.StatusUnauthorized) + return + } + + if user == nil { + utils.WriteError(w, "unauthorized", http.StatusUnauthorized) + return + } + + if user != nil { + ctx = context.WithValue(ctx, UserContextKey, user) + r = r.WithContext(ctx) + } + + next.ServeHTTP(w, r) + }) + } +} + +func validateSession(ctx context.Context, store db.DB, r *http.Request) (*models.User, error) { + l := logger.FromContext(r.Context()) + + l.Debug().Msgf("ValidateSession: Checking user authentication via session cookie") + + cookie, err := r.Cookie("koito_session") + var sid uuid.UUID + if err == nil { + sid, err = uuid.Parse(cookie.Value) + if err != nil { + l.Err(err).Msg("ValidateSession: Could not parse UUID from session cookie") + return nil, errors.New("session cookie is invalid") + } + } else { + l.Debug().Msgf("ValidateSession: No session cookie found; attempting API key authentication") + return nil, errors.New("session cookie is missing") + } + + l.Debug().Msg("ValidateSession: Retrieved login cookie from request") + + u, err := store.GetUserBySession(r.Context(), sid) + if err != nil { + l.Err(fmt.Errorf("ValidateSession: %w", err)).Msg("Error accessing database") + return nil, errors.New("internal server error") + } + if u == nil { + l.Debug().Msg("ValidateSession: No user with session id found") + return nil, errors.New("no user with session id found") + } + + ctx = context.WithValue(r.Context(), UserContextKey, u) + r = r.WithContext(ctx) + + l.Debug().Msgf("ValidateSession: Refreshing session for user '%s'", u.Username) + + store.RefreshSession(r.Context(), sid, time.Now().Add(30*24*time.Hour)) + + l.Debug().Msgf("ValidateSession: Refreshed session for user '%s'", u.Username) + + return u, nil +} + +func validateAPIKey(ctx context.Context, store db.DB, r *http.Request) (*models.User, error) { + l := logger.FromContext(ctx) + + l.Debug().Msg("ValidateApiKey: Checking if user is already authenticated") + + authH := r.Header.Get("Authorization") + var token string + if strings.HasPrefix(strings.ToLower(authH), "token ") { + token = strings.TrimSpace(authH[6:]) // strip "Token " + } else { + l.Error().Msg("ValidateApiKey: Authorization header must be formatted 'Token {token}'") + return nil, errors.New("authorization header is invalid") + } + + u, err := store.GetUserByApiKey(ctx, token) + if err != nil { + l.Err(err).Msg("ValidateApiKey: Failed to get user from database using api key") + return nil, errors.New("internal server error") + } + if u == nil { + l.Debug().Msg("ValidateApiKey: API key does not exist") + return nil, errors.New("authorization token is invalid") + } + + ctx = context.WithValue(r.Context(), UserContextKey, u) + r = r.WithContext(ctx) + + return u, nil +} + +func GetUserFromContext(ctx context.Context) *models.User { + user, ok := ctx.Value(UserContextKey).(*models.User) + if !ok { + return nil + } + return user +} diff --git a/engine/middleware/validate.go b/engine/middleware/validate.go deleted file mode 100644 index b3e1369..0000000 --- a/engine/middleware/validate.go +++ /dev/null @@ -1,125 +0,0 @@ -package middleware - -import ( - "context" - "fmt" - "net/http" - "strings" - "time" - - "github.com/gabehf/koito/internal/db" - "github.com/gabehf/koito/internal/logger" - "github.com/gabehf/koito/internal/models" - "github.com/gabehf/koito/internal/utils" - "github.com/google/uuid" -) - -type MiddlwareContextKey string - -const ( - UserContextKey MiddlwareContextKey = "user" - apikeyContextKey MiddlwareContextKey = "apikeyID" -) - -func ValidateSession(store db.DB) func(next http.Handler) http.Handler { - return func(next http.Handler) http.Handler { - return http.HandlerFunc(func(w http.ResponseWriter, r *http.Request) { - l := logger.FromContext(r.Context()) - - l.Debug().Msgf("ValidateSession: Checking user authentication via session cookie") - - cookie, err := r.Cookie("koito_session") - var sid uuid.UUID - if err == nil { - sid, err = uuid.Parse(cookie.Value) - if err != nil { - l.Err(err).Msg("ValidateSession: Could not parse UUID from session cookie") - utils.WriteError(w, "session cookie is invalid", http.StatusUnauthorized) - return - } - } else { - l.Debug().Msgf("ValidateSession: No session cookie found; attempting API key authentication") - utils.WriteError(w, "session cookie is missing", http.StatusUnauthorized) - return - } - - l.Debug().Msg("ValidateSession: Retrieved login cookie from request") - - u, err := store.GetUserBySession(r.Context(), sid) - if err != nil { - l.Err(fmt.Errorf("ValidateSession: %w", err)).Msg("Error accessing database") - utils.WriteError(w, "internal server error", http.StatusInternalServerError) - return - } - if u == nil { - l.Debug().Msg("ValidateSession: No user with session id found") - utils.WriteError(w, "unauthorized", http.StatusUnauthorized) - return - } - - ctx := context.WithValue(r.Context(), UserContextKey, u) - r = r.WithContext(ctx) - - l.Debug().Msgf("ValidateSession: Refreshing session for user '%s'", u.Username) - - store.RefreshSession(r.Context(), sid, time.Now().Add(30*24*time.Hour)) - - l.Debug().Msgf("ValidateSession: Refreshed session for user '%s'", u.Username) - - next.ServeHTTP(w, r) - }) - } -} - -func ValidateApiKey(store db.DB) func(next http.Handler) http.Handler { - return func(next http.Handler) http.Handler { - return http.HandlerFunc(func(w http.ResponseWriter, r *http.Request) { - ctx := r.Context() - l := logger.FromContext(ctx) - - l.Debug().Msg("ValidateApiKey: Checking if user is already authenticated") - - u := GetUserFromContext(ctx) - if u != nil { - l.Debug().Msg("ValidateApiKey: User is already authenticated; skipping API key authentication") - next.ServeHTTP(w, r) - return - } - - authh := r.Header.Get("Authorization") - var token string - if strings.HasPrefix(strings.ToLower(authh), "token ") { - token = strings.TrimSpace(authh[6:]) // strip "Token " - } else { - l.Error().Msg("ValidateApiKey: Authorization header must be formatted 'Token {token}'") - utils.WriteError(w, "unauthorized", http.StatusUnauthorized) - return - } - - u, err := store.GetUserByApiKey(ctx, token) - if err != nil { - l.Err(err).Msg("Failed to get user from database using api key") - utils.WriteError(w, "internal server error", http.StatusInternalServerError) - return - } - if u == nil { - l.Debug().Msg("Api key does not exist") - utils.WriteError(w, "unauthorized", http.StatusUnauthorized) - return - } - - ctx = context.WithValue(r.Context(), UserContextKey, u) - r = r.WithContext(ctx) - - next.ServeHTTP(w, r) - }) - } -} - -func GetUserFromContext(ctx context.Context) *models.User { - user, ok := ctx.Value(UserContextKey).(*models.User) - if !ok { - return nil - } - return user -} diff --git a/engine/routes.go b/engine/routes.go index e1c5fda..c62edf5 100644 --- a/engine/routes.go +++ b/engine/routes.go @@ -38,9 +38,7 @@ func bindRoutes( r.Get("/config", handlers.GetCfgHandler()) r.Group(func(r chi.Router) { - if cfg.LoginGate() { - r.Use(middleware.ValidateSession(db)) - } + r.Use(middleware.Authenticate(db, middleware.AuthModeLoginGate)) r.Get("/artist", handlers.GetArtistHandler(db)) r.Get("/artists", handlers.GetArtistsForItemHandler(db)) r.Get("/album", handlers.GetAlbumHandler(db)) @@ -79,7 +77,7 @@ func bindRoutes( }) r.Group(func(r chi.Router) { - r.Use(middleware.ValidateSession(db)) + r.Use(middleware.Authenticate(db, middleware.AuthModeSessionOrAPIKey)) r.Get("/export", handlers.ExportHandler(db)) r.Post("/replace-image", handlers.ReplaceImageHandler(db)) r.Patch("/album", handlers.UpdateAlbumHandler(db)) @@ -111,8 +109,10 @@ func bindRoutes( AllowedHeaders: []string{"Content-Type", "Authorization"}, })) - r.With(middleware.ValidateApiKey(db)).Post("/submit-listens", handlers.LbzSubmitListenHandler(db, mbz)) - r.With(middleware.ValidateApiKey(db)).Get("/validate-token", handlers.LbzValidateTokenHandler(db)) + r.With(middleware.Authenticate(db, middleware.AuthModeAPIKey)). + Post("/submit-listens", handlers.LbzSubmitListenHandler(db, mbz)) + r.With(middleware.Authenticate(db, middleware.AuthModeAPIKey)). + Get("/validate-token", handlers.LbzValidateTokenHandler(db)) }) // serve react client diff --git a/internal/cfg/cfg.go b/internal/cfg/cfg.go index e74d6b9..0cfc7bb 100644 --- a/internal/cfg/cfg.go +++ b/internal/cfg/cfg.go @@ -244,204 +244,3 @@ func parseBool(s string) bool { return false } } - -// Global accessors for configuration values - -func UserAgent() string { - lock.RLock() - defer lock.RUnlock() - return globalConfig.userAgent -} - -func ListenAddr() string { - lock.RLock() - defer lock.RUnlock() - return fmt.Sprintf("%s:%d", globalConfig.bindAddr, globalConfig.listenPort) -} - -func ConfigDir() string { - lock.RLock() - defer lock.RUnlock() - return globalConfig.configDir -} - -func DatabaseUrl() string { - lock.RLock() - defer lock.RUnlock() - return globalConfig.databaseUrl -} - -func MusicBrainzUrl() string { - lock.RLock() - defer lock.RUnlock() - return globalConfig.musicBrainzUrl -} - -func MusicBrainzRateLimit() int { - lock.RLock() - defer lock.RUnlock() - return globalConfig.musicBrainzRateLimit -} - -func LogLevel() int { - lock.RLock() - defer lock.RUnlock() - return globalConfig.logLevel -} - -func StructuredLogging() bool { - lock.RLock() - defer lock.RUnlock() - return globalConfig.structuredLogging -} - -func LbzRelayEnabled() bool { - lock.RLock() - defer lock.RUnlock() - return globalConfig.lbzRelayEnabled -} - -func LbzRelayUrl() string { - lock.RLock() - defer lock.RUnlock() - return globalConfig.lbzRelayUrl -} - -func LbzRelayToken() string { - lock.RLock() - defer lock.RUnlock() - return globalConfig.lbzRelayToken -} - -func DefaultPassword() string { - lock.RLock() - defer lock.RUnlock() - return globalConfig.defaultPw -} - -func DefaultUsername() string { - lock.RLock() - defer lock.RUnlock() - return globalConfig.defaultUsername -} - -func DefaultTheme() string { - lock.RLock() - defer lock.RUnlock() - return globalConfig.defaultTheme -} - -func FullImageCacheEnabled() bool { - lock.RLock() - defer lock.RUnlock() - return globalConfig.enableFullImageCache -} - -func DeezerDisabled() bool { - lock.RLock() - defer lock.RUnlock() - return globalConfig.disableDeezer -} - -func CoverArtArchiveDisabled() bool { - lock.RLock() - defer lock.RUnlock() - return globalConfig.disableCAA -} - -func MusicBrainzDisabled() bool { - lock.RLock() - defer lock.RUnlock() - return globalConfig.disableMusicBrainz -} - -func SubsonicEnabled() bool { - lock.RLock() - defer lock.RUnlock() - return globalConfig.subsonicEnabled -} - -func SubsonicUrl() string { - lock.RLock() - defer lock.RUnlock() - return globalConfig.subsonicUrl -} - -func SubsonicParams() string { - lock.RLock() - defer lock.RUnlock() - return globalConfig.subsonicParams -} - -func LastFMApiKey() string { - lock.RLock() - defer lock.RUnlock() - return globalConfig.lastfmApiKey -} - -func SkipImport() bool { - lock.RLock() - defer lock.RUnlock() - return globalConfig.skipImport -} - -func AllowedHosts() []string { - lock.RLock() - defer lock.RUnlock() - return globalConfig.allowedHosts -} - -func AllowAllHosts() bool { - lock.RLock() - defer lock.RUnlock() - return globalConfig.allowAllHosts -} - -func AllowedOrigins() []string { - lock.RLock() - defer lock.RUnlock() - return globalConfig.allowedOrigins -} - -func RateLimitDisabled() bool { - lock.RLock() - defer lock.RUnlock() - return globalConfig.disableRateLimit -} - -func ThrottleImportMs() int { - lock.RLock() - defer lock.RUnlock() - return globalConfig.importThrottleMs -} - -// returns the before, after times, in that order -func ImportWindow() (time.Time, time.Time) { - lock.RLock() - defer lock.RUnlock() - return globalConfig.importBefore, globalConfig.importAfter -} - -func FetchImagesDuringImport() bool { - lock.RLock() - defer lock.RUnlock() - return globalConfig.fetchImageDuringImport -} - -func ArtistSeparators() []*regexp.Regexp { - lock.RLock() - defer lock.RUnlock() - return globalConfig.artistSeparators -} - -func LoginGate() bool { - lock.RLock() - defer lock.RUnlock() - return globalConfig.loginGate -} - -func ForceTZ() *time.Location { - lock.RLock() - defer lock.RUnlock() - return globalConfig.forceTZ -} diff --git a/internal/cfg/getters.go b/internal/cfg/getters.go new file mode 100644 index 0000000..596ca9d --- /dev/null +++ b/internal/cfg/getters.go @@ -0,0 +1,206 @@ +package cfg + +import ( + "fmt" + "regexp" + "time" +) + +func UserAgent() string { + lock.RLock() + defer lock.RUnlock() + return globalConfig.userAgent +} + +func ListenAddr() string { + lock.RLock() + defer lock.RUnlock() + return fmt.Sprintf("%s:%d", globalConfig.bindAddr, globalConfig.listenPort) +} + +func ConfigDir() string { + lock.RLock() + defer lock.RUnlock() + return globalConfig.configDir +} + +func DatabaseUrl() string { + lock.RLock() + defer lock.RUnlock() + return globalConfig.databaseUrl +} + +func MusicBrainzUrl() string { + lock.RLock() + defer lock.RUnlock() + return globalConfig.musicBrainzUrl +} + +func MusicBrainzRateLimit() int { + lock.RLock() + defer lock.RUnlock() + return globalConfig.musicBrainzRateLimit +} + +func LogLevel() int { + lock.RLock() + defer lock.RUnlock() + return globalConfig.logLevel +} + +func StructuredLogging() bool { + lock.RLock() + defer lock.RUnlock() + return globalConfig.structuredLogging +} + +func LbzRelayEnabled() bool { + lock.RLock() + defer lock.RUnlock() + return globalConfig.lbzRelayEnabled +} + +func LbzRelayUrl() string { + lock.RLock() + defer lock.RUnlock() + return globalConfig.lbzRelayUrl +} + +func LbzRelayToken() string { + lock.RLock() + defer lock.RUnlock() + return globalConfig.lbzRelayToken +} + +func DefaultPassword() string { + lock.RLock() + defer lock.RUnlock() + return globalConfig.defaultPw +} + +func DefaultUsername() string { + lock.RLock() + defer lock.RUnlock() + return globalConfig.defaultUsername +} + +func DefaultTheme() string { + lock.RLock() + defer lock.RUnlock() + return globalConfig.defaultTheme +} + +func FullImageCacheEnabled() bool { + lock.RLock() + defer lock.RUnlock() + return globalConfig.enableFullImageCache +} + +func DeezerDisabled() bool { + lock.RLock() + defer lock.RUnlock() + return globalConfig.disableDeezer +} + +func CoverArtArchiveDisabled() bool { + lock.RLock() + defer lock.RUnlock() + return globalConfig.disableCAA +} + +func MusicBrainzDisabled() bool { + lock.RLock() + defer lock.RUnlock() + return globalConfig.disableMusicBrainz +} + +func SubsonicEnabled() bool { + lock.RLock() + defer lock.RUnlock() + return globalConfig.subsonicEnabled +} + +func SubsonicUrl() string { + lock.RLock() + defer lock.RUnlock() + return globalConfig.subsonicUrl +} + +func SubsonicParams() string { + lock.RLock() + defer lock.RUnlock() + return globalConfig.subsonicParams +} + +func LastFMApiKey() string { + lock.RLock() + defer lock.RUnlock() + return globalConfig.lastfmApiKey +} + +func SkipImport() bool { + lock.RLock() + defer lock.RUnlock() + return globalConfig.skipImport +} + +func AllowedHosts() []string { + lock.RLock() + defer lock.RUnlock() + return globalConfig.allowedHosts +} + +func AllowAllHosts() bool { + lock.RLock() + defer lock.RUnlock() + return globalConfig.allowAllHosts +} + +func AllowedOrigins() []string { + lock.RLock() + defer lock.RUnlock() + return globalConfig.allowedOrigins +} + +func RateLimitDisabled() bool { + lock.RLock() + defer lock.RUnlock() + return globalConfig.disableRateLimit +} + +func ThrottleImportMs() int { + lock.RLock() + defer lock.RUnlock() + return globalConfig.importThrottleMs +} + +// returns the before, after times, in that order +func ImportWindow() (time.Time, time.Time) { + lock.RLock() + defer lock.RUnlock() + return globalConfig.importBefore, globalConfig.importAfter +} + +func FetchImagesDuringImport() bool { + lock.RLock() + defer lock.RUnlock() + return globalConfig.fetchImageDuringImport +} + +func ArtistSeparators() []*regexp.Regexp { + lock.RLock() + defer lock.RUnlock() + return globalConfig.artistSeparators +} + +func LoginGate() bool { + lock.RLock() + defer lock.RUnlock() + return globalConfig.loginGate +} + +func ForceTZ() *time.Location { + lock.RLock() + defer lock.RUnlock() + return globalConfig.forceTZ +} diff --git a/internal/cfg/setters.go b/internal/cfg/setters.go new file mode 100644 index 0000000..8458780 --- /dev/null +++ b/internal/cfg/setters.go @@ -0,0 +1,7 @@ +package cfg + +func SetLoginGate(val bool) { + lock.Lock() + defer lock.Unlock() + globalConfig.loginGate = val +} From 64236c99c9fe2493b997be9bcbd4b748bf15a379 Mon Sep 17 00:00:00 2001 From: Gabe Farrell <90876006+gabehf@users.noreply.github.com> Date: Mon, 26 Jan 2026 14:49:30 -0500 Subject: [PATCH 34/37] fix: invalid json response when login gate is disabled (#184) --- engine/long_test.go | 13 +++++++++++++ engine/middleware/authenticate.go | 7 +++---- 2 files changed, 16 insertions(+), 4 deletions(-) diff --git a/engine/long_test.go b/engine/long_test.go index d916117..db86ac2 100644 --- a/engine/long_test.go +++ b/engine/long_test.go @@ -367,6 +367,16 @@ func TestLoginGate(t *testing.T) { assert.NoError(t, err) assert.Equal(t, 204, resp.StatusCode) + req, err = http.NewRequest("GET", host()+"/apis/web/v1/artist?id=3", nil) + require.NoError(t, err) + resp, err = http.DefaultClient.Do(req) + assert.NoError(t, err) + assert.Equal(t, 200, resp.StatusCode) + var artist models.Artist + err = json.NewDecoder(resp.Body).Decode(&artist) + require.NoError(t, err) + assert.Equal(t, "ネクライトーキー", artist.Name) + cfg.SetLoginGate(true) req, err = http.NewRequest("GET", host()+"/apis/web/v1/artist?id=3", nil) @@ -382,6 +392,9 @@ func TestLoginGate(t *testing.T) { resp, err = http.DefaultClient.Do(req) assert.NoError(t, err) assert.Equal(t, 200, resp.StatusCode) + err = json.NewDecoder(resp.Body).Decode(&artist) + require.NoError(t, err) + assert.Equal(t, "ネクライトーキー", artist.Name) cfg.SetLoginGate(false) diff --git a/engine/middleware/authenticate.go b/engine/middleware/authenticate.go index a435473..830fb78 100644 --- a/engine/middleware/authenticate.go +++ b/engine/middleware/authenticate.go @@ -62,6 +62,7 @@ func Authenticate(store db.DB, mode AuthMode) func(http.Handler) http.Handler { } } else { next.ServeHTTP(w, r) + return } } @@ -76,10 +77,8 @@ func Authenticate(store db.DB, mode AuthMode) func(http.Handler) http.Handler { return } - if user != nil { - ctx = context.WithValue(ctx, UserContextKey, user) - r = r.WithContext(ctx) - } + ctx = context.WithValue(ctx, UserContextKey, user) + r = r.WithContext(ctx) next.ServeHTTP(w, r) }) From b06685c1afe2d635e819b96646419be4ae81dab3 Mon Sep 17 00:00:00 2001 From: Gabe Farrell <90876006+gabehf@users.noreply.github.com> Date: Mon, 2 Feb 2026 15:06:13 -0500 Subject: [PATCH 35/37] fix: rewind navigation (#191) --- client/app/routes/RewindPage.tsx | 32 ++++++++++++++++++++------------ 1 file changed, 20 insertions(+), 12 deletions(-) diff --git a/client/app/routes/RewindPage.tsx b/client/app/routes/RewindPage.tsx index 4d60065..ad92497 100644 --- a/client/app/routes/RewindPage.tsx +++ b/client/app/routes/RewindPage.tsx @@ -29,10 +29,12 @@ const months = [ export async function clientLoader({ request }: LoaderFunctionArgs) { const url = new URL(request.url); - const year = - parseInt(url.searchParams.get("year") || "0") || getRewindParams().year; - const month = - parseInt(url.searchParams.get("month") || "0") || getRewindParams().month; + const year = parseInt( + url.searchParams.get("year") || getRewindParams().year.toString() + ); + const month = parseInt( + url.searchParams.get("month") || getRewindParams().month.toString() + ); const res = await fetch(`/apis/web/v1/summary?year=${year}&month=${month}`); if (!res.ok) { @@ -46,10 +48,12 @@ export async function clientLoader({ request }: LoaderFunctionArgs) { export default function RewindPage() { const currentParams = new URLSearchParams(location.search); - let year = - parseInt(currentParams.get("year") || "0") || getRewindParams().year; - let month = - parseInt(currentParams.get("month") || "0") || getRewindParams().month; + let year = parseInt( + currentParams.get("year") || getRewindParams().year.toString() + ); + let month = parseInt( + currentParams.get("month") || getRewindParams().month.toString() + ); const navigate = useNavigate(); const [showTime, setShowTime] = useState(false); const { stats: stats } = useLoaderData<{ stats: RewindStats }>(); @@ -73,10 +77,8 @@ export default function RewindPage() { for (const key in params) { const val = params[key]; - if (val !== null && val !== "0") { + if (val !== null) { nextParams.set(key, val); - } else { - nextParams.delete(key); } } @@ -99,6 +101,7 @@ export default function RewindPage() { month -= 1; } } + console.log(`Month: ${month}`); updateParams({ year: year.toString(), @@ -154,7 +157,12 @@ export default function RewindPage() { From 531c72899cf5b2cbc90a22cf22709d4b382f412b Mon Sep 17 00:00:00 2001 From: Gabe Farrell <90876006+gabehf@users.noreply.github.com> Date: Tue, 3 Feb 2026 11:23:30 -0500 Subject: [PATCH 36/37] fix: add null check for top charts bg gradient (#193) --- client/app/routes/Charts/ChartLayout.tsx | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/client/app/routes/Charts/ChartLayout.tsx b/client/app/routes/Charts/ChartLayout.tsx index 446f7d1..90858bd 100644 --- a/client/app/routes/Charts/ChartLayout.tsx +++ b/client/app/routes/Charts/ChartLayout.tsx @@ -40,7 +40,7 @@ export default function ChartLayout({ useEffect(() => { if ((data?.items?.length ?? 0) === 0) return; - const img = (data.items[0] as any)?.item.image; + const img = (data.items[0] as any)?.item?.image; if (!img) return; average(imageUrl(img, "small"), { amount: 1 }).then((color) => { From 0ec7b458ccf29bed07e5cd53ac407c117a29f2b2 Mon Sep 17 00:00:00 2001 From: Gabe Farrell <90876006+gabehf@users.noreply.github.com> Date: Wed, 4 Feb 2026 13:41:12 -0500 Subject: [PATCH 37/37] ui: tweaks and fixes (#194) * reduce min width of top chart on mobile * adjust error page style * adjust h1 line height --- client/app/app.css | 3 +++ client/app/root.tsx | 8 ++++---- client/app/routes/Charts/AlbumChart.tsx | 4 ++-- client/app/routes/Charts/ArtistChart.tsx | 4 ++-- client/app/routes/Charts/TrackChart.tsx | 4 ++-- 5 files changed, 13 insertions(+), 10 deletions(-) diff --git a/client/app/app.css b/client/app/app.css index bc60042..15cfbc0 100644 --- a/client/app/app.css +++ b/client/app/app.css @@ -58,6 +58,7 @@ --header-sm: 16px; --header-xl-weight: 600; --header-weight: 600; + --header-line-height: 3rem; } @media (min-width: 60rem) { @@ -68,6 +69,7 @@ --header-sm: 16px; --header-xl-weight: 600; --header-weight: 600; + --header-line-height: 1.3em; } } @@ -98,6 +100,7 @@ h1 { font-family: "League Spartan"; font-weight: var(--header-weight); font-size: var(--header-xl); + line-height: var(--header-line-height); } h2 { font-family: "League Spartan"; diff --git a/client/app/root.tsx b/client/app/root.tsx index 077d09e..cb0723f 100644 --- a/client/app/root.tsx +++ b/client/app/root.tsx @@ -116,12 +116,12 @@ export function ErrorBoundary() { {title} +
-
-
-
- +
+
+

{message}

{details}

diff --git a/client/app/routes/Charts/AlbumChart.tsx b/client/app/routes/Charts/AlbumChart.tsx index 7bc4eea..7a157a8 100644 --- a/client/app/routes/Charts/AlbumChart.tsx +++ b/client/app/routes/Charts/AlbumChart.tsx @@ -30,7 +30,7 @@ export default function AlbumChart() { initialData={initialData} endpoint="chart/top-albums" render={({ data, page, onNext, onPrev }) => ( -
+