id3-go/v2/id3v23.go

173 wiersze
10 KiB
Go

// Copyright 2013 Michael Yang. All rights reserved.
// Use of this source code is governed by a MIT-style
// license that can be found in the LICENSE file.
package v2
import (
"github.com/jcs/id3-go/encodedbytes"
"io"
)
var (
// Common frame IDs
V23CommonFrame = map[string]FrameType{
"Title": V23FrameTypeMap["TIT2"],
"Artist": V23FrameTypeMap["TPE1"],
"Album": V23FrameTypeMap["TALB"],
"Year": V23FrameTypeMap["TYER"],
"Genre": V23FrameTypeMap["TCON"],
"Comments": V23FrameTypeMap["COMM"],
}
// V23DeprecatedTypeMap contains deprecated frame IDs from ID3v2.2
V23DeprecatedTypeMap = map[string]string{
"BUF": "RBUF", "COM": "COMM", "CRA": "AENC", "EQU": "EQUA",
"ETC": "ETCO", "GEO": "GEOB", "MCI": "MCDI", "MLL": "MLLT",
"PIC": "APIC", "POP": "POPM", "REV": "RVRB", "RVA": "RVAD",
"SLT": "SYLT", "STC": "SYTC", "TAL": "TALB", "TBP": "TBPM",
"TCM": "TCOM", "TCO": "TCON", "TCR": "TCOP", "TDA": "TDAT",
"TDY": "TDLY", "TEN": "TENC", "TFT": "TFLT", "TIM": "TIME",
"TKE": "TKEY", "TLA": "TLAN", "TLE": "TLEN", "TMT": "TMED",
"TOA": "TOPE", "TOF": "TOFN", "TOL": "TOLY", "TOR": "TORY",
"TOT": "TOAL", "TP1": "TPE1", "TP2": "TPE2", "TP3": "TPE3",
"TP4": "TPE4", "TPA": "TPOS", "TPB": "TPUB", "TRC": "TSRC",
"TRD": "TRDA", "TRK": "TRCK", "TSI": "TSIZ", "TSS": "TSSE",
"TT1": "TIT1", "TT2": "TIT2", "TT3": "TIT3", "TXT": "TEXT",
"TXX": "TXXX", "TYE": "TYER", "UFI": "UFID", "ULT": "USLT",
"WAF": "WOAF", "WAR": "WOAR", "WAS": "WOAS", "WCM": "WCOM",
"WCP": "WCOP", "WPB": "WPB", "WXX": "WXXX",
}
// V23FrameTypeMap specifies the frame IDs and constructors allowed in ID3v2.3
V23FrameTypeMap = map[string]FrameType{
"AENC": FrameType{id: "AENC", description: "Audio encryption", constructor: ParseDataFrame},
"APIC": FrameType{id: "APIC", description: "Attached picture", constructor: ParseImageFrame},
"CHAP": FrameType{id: "CHAP", description: "Chapter frame", constructor: nil},
"COMM": FrameType{id: "COMM", description: "Comments", constructor: ParseUnsynchTextFrame},
"COMR": FrameType{id: "COMR", description: "Commercial frame", constructor: ParseDataFrame},
"CTOC": FrameType{id: "CTOC", description: "Chapter table of contents", constructor: nil},
"ENCR": FrameType{id: "ENCR", description: "Encryption method registration", constructor: ParseDataFrame},
"EQUA": FrameType{id: "EQUA", description: "Equalization", constructor: ParseDataFrame},
"ETCO": FrameType{id: "ETCO", description: "Event timing codes", constructor: ParseDataFrame},
"GEOB": FrameType{id: "GEOB", description: "General encapsulated object", constructor: ParseDataFrame},
"GRID": FrameType{id: "GRID", description: "Group identification registration", constructor: ParseDataFrame},
"IPLS": FrameType{id: "IPLS", description: "Involved people list", constructor: ParseDataFrame},
"LINK": FrameType{id: "LINK", description: "Linked information", constructor: ParseDataFrame},
"MCDI": FrameType{id: "MCDI", description: "Music CD identifier", constructor: ParseDataFrame},
"MLLT": FrameType{id: "MLLT", description: "MPEG location lookup table", constructor: ParseDataFrame},
"OWNE": FrameType{id: "OWNE", description: "Ownership frame", constructor: ParseDataFrame},
"PRIV": FrameType{id: "PRIV", description: "Private frame", constructor: ParseDataFrame},
"PCNT": FrameType{id: "PCNT", description: "Play counter", constructor: ParseDataFrame},
"POPM": FrameType{id: "POPM", description: "Popularimeter", constructor: ParseDataFrame},
"POSS": FrameType{id: "POSS", description: "Position synchronisation frame", constructor: ParseDataFrame},
"RBUF": FrameType{id: "RBUF", description: "Recommended buffer size", constructor: ParseDataFrame},
"RVAD": FrameType{id: "RVAD", description: "Relative volume adjustment", constructor: ParseDataFrame},
"RVRB": FrameType{id: "RVRB", description: "Reverb", constructor: ParseDataFrame},
"SYLT": FrameType{id: "SYLT", description: "Synchronized lyric/text", constructor: ParseDataFrame},
"SYTC": FrameType{id: "SYTC", description: "Synchronized tempo codes", constructor: ParseDataFrame},
"TALB": FrameType{id: "TALB", description: "Album/Movie/Show title", constructor: ParseTextFrame},
"TBPM": FrameType{id: "TBPM", description: "BPM (beats per minute)", constructor: ParseTextFrame},
"TCOM": FrameType{id: "TCOM", description: "Composer", constructor: ParseTextFrame},
"TCON": FrameType{id: "TCON", description: "Content type", constructor: ParseTextFrame},
"TCOP": FrameType{id: "TCOP", description: "Copyright message", constructor: ParseTextFrame},
"TDAT": FrameType{id: "TDAT", description: "Date", constructor: ParseTextFrame},
"TDLY": FrameType{id: "TDLY", description: "Playlist delay", constructor: ParseTextFrame},
"TENC": FrameType{id: "TENC", description: "Encoded by", constructor: ParseTextFrame},
"TEXT": FrameType{id: "TEXT", description: "Lyricist/Text writer", constructor: ParseTextFrame},
"TFLT": FrameType{id: "TFLT", description: "File type", constructor: ParseTextFrame},
"TIME": FrameType{id: "TIME", description: "Time", constructor: ParseTextFrame},
"TIT1": FrameType{id: "TIT1", description: "Content group description", constructor: ParseTextFrame},
"TIT2": FrameType{id: "TIT2", description: "Title/songname/content description", constructor: ParseTextFrame},
"TIT3": FrameType{id: "TIT3", description: "Subtitle/Description refinement", constructor: ParseTextFrame},
"TKEY": FrameType{id: "TKEY", description: "Initial key", constructor: ParseTextFrame},
"TLAN": FrameType{id: "TLAN", description: "Language(s)", constructor: ParseTextFrame},
"TLEN": FrameType{id: "TLEN", description: "Length", constructor: ParseTextFrame},
"TMED": FrameType{id: "TMED", description: "Media type", constructor: ParseTextFrame},
"TOAL": FrameType{id: "TOAL", description: "Original album/movie/show title", constructor: ParseTextFrame},
"TOFN": FrameType{id: "TOFN", description: "Original filename", constructor: ParseTextFrame},
"TOLY": FrameType{id: "TOLY", description: "Original lyricist(s)/text writer(s)", constructor: ParseTextFrame},
"TOPE": FrameType{id: "TOPE", description: "Original artist(s)/performer(s)", constructor: ParseTextFrame},
"TORY": FrameType{id: "TORY", description: "Original release year", constructor: ParseTextFrame},
"TOWN": FrameType{id: "TOWN", description: "File owner/licensee", constructor: ParseTextFrame},
"TPE1": FrameType{id: "TPE1", description: "Lead performer(s)/Soloist(s)", constructor: ParseTextFrame},
"TPE2": FrameType{id: "TPE2", description: "Band/orchestra/accompaniment", constructor: ParseTextFrame},
"TPE3": FrameType{id: "TPE3", description: "Conductor/performer refinement", constructor: ParseTextFrame},
"TPE4": FrameType{id: "TPE4", description: "Interpreted, remixed, or otherwise modified by", constructor: ParseTextFrame},
"TPOS": FrameType{id: "TPOS", description: "Part of a set", constructor: ParseTextFrame},
"TPUB": FrameType{id: "TPUB", description: "Publisher", constructor: ParseTextFrame},
"TRCK": FrameType{id: "TRCK", description: "Track number/Position in set", constructor: ParseTextFrame},
"TRDA": FrameType{id: "TRDA", description: "Recording dates", constructor: ParseTextFrame},
"TRSN": FrameType{id: "TRSN", description: "Internet radio station name", constructor: ParseTextFrame},
"TRSO": FrameType{id: "TRSO", description: "Internet radio station owner", constructor: ParseTextFrame},
"TSIZ": FrameType{id: "TSIZ", description: "Size", constructor: ParseTextFrame},
"TSRC": FrameType{id: "TSRC", description: "ISRC (international standard recording code)", constructor: ParseTextFrame},
"TSSE": FrameType{id: "TSSE", description: "Software/Hardware and settings used for encoding", constructor: ParseTextFrame},
"TYER": FrameType{id: "TYER", description: "Year", constructor: ParseTextFrame},
"TXXX": FrameType{id: "TXXX", description: "User defined text information frame", constructor: ParseDescTextFrame},
"UFID": FrameType{id: "UFID", description: "Unique file identifier", constructor: ParseIdFrame},
"USER": FrameType{id: "USER", description: "Terms of use", constructor: ParseDataFrame},
"TCMP": FrameType{id: "TCMP", description: "Part of a compilation (iTunes extension)", constructor: ParseTextFrame},
"USLT": FrameType{id: "USLT", description: "Unsychronized lyric/text transcription", constructor: ParseUnsynchTextFrame},
"WCOM": FrameType{id: "WCOM", description: "Commercial information", constructor: ParseDataFrame},
"WCOP": FrameType{id: "WCOP", description: "Copyright/Legal information", constructor: ParseDataFrame},
"WOAF": FrameType{id: "WOAF", description: "Official audio file webpage", constructor: ParseDataFrame},
"WOAR": FrameType{id: "WOAR", description: "Official artist/performer webpage", constructor: ParseDataFrame},
"WOAS": FrameType{id: "WOAS", description: "Official audio source webpage", constructor: ParseDataFrame},
"WORS": FrameType{id: "WORS", description: "Official internet radio station homepage", constructor: ParseDataFrame},
"WPAY": FrameType{id: "WPAY", description: "Payment", constructor: ParseDataFrame},
"WPUB": FrameType{id: "WPUB", description: "Publishers official webpage", constructor: ParseDataFrame},
"WXXX": FrameType{id: "WXXX", description: "User defined URL link frame", constructor: ParseDescTextFrame},
}
)
func ParseV23Frame(reader io.Reader) Framer {
data := make([]byte, FrameHeaderSize)
if n, err := io.ReadFull(reader, data); n < FrameHeaderSize || err != nil {
return nil
}
id := string(data[:4])
t, ok := V23FrameTypeMap[id]
if !ok {
return nil
}
size, err := encodedbytes.NormInt(data[4:8])
if err != nil {
return nil
}
h := FrameHead{
FrameType: t,
statusFlags: data[8],
formatFlags: data[9],
size: size,
}
frameData := make([]byte, size)
if n, err := io.ReadFull(reader, frameData); n < int(size) || err != nil {
return nil
}
// can't reference these from the table or they will cause an
// initialization loop
switch id {
case "CHAP":
t.constructor = ParseChapterFrame
case "CTOC":
t.constructor = ParseTOCFrame
}
return t.constructor(h, frameData)
}
func V23Bytes(f Framer) []byte {
headBytes := make([]byte, 0, FrameHeaderSize)
headBytes = append(headBytes, f.Id()...)
headBytes = append(headBytes, encodedbytes.NormBytes(uint32(f.Size()))...)
headBytes = append(headBytes, f.StatusFlags(), f.FormatFlags())
return append(headBytes, f.Bytes()...)
}