2015-05-24 03:29:38 +02:00
|
|
|
# MP3/MP4/OGG/FLAC metadata parsing library
|
2015-03-19 23:09:07 +01:00
|
|
|
[](https://travis-ci.org/dhowden/tag)
|
2015-03-19 13:29:03 +01:00
|
|
|
[](https://godoc.org/github.com/dhowden/tag)
|
|
|
|
|
|
2015-05-24 03:29:38 +02:00
|
|
|
This package provides MP3 (ID3v1,2.{2,3,4}) and MP4 (ACC, M4A, ALAC), OGG and FLAC metadata detection, parsing and artwork extraction.
|
2015-04-03 06:12:30 +02:00
|
|
|
|
|
|
|
|
Parsed metadata is exported via a single interface (giving a consistent API for all supported metadata formats).
|
|
|
|
|
|
|
|
|
|
// Metadata is an interface which is used to describe metadata retrieved by this package.
|
|
|
|
|
type Metadata interface {
|
|
|
|
|
Format() Format
|
2015-05-24 03:29:38 +02:00
|
|
|
FileType() FileType
|
2015-04-03 06:12:30 +02:00
|
|
|
|
|
|
|
|
Title() string
|
|
|
|
|
Album() string
|
|
|
|
|
Artist() string
|
|
|
|
|
AlbumArtist() string
|
|
|
|
|
Composer() string
|
2015-05-24 14:25:04 +02:00
|
|
|
Genre() string
|
2015-04-03 06:12:30 +02:00
|
|
|
Year() int
|
|
|
|
|
|
|
|
|
|
Track() (int, int) // Number, Total
|
|
|
|
|
Disc() (int, int) // Number, Total
|
|
|
|
|
|
|
|
|
|
Picture() *Picture // Artwork
|
2015-05-24 14:49:06 +02:00
|
|
|
Lyrics() string
|
2015-04-03 06:12:30 +02:00
|
|
|
|
|
|
|
|
Raw() map[string]interface{} // NB: raw tag names are not consistent across formats.
|
|
|
|
|
}
|
|
|
|
|
|
|
|
|
|
## Audio Data Checksum (SHA1)
|
|
|
|
|
|
|
|
|
|
This package also provides a metadata-invariant checksum for audio files: only the audio data is used to
|
|
|
|
|
construct the checksum.
|
|
|
|
|
|
|
|
|
|
[http://godoc.org/github.com/dhowden/tag#Sum](http://godoc.org/github.com/dhowden/tag#Sum)
|
|
|
|
|
|
|
|
|
|
## Example Usage
|
|
|
|
|
|
|
|
|
|
There are a simple command-line tools which demonstrate basic tag extraction and summing:
|
|
|
|
|
|
|
|
|
|
$ go get github.com/dhowden/tag/...
|
|
|
|
|
$ cd $GOPATH/bin
|
|
|
|
|
$ ./tag 11\ High\ Hopes.m4a
|
|
|
|
|
Metadata Format: MP4
|
|
|
|
|
Title: High Hopes
|
|
|
|
|
Album: The Division Bell
|
|
|
|
|
Artist: Pink Floyd
|
|
|
|
|
Composer: Abbey Road Recording Studios/David Gilmour/Polly Samson
|
|
|
|
|
Year: 1994
|
|
|
|
|
Track: 11 of 11
|
|
|
|
|
Disc: 1 of 1
|
|
|
|
|
Picture: Picture{Ext: jpeg, MIMEType: image/jpeg, Type: , Description: , Data.Size: 606109}
|
|
|
|
|
|
|
|
|
|
$ ./sum 11\ High\ Hopes.m4a
|
|
|
|
|
2ae208c5f00a1f21f5fac9b7f6e0b8e52c06da29
|
