mirror of
https://github.com/navidrome/navidrome.git
synced 2025-04-14 11:17:19 +03:00
476 lines
12 KiB
Go
476 lines
12 KiB
Go
package core
|
||
|
||
import (
|
||
"context"
|
||
"sort"
|
||
"strings"
|
||
"sync"
|
||
"time"
|
||
|
||
"github.com/Masterminds/squirrel"
|
||
"github.com/microcosm-cc/bluemonday"
|
||
"github.com/navidrome/navidrome/conf"
|
||
"github.com/navidrome/navidrome/consts"
|
||
"github.com/navidrome/navidrome/core/agents"
|
||
"github.com/navidrome/navidrome/log"
|
||
"github.com/navidrome/navidrome/model"
|
||
)
|
||
|
||
const (
|
||
unavailableArtistID = "-1"
|
||
maxSimilarArtists = 100
|
||
)
|
||
|
||
type ExternalMetadata interface {
|
||
UpdateArtistInfo(ctx context.Context, id string, count int, includeNotPresent bool) (*model.Artist, error)
|
||
SimilarSongs(ctx context.Context, id string, count int) (model.MediaFiles, error)
|
||
TopSongs(ctx context.Context, artist string, count int) (model.MediaFiles, error)
|
||
}
|
||
|
||
type externalMetadata struct {
|
||
ds model.DataStore
|
||
}
|
||
|
||
type auxArtist struct {
|
||
model.Artist
|
||
Name string
|
||
}
|
||
|
||
func NewExternalMetadata(ds model.DataStore) ExternalMetadata {
|
||
return &externalMetadata{ds: ds}
|
||
}
|
||
|
||
func (e *externalMetadata) initAgents(ctx context.Context) []agents.Interface {
|
||
order := strings.Split(conf.Server.Agents, ",")
|
||
order = append(order, agents.PlaceholderAgentName)
|
||
var res []agents.Interface
|
||
for _, name := range order {
|
||
init, ok := agents.Map[name]
|
||
if !ok {
|
||
log.Error(ctx, "Agent not available. Check configuration", "name", name)
|
||
continue
|
||
}
|
||
|
||
res = append(res, init(ctx))
|
||
}
|
||
|
||
return res
|
||
}
|
||
|
||
func (e *externalMetadata) getArtist(ctx context.Context, id string) (*auxArtist, error) {
|
||
var entity interface{}
|
||
entity, err := GetEntityByID(ctx, e.ds, id)
|
||
if err != nil {
|
||
return nil, err
|
||
}
|
||
|
||
var artist auxArtist
|
||
switch v := entity.(type) {
|
||
case *model.Artist:
|
||
artist.Artist = *v
|
||
artist.Name = clearName(v.Name)
|
||
case *model.MediaFile:
|
||
return e.getArtist(ctx, v.ArtistID)
|
||
case *model.Album:
|
||
return e.getArtist(ctx, v.AlbumArtistID)
|
||
default:
|
||
return nil, model.ErrNotFound
|
||
}
|
||
return &artist, nil
|
||
}
|
||
|
||
// Replace some Unicode chars with their equivalent ASCII
|
||
func clearName(name string) string {
|
||
name = strings.ReplaceAll(name, "–", "-")
|
||
name = strings.ReplaceAll(name, "‐", "-")
|
||
name = strings.ReplaceAll(name, "“", `"`)
|
||
name = strings.ReplaceAll(name, "”", `"`)
|
||
name = strings.ReplaceAll(name, "‘", `'`)
|
||
name = strings.ReplaceAll(name, "’", `'`)
|
||
return name
|
||
}
|
||
|
||
func (e *externalMetadata) UpdateArtistInfo(ctx context.Context, id string, similarCount int, includeNotPresent bool) (*model.Artist, error) {
|
||
artist, err := e.getArtist(ctx, id)
|
||
if err != nil {
|
||
return nil, err
|
||
}
|
||
|
||
// If we have fresh info, just return it and trigger a refresh in the background
|
||
if time.Since(artist.ExternalInfoUpdatedAt) < consts.ArtistInfoTimeToLive {
|
||
go func() {
|
||
err := e.refreshArtistInfo(ctx, artist)
|
||
if err != nil {
|
||
log.Error("Error refreshing ArtistInfo", "id", id, "name", artist.Name, err)
|
||
}
|
||
}()
|
||
log.Debug("Found cached ArtistInfo, refreshing in the background", "updatedAt", artist.ExternalInfoUpdatedAt, "name", artist.Name)
|
||
err := e.loadSimilar(ctx, artist, similarCount, includeNotPresent)
|
||
return &artist.Artist, err
|
||
}
|
||
|
||
log.Debug(ctx, "ArtistInfo not cached or expired", "updatedAt", artist.ExternalInfoUpdatedAt, "id", id, "name", artist.Name)
|
||
err = e.refreshArtistInfo(ctx, artist)
|
||
if err != nil {
|
||
return nil, err
|
||
}
|
||
err = e.loadSimilar(ctx, artist, similarCount, includeNotPresent)
|
||
return &artist.Artist, err
|
||
}
|
||
|
||
func (e *externalMetadata) refreshArtistInfo(ctx context.Context, artist *auxArtist) error {
|
||
allAgents := e.initAgents(ctx)
|
||
|
||
// Get MBID first, if it is not yet available
|
||
if artist.MbzArtistID == "" {
|
||
e.callGetMBID(ctx, allAgents, artist)
|
||
}
|
||
|
||
// Call all registered agents and collect information
|
||
wg := &sync.WaitGroup{}
|
||
e.callGetBiography(ctx, allAgents, artist, wg)
|
||
e.callGetURL(ctx, allAgents, artist, wg)
|
||
e.callGetImage(ctx, allAgents, artist, wg)
|
||
e.callGetSimilar(ctx, allAgents, artist, maxSimilarArtists, wg)
|
||
wg.Wait()
|
||
|
||
if isDone(ctx) {
|
||
log.Warn(ctx, "ArtistInfo update canceled", ctx.Err())
|
||
return ctx.Err()
|
||
}
|
||
|
||
artist.ExternalInfoUpdatedAt = time.Now()
|
||
err := e.ds.Artist(ctx).Put(&artist.Artist)
|
||
if err != nil {
|
||
log.Error(ctx, "Error trying to update artist external information", "id", artist.ID, "name", artist.Name, err)
|
||
}
|
||
|
||
log.Trace(ctx, "ArtistInfo collected", "artist", artist)
|
||
return nil
|
||
}
|
||
|
||
func (e *externalMetadata) SimilarSongs(ctx context.Context, id string, count int) (model.MediaFiles, error) {
|
||
allAgents := e.initAgents(ctx)
|
||
artist, err := e.getArtist(ctx, id)
|
||
if err != nil {
|
||
return nil, err
|
||
}
|
||
|
||
wg := &sync.WaitGroup{}
|
||
e.callGetSimilar(ctx, allAgents, artist, count, wg)
|
||
wg.Wait()
|
||
|
||
if isDone(ctx) {
|
||
log.Warn(ctx, "SimilarSongs call canceled", ctx.Err())
|
||
return nil, ctx.Err()
|
||
}
|
||
|
||
if len(artist.SimilarArtists) == 0 {
|
||
return nil, nil
|
||
}
|
||
|
||
var ids = []string{artist.ID}
|
||
for _, a := range artist.SimilarArtists {
|
||
if a.ID != unavailableArtistID {
|
||
ids = append(ids, a.ID)
|
||
}
|
||
}
|
||
|
||
return e.ds.MediaFile(ctx).GetAll(model.QueryOptions{
|
||
Filters: squirrel.Eq{"artist_id": ids},
|
||
Max: count,
|
||
Sort: "random()",
|
||
})
|
||
}
|
||
|
||
func (e *externalMetadata) TopSongs(ctx context.Context, artistName string, count int) (model.MediaFiles, error) {
|
||
allAgents := e.initAgents(ctx)
|
||
artist, err := e.findArtistByName(ctx, artistName)
|
||
if err != nil {
|
||
log.Error(ctx, "Artist not found", "name", artistName, err)
|
||
return nil, nil
|
||
}
|
||
|
||
songs, err := e.callGetTopSongs(ctx, allAgents, artist, count)
|
||
if err != nil {
|
||
return nil, err
|
||
}
|
||
|
||
var mfs model.MediaFiles
|
||
for _, t := range songs {
|
||
mf, err := e.findMatchingTrack(ctx, t.MBID, artist.ID, t.Name)
|
||
if err != nil {
|
||
continue
|
||
}
|
||
mfs = append(mfs, *mf)
|
||
}
|
||
return mfs, nil
|
||
}
|
||
|
||
func (e *externalMetadata) findMatchingTrack(ctx context.Context, mbid string, artistID, title string) (*model.MediaFile, error) {
|
||
if mbid != "" {
|
||
mfs, err := e.ds.MediaFile(ctx).GetAll(model.QueryOptions{
|
||
Filters: squirrel.Eq{"mbz_track_id": mbid},
|
||
})
|
||
if err == nil && len(mfs) > 0 {
|
||
return &mfs[0], nil
|
||
}
|
||
}
|
||
mfs, err := e.ds.MediaFile(ctx).GetAll(model.QueryOptions{
|
||
Filters: squirrel.And{
|
||
squirrel.Or{
|
||
squirrel.Eq{"artist_id": artistID},
|
||
squirrel.Eq{"album_artist_id": artistID},
|
||
},
|
||
squirrel.Like{"title": title},
|
||
},
|
||
Sort: "starred desc, rating desc, year asc",
|
||
})
|
||
if err != nil || len(mfs) == 0 {
|
||
return nil, model.ErrNotFound
|
||
}
|
||
return &mfs[0], nil
|
||
}
|
||
|
||
func isDone(ctx context.Context) bool {
|
||
select {
|
||
case <-ctx.Done():
|
||
return true
|
||
default:
|
||
return false
|
||
}
|
||
}
|
||
|
||
func (e *externalMetadata) callGetMBID(ctx context.Context, allAgents []agents.Interface, artist *auxArtist) {
|
||
start := time.Now()
|
||
for _, a := range allAgents {
|
||
if isDone(ctx) {
|
||
break
|
||
}
|
||
agent, ok := a.(agents.ArtistMBIDRetriever)
|
||
if !ok {
|
||
continue
|
||
}
|
||
mbid, err := agent.GetMBID(artist.ID, artist.Name)
|
||
if mbid != "" && err == nil {
|
||
artist.MbzArtistID = mbid
|
||
log.Debug(ctx, "Got MBID", "agent", a.AgentName(), "artist", artist.Name, "mbid", mbid, "elapsed", time.Since(start))
|
||
break
|
||
}
|
||
}
|
||
}
|
||
|
||
func (e *externalMetadata) callGetTopSongs(ctx context.Context, allAgents []agents.Interface, artist *auxArtist,
|
||
count int) ([]agents.Song, error) {
|
||
start := time.Now()
|
||
for _, a := range allAgents {
|
||
if isDone(ctx) {
|
||
break
|
||
}
|
||
agent, ok := a.(agents.ArtistTopSongsRetriever)
|
||
if !ok {
|
||
continue
|
||
}
|
||
songs, err := agent.GetTopSongs(artist.ID, artist.Name, artist.MbzArtistID, count)
|
||
if len(songs) > 0 && err == nil {
|
||
log.Debug(ctx, "Got Top Songs", "agent", a.AgentName(), "artist", artist.Name, "songs", songs, "elapsed", time.Since(start))
|
||
return songs, err
|
||
}
|
||
}
|
||
return nil, nil
|
||
}
|
||
|
||
func (e *externalMetadata) callGetURL(ctx context.Context, allAgents []agents.Interface, artist *auxArtist, wg *sync.WaitGroup) {
|
||
wg.Add(1)
|
||
go func() {
|
||
defer wg.Done()
|
||
start := time.Now()
|
||
for _, a := range allAgents {
|
||
if isDone(ctx) {
|
||
break
|
||
}
|
||
agent, ok := a.(agents.ArtistURLRetriever)
|
||
if !ok {
|
||
continue
|
||
}
|
||
url, err := agent.GetURL(artist.ID, artist.Name, artist.MbzArtistID)
|
||
if url != "" && err == nil {
|
||
artist.ExternalUrl = url
|
||
log.Debug(ctx, "Got External Url", "agent", a.AgentName(), "artist", artist.Name, "url", url, "elapsed", time.Since(start))
|
||
break
|
||
}
|
||
}
|
||
}()
|
||
}
|
||
|
||
func (e *externalMetadata) callGetBiography(ctx context.Context, allAgents []agents.Interface, artist *auxArtist, wg *sync.WaitGroup) {
|
||
wg.Add(1)
|
||
go func() {
|
||
defer wg.Done()
|
||
start := time.Now()
|
||
for _, a := range allAgents {
|
||
if isDone(ctx) {
|
||
break
|
||
}
|
||
agent, ok := a.(agents.ArtistBiographyRetriever)
|
||
if !ok {
|
||
continue
|
||
}
|
||
bio, err := agent.GetBiography(artist.ID, clearName(artist.Name), artist.MbzArtistID)
|
||
if bio != "" && err == nil {
|
||
policy := bluemonday.UGCPolicy()
|
||
bio = policy.Sanitize(bio)
|
||
bio = strings.ReplaceAll(bio, "\n", " ")
|
||
artist.Biography = strings.ReplaceAll(bio, "<a ", "<a target='_blank' ")
|
||
log.Debug(ctx, "Got Biography", "agent", a.AgentName(), "artist", artist.Name, "len", len(bio), "elapsed", time.Since(start))
|
||
break
|
||
}
|
||
}
|
||
}()
|
||
}
|
||
|
||
func (e *externalMetadata) callGetImage(ctx context.Context, allAgents []agents.Interface, artist *auxArtist, wg *sync.WaitGroup) {
|
||
wg.Add(1)
|
||
go func() {
|
||
defer wg.Done()
|
||
start := time.Now()
|
||
for _, a := range allAgents {
|
||
if isDone(ctx) {
|
||
break
|
||
}
|
||
agent, ok := a.(agents.ArtistImageRetriever)
|
||
if !ok {
|
||
continue
|
||
}
|
||
images, err := agent.GetImages(artist.ID, artist.Name, artist.MbzArtistID)
|
||
if len(images) == 0 || err != nil {
|
||
continue
|
||
}
|
||
log.Debug(ctx, "Got Images", "agent", a.AgentName(), "artist", artist.Name, "images", images, "elapsed", time.Since(start))
|
||
sort.Slice(images, func(i, j int) bool { return images[i].Size > images[j].Size })
|
||
if len(images) >= 1 {
|
||
artist.LargeImageUrl = images[0].URL
|
||
}
|
||
if len(images) >= 2 {
|
||
artist.MediumImageUrl = images[1].URL
|
||
}
|
||
if len(images) >= 3 {
|
||
artist.SmallImageUrl = images[2].URL
|
||
}
|
||
break
|
||
}
|
||
}()
|
||
}
|
||
|
||
func (e *externalMetadata) callGetSimilar(ctx context.Context, allAgents []agents.Interface, artist *auxArtist, limit int, wg *sync.WaitGroup) {
|
||
wg.Add(1)
|
||
go func() {
|
||
defer wg.Done()
|
||
start := time.Now()
|
||
for _, a := range allAgents {
|
||
if isDone(ctx) {
|
||
break
|
||
}
|
||
agent, ok := a.(agents.ArtistSimilarRetriever)
|
||
if !ok {
|
||
continue
|
||
}
|
||
similar, err := agent.GetSimilar(artist.ID, artist.Name, artist.MbzArtistID, limit)
|
||
if len(similar) == 0 || err != nil {
|
||
continue
|
||
}
|
||
sa, err := e.mapSimilarArtists(ctx, similar, true)
|
||
if err != nil {
|
||
continue
|
||
}
|
||
log.Debug(ctx, "Got Similar Artists", "agent", a.AgentName(), "artist", artist.Name, "similar", similar, "elapsed", time.Since(start))
|
||
artist.SimilarArtists = sa
|
||
break
|
||
}
|
||
}()
|
||
}
|
||
|
||
func (e *externalMetadata) mapSimilarArtists(ctx context.Context, similar []agents.Artist, includeNotPresent bool) (model.Artists, error) {
|
||
var result model.Artists
|
||
var notPresent []string
|
||
|
||
// First select artists that are present.
|
||
for _, s := range similar {
|
||
sa, err := e.findArtistByName(ctx, s.Name)
|
||
if err != nil {
|
||
notPresent = append(notPresent, s.Name)
|
||
continue
|
||
}
|
||
result = append(result, sa.Artist)
|
||
}
|
||
|
||
// Then fill up with non-present artists
|
||
if includeNotPresent {
|
||
for _, s := range notPresent {
|
||
sa := model.Artist{ID: unavailableArtistID, Name: s}
|
||
result = append(result, sa)
|
||
}
|
||
}
|
||
|
||
return result, nil
|
||
}
|
||
|
||
func (e *externalMetadata) findArtistByName(ctx context.Context, artistName string) (*auxArtist, error) {
|
||
artists, err := e.ds.Artist(ctx).GetAll(model.QueryOptions{
|
||
Filters: squirrel.Like{"name": artistName},
|
||
Max: 1,
|
||
})
|
||
if err != nil {
|
||
return nil, err
|
||
}
|
||
if len(artists) == 0 {
|
||
return nil, model.ErrNotFound
|
||
}
|
||
artist := &auxArtist{
|
||
Artist: artists[0],
|
||
Name: clearName(artists[0].Name),
|
||
}
|
||
return artist, nil
|
||
}
|
||
|
||
func (e *externalMetadata) loadSimilar(ctx context.Context, artist *auxArtist, count int, includeNotPresent bool) error {
|
||
var ids []string
|
||
for _, sa := range artist.SimilarArtists {
|
||
if sa.ID == unavailableArtistID {
|
||
continue
|
||
}
|
||
ids = append(ids, sa.ID)
|
||
}
|
||
|
||
similar, err := e.ds.Artist(ctx).GetAll(model.QueryOptions{
|
||
Filters: squirrel.Eq{"id": ids},
|
||
})
|
||
if err != nil {
|
||
return err
|
||
}
|
||
|
||
// Use a map and iterate through original array, to keep the same order
|
||
artistMap := make(map[string]model.Artist)
|
||
for _, sa := range similar {
|
||
artistMap[sa.ID] = sa
|
||
}
|
||
|
||
var loaded model.Artists
|
||
for _, sa := range artist.SimilarArtists {
|
||
if len(loaded) >= count {
|
||
break
|
||
}
|
||
la, ok := artistMap[sa.ID]
|
||
if !ok {
|
||
if !includeNotPresent {
|
||
continue
|
||
}
|
||
la = sa
|
||
la.ID = unavailableArtistID
|
||
}
|
||
loaded = append(loaded, la)
|
||
}
|
||
artist.SimilarArtists = loaded
|
||
return nil
|
||
}
|