How mewkiz/flac works
This is a Go library for reading and writing FLAC audio streams. A caller opens a reader or seeker as a Stream, which parses stream metadata, advances through audio frames, and decodes their channel subframes into samples; seeking uses the seek table and frame positions. The experimental encoder writes metadata and audio frames, with separate subframe encoding. Metadata block types and low-level bit and checksum helpers support these paths. Some encoder wiring and seeking details are documented or indexed but not shown in the excerpts, so those links are omitted or marked unverified.
Main entry points: frame.go Frame parser · encode.go Encoder API · encode_frame.go Frame encoder · flac.go Stream API
Components 17
Stream access
- Stream API
flac.go - Frame seeking
flac.go
Metadata
- Block reader
meta/meta.go - Metadata types
meta
Audio frames
- Frame parser
frame/frame.go - Subframe decoder
frame/subframe.go
Encoding
- Encoder API
encode.go - Frame encoder
encode_frame.go - Subframe encoder
encode_subframe.go - Metadata encoder
encode_meta.go
Format primitives
- Bit reader
internal/bits/reader.go - Frame checksums
internal/hashutil - Frame number codec
internal/utf8 - Buffered seeker
internal/bufseekio/readseeker.go
Other components
- Library caller
- Decoded samples
- FLAC stream
Connections 21
- Library caller → Stream API: opens stream
flac.go - Stream API → Block reader: parses blocks
flac.go - Block reader → Metadata types: dispatches types
meta/meta.go - Stream API → Frame parser: parses frames
- Frame parser → Subframe decoder: parses subframes
frame/frame.go - Subframe decoder → Bit reader: reads bits
frame/subframe.go - Frame parser → Bit reader: reads headers
frame/frame.go - Frame parser → Frame checksums: checks frames
frame/frame.go - Frame parser → Frame number codec: decodes numbers
frame/frame.go - Subframe decoder → Decoded samples: decodes samples
frame/subframe.go - Library caller → Frame seeking: seeks samples
flac.go - Frame seeking → Buffered seeker: buffers seeks
flac.go - Frame seeking → Frame parser: parses frames
flac.go - Library caller → Encoder API: encodes audio
- Encoder API → Metadata encoder: writes metadata
- Encoder API → Frame encoder: writes frames
- Frame encoder → Subframe encoder: encodes subframes
- Frame encoder → Frame checksums: checks frame data
encode_frame.go - Frame encoder → Frame number codec: encodes numbers
encode_frame.go - Metadata encoder → Metadata types: serializes types
encode_meta.go - Encoder API → FLAC stream: writes stream