cover

Documentation

Index

• Variables
• func DefaultCacheDir() string
• func Render(art *Art, width, height int) (string, error)
• type Art
  • func Resolve(trackPath, artist, album, cacheDir string) (*Art, error)
• type Source

Variables

var (
	ErrNotFound   = errors.New("no cover art found")
	ErrNoChafa    = errors.New("chafa is not installed")
	ErrNoMetadata = errors.New("no embedded or folder art, and no metadata to search online")
)

Functions

func DefaultCacheDir

func DefaultCacheDir() string

DefaultCacheDir returns the per-user cache directory for downloaded covers.

func Render

func Render(art *Art, width, height int) (string, error)

Render converts art to ANSI symbols via chafa and returns its display lines.

Types

type Art

type Art struct {
	Path   string
	Data   []byte
	Source Source
}

Art is a resolved cover image plus where it came from.

func Resolve

func Resolve(trackPath, artist, album, cacheDir string) (*Art, error)

Resolve finds cover art for a track: embedded tag art first, then a cover file beside the track, then an online fetch cached on disk.

type Source

type Source string

Source describes where the cover art came from, shown in the UI.

const (
	SourceEmbedded Source = "embedded"
	SourceFolder   Source = "folder file"
	SourceCache    Source = "cache"
	SourceOnline   Source = "iTunes"
)