audiotags

README

audiotags

library and command to retrieve audio metadata tags (uses TagLib)

• uses libtag directly (doesn't use the C bindings)
• read and write support
• returns the extended metadata (albumartist, composer, discnumber, etc...)
• builds with cgo

Install command and library

go get github.com/nbonaparte/audiotags/audiotags

Install library

go get github.com/nbonaparte/audiotags

Command example

# audiotags '/store/music/John Holloway/J.S. Bach_ The Sonatas and Partitas for violin solo/2-09 Allegro assai [Sonata No. 3 in C major BWV 1005].mp3'
album J.S. Bach: The Sonatas and Partitas for violin solo
date 2007
filetype MPG/3
title Allegro assai [Sonata No. 3 in C major BWV 1005]
tracknumber 9
albumartist John Holloway
artist John Holloway
composer Johann Sebastian Bach
discnumber 2/2
genre Classical
length 320
bitrate 222
samplerate 44100
channels 2

Library example

package main

import (
	"fmt"
	"github.com/nbonaparte/audiotags"
	"log"
	"os"
)

func main() {

	if len(os.Args) != 2 {
		fmt.Println("pass path to file")
		return
	}

	props, audioProps, err := audiotags.Read(os.Args[1])

	if err != nil {
		log.Fatal(err)
	}

	for k, v := range props {
		fmt.Printf("%s %s\n", k, v)
	}

	fmt.Printf("length %d\nbitrate %d\nsamplerate %d\nchannels %d\n",
		audioProps.Length, audioProps.Bitrate, audioProps.Samplerate, audioProps.Channels)

}

Dependencies

On Debian/Ubuntu:

apt-get install libtag1-vanilla

On OS X:

brew install taglib

Documentation

Index

• Constants
• type AudioProperties
• type File
  • func Open(filename string) (*File, error)
  • func (f *File) Close()
  • func (f *File) HasMedia() bool
  • func (f *File) ReadAudioProperties() *AudioProperties
  • func (f *File) ReadImage() (image.Image, error)
  • func (f *File) ReadTags() keyMap
  • func (f *File) RemovePictures() bool
  • func (f *File) WriteImage(img image.Image, format int) error
  • func (f *File) WriteImageData(data []byte, fmt, w, h int) bool
  • func (f *File) WriteTags(tagMap keyMap) bool

Constants

const (
	JPEG = iota
	PNG  = iota
)

Types

type AudioProperties

type AudioProperties struct {
	Length, LengthMs, Bitrate, Samplerate, Channels int
}

type File

type File C.TagLib_FileRefRef

func Open

func Open(filename string) (*File, error)

func (*File) Close

func (f *File) Close()

func (*File) HasMedia

func (f *File) HasMedia() bool

func (*File) ReadAudioProperties

func (f *File) ReadAudioProperties() *AudioProperties

func (*File) ReadImage

func (f *File) ReadImage() (image.Image, error)

func (*File) ReadTags

func (f *File) ReadTags() keyMap

func (*File) RemovePictures

func (f *File) RemovePictures() bool

func (*File) WriteImage

func (f *File) WriteImage(img image.Image, format int) error

func (*File) WriteImageData

func (f *File) WriteImageData(data []byte, fmt, w, h int) bool

func (*File) WriteTags

func (f *File) WriteTags(tagMap keyMap) bool