chromaprint

Documentation

Overview

chromaprint provides bindings to the Chromaprint library, which is a library for extracting audio fingerprints.

Index

• func New(rate, channels int, duration time.Duration) *fingerprint
• func PrintVersion(w io.Writer)
• type Client
  • func NewClient(ApiKey string, opts ...client.ClientOpt) (*Client, error)
  • func (c *Client) Lookup(fingerprint string, duration time.Duration, flags Meta) ([]*ResponseMatch, error)
• type Meta
  • func (m Meta) FlagString() string
  • func (m Meta) String() string
• type Response
• type ResponseArtist
• type ResponseError
• type ResponseGroup
• type ResponseMatch
  • func (r *ResponseMatch) String() string
• type ResponseMedium
• type ResponseRecording
• type ResponseRelease
• type ResponseTrack

Functions

func New

func New(rate, channels int, duration time.Duration) *fingerprint

Create a new fingerprint context, with the expected sample rate, number of channels and the maximum duration of the data to put into the fingerprint. Returns nil if the context could not be created.

func PrintVersion

func PrintVersion(w io.Writer)

Types

type Client

type Client struct {
	*client.Client
	// contains filtered or unexported fields
}

func NewClient

func NewClient(ApiKey string, opts ...client.ClientOpt) (*Client, error)

Create a new client

func (*Client) Lookup

func (c *Client) Lookup(fingerprint string, duration time.Duration, flags Meta) ([]*ResponseMatch, error)

Lookup a fingerprint with a duration and the metadata that needs to be returned

type Meta

type Meta uint

const (
	META_RECORDING Meta = (1 << iota)
	META_RECORDINGID
	META_RELEASE
	META_RELEASEID
	META_RELEASEGROUP
	META_RELEASEGROUPID
	META_TRACK
	META_COMPRESS
	META_USERMETA
	META_SOURCE
	META_MIN       = META_RECORDING
	META_MAX       = META_SOURCE
	META_NONE Meta = 0
	META_ALL       = META_RECORDING | META_RECORDINGID | META_RELEASE | META_RELEASEID | META_RELEASEGROUP | META_RELEASEGROUPID | META_TRACK | META_COMPRESS | META_USERMETA | META_SOURCE
)

func (Meta) FlagString

func (m Meta) FlagString() string

func (Meta) String

func (m Meta) String() string

type Response

type Response struct {
	Status  string           `json:"status"`
	Error   ResponseError    `json:"error"`
	Results []*ResponseMatch `json:"results"`
}

type ResponseArtist

type ResponseArtist struct {
	Id   string `json:"id"`
	Name string `json:"name,omitempty"`
}

type ResponseError

type ResponseError struct {
	Code    int    `json:"code"`
	Message string `json:"message"`
}

type ResponseGroup

type ResponseGroup struct {
	Id       string            `json:"id"`
	Type     string            `json:"type,omitempty"`
	Title    string            `json:"title,omitempty"`
	Releases []ResponseRelease `json:"releases,omitempty"`
}

type ResponseMatch

type ResponseMatch struct {
	Id         string              `json:"id"`
	Score      float64             `json:"score"`
	Recordings []ResponseRecording `json:"recordings,omitempty"`
}

func (*ResponseMatch) String

func (r *ResponseMatch) String() string

type ResponseMedium

type ResponseMedium struct {
	Format     string          `json:"format"`
	Position   uint            `json:"position"`
	TrackCount uint            `json:"track_count"`
	Tracks     []ResponseTrack `json:"tracks,omitempty"`
}

type ResponseRecording

type ResponseRecording struct {
	Id            string           `json:"id"`
	Title         string           `json:"title,omitempty"`
	Duration      float64          `json:"duration,omitempty"`
	Artists       []ResponseArtist `json:"artists,omitempty"`
	ReleaseGroups []ResponseGroup  `json:"releasegroups,omitempty"`
}

type ResponseRelease

type ResponseRelease struct {
	Id      string           `json:"id"`
	Mediums []ResponseMedium `json:"mediums,omitempty"`
}

type ResponseTrack

type ResponseTrack struct {
	Id       string           `json:"id"`
	Artists  []ResponseArtist `json:"artists,omitempty"`
	Position uint             `json:"position"`
	Title    string           `json:"title,omitempty"`
}