age-ha / go-flac

go library for manipulating FLAC metadata

go-flac

go library for manipulating FLAC metadata

Introduction

A FLAC(Free Lossless Audio Codec) stream generally consists of 3 parts: a "fLaC" header to mark the stream as an FLAC stream, followed by one or more metadata blocks which stores metadata and information regarding the stream, followed by one or more audio frames. This package encapsulated the operations that extract and split FLAC metadata blocks from a FLAC stream file and assembles them back after modification. this package only implemented parsing the essential StreamInfo metadata block by File#GetStreamInfo, other metadata block operations should be provided by other packages.

Usage

go-flac provided three APIs for reading FLAC files and returns a File struct:

• ParseBytes for consuming a whole FLAC stream from an io.Reader.
• ParseFile for consuming a whole FLAC stream from a file.
• ParseMetadata for consuming only metadata from am io.Reader.

The File struct has two exported fields, Meta and Frames, the Frames consisted of raw stream data and the Meta field was a slice of all MetaDataBlocks present in the file. Other packages could parse/construct a MetadataBlock by inspecting its Type field and apply proper decoding/encoding on the Data field of the MetadataBlock. You can modify the elements in the Meta field of a File as you like, as long as the StreamInfo metadata block is the first element in Meta field, according to the specs of FLAC format.

Examples

The following example extracts the sample rate of a FLAC file.

package example

import (
    "github.com/go-flac/go-flac"
)

func getSampleRate(fileName string) int {
	f, err := flac.ParseFile(fileName)
	if err != nil {
		panic(err)
	}
	data, err := f.GetStreamInfo()
	if err != nil {
		panic(err)
	}
	return data.SampleRate
}

The following example adds a jpeg image as front cover to the FLAC metadata using flacpicture.

package example

import (
    "github.com/go-flac/flacpicture"
    "github.com/go-flac/go-flac"
)

func addFLACCover(fileName string, imgData []byte) {
	f, err := flac.ParseFile(fileName)
	if err != nil {
		panic(err)
	}
	picture, err := flacpicture.NewFromImageData(flacpicture.PictureTypeFrontCover, "Front cover", imgData, "image/jpeg")
	if err != nil {
		panic(err)
	}
	picturemeta := picture.Marshal()
	f.Meta = append(f.Meta, &picturemeta)
	f.Save(fileName)
}