TagLib Tag Name Constants and Cross-Format Mapping

import { PROPERTIES, PropertyKey } from "taglib-wasm/constants";

// Access property metadata
const titleProp = PROPERTIES.TITLE;
console.log(titleProp.description); // "The title of the track"
console.log(titleProp.type); // "string"
console.log(titleProp.supportedFormats); // ["ID3v2", "MP4", "Vorbis", "WAV"]
console.log(titleProp.mappings.id3v2.frame); // "TIT2"

// Use for type-safe property access
const title = file.getProperty(PROPERTIES.TITLE.key);
const artist = file.getProperty(PROPERTIES.ARTIST.key);

// Iterate through all known properties with metadata
Object.values(PROPERTIES).forEach((prop) => {
  const value = file.getProperty(prop.key);
  if (value !== undefined) {
    console.log(`${prop.key}: ${value}`);
    console.log(`  Description: ${prop.description}`);
    console.log(`  Type: ${prop.type}`);
    console.log(`  Formats: ${prop.supportedFormats.join(", ")}`);
  }
});

import { Tags } from "taglib-wasm";

// Use constants instead of strings
const title = properties[Tags.Title]?.[0]; // Instead of properties["TITLE"]
const artist = properties[Tags.Artist]?.[0]; // Instead of properties["ARTIST"]
const bpm = properties[Tags.Bpm]?.[0]; // Instead of properties["BPM"]

// Constants map to the standard property names
console.log(Tags.Title); // "TITLE"
console.log(Tags.AlbumArtist); // "ALBUMARTIST"
console.log(Tags.TrackGain); // "REPLAYGAIN_TRACK_GAIN"

import {
  getAllPropertyKeys,
  getPropertiesByFormat,
  getPropertyMetadata,
  isValidProperty,
} from "taglib-wasm/constants";

// Check if a property is valid
isValidProperty("ACOUSTID_ID"); // true
isValidProperty("INVALID_KEY"); // false

// Get metadata about a property
const metadata = getPropertyMetadata("MUSICBRAINZ_TRACKID");
console.log(metadata.description); // "MusicBrainz Track ID"

// Get all available property keys
const allKeys = getAllPropertyKeys(); // ["TITLE", "ARTIST", "ALBUM", ...]

// Get properties supported by a specific format
const mp3Properties = getPropertiesByFormat("MP3");
const flacProperties = getPropertiesByFormat("FLAC");

import { TagLib } from "taglib-wasm";
import { PROPERTIES, Tags } from "taglib-wasm/constants";

const taglib = await TagLib.initialize();
const file = taglib.openFile(audioBuffer);

// Using PROPERTIES constant (recommended - provides rich metadata)
const properties = file.properties();
const title = file.getProperty(PROPERTIES.TITLE.key);
const artist = file.getProperty(PROPERTIES.ARTIST.key);
const musicBrainzId = file.getProperty(PROPERTIES.MUSICBRAINZ_TRACKID.key);

// Using legacy Tags constants (still supported)
const title2 = properties[Tags.Title]?.[0];
const artist2 = properties[Tags.Artist]?.[0];
const album = properties[Tags.Album]?.[0];

// Or using string property names directly
const title3 = properties["TITLE"]?.[0];
const artist3 = properties["ARTIST"]?.[0];

// Using PROPERTIES constant (recommended)
file.setProperty(PROPERTIES.TITLE.key, "My Song Title");
file.setProperty(PROPERTIES.ARTIST.key, "Artist Name");
file.setProperty(PROPERTIES.ALBUMARTIST.key, "Album Artist");
file.setProperty(
  PROPERTIES.MUSICBRAINZ_TRACKID.key,
  "123e4567-e89b-12d3-a456-426614174000",
);

// Or set multiple properties at once
file.setProperties({
  [PROPERTIES.TITLE.key]: ["My Song Title"],
  [PROPERTIES.ARTIST.key]: ["Artist Name"],
  [PROPERTIES.ALBUMARTIST.key]: ["Album Artist"],
  [PROPERTIES.MUSICBRAINZ_TRACKID.key]: [
    "123e4567-e89b-12d3-a456-426614174000",
  ],
});

// Using legacy Tags constants
file.setProperties({
  [Tags.Title]: ["My Song Title"],
  [Tags.Artist]: ["Artist Name"],
  [Tags.AlbumArtist]: ["Album Artist"],
  [Tags.MusicBrainzTrackId]: ["123e4567-e89b-12d3-a456-426614174000"],
});

// Save changes
file.save();
const outputBuffer = file.toBuffer();

// This works the same for MP3, MP4, FLAC, OGG, and WAV files
file.tag.properties.set("TITLE", "Universal Title");
file.tag.properties.set("COMPOSER", "Universal Composer");

// TagLib converts these to:
// - MP3: TIT2 and TCOM frames
// - MP4: ©nam and ©wrt atoms
// - FLAC/OGG: TITLE and COMPOSER vorbis comments
// - WAV: INAM INFO chunk (COMPOSER may not be supported)