Node-taglib-sharp NPM

TagLib# for Node

Master	Develop	Latest

Description

TagLib# is a .NET library that has been around for years. It provides a unified interface for accessing metadata from a vast selection of media files. Until now there hasn't been a port of this library for Node.js. This project is a mostly wholesale translation of the original TagLib#.

Note: A port of TagLib already exists for Node.js. Despite TagLib being the origin of TabLib#, it is substantially lacking in the variety of media formats that can be handled. TagLib# greatly improved on the original TagLib, hence why this project exists.

Supported Tagging Formats

APE: AAC, APE, FLAC, M2A, MP1, MP2, MP3
Apple QuickTime/iTunes MPEG4: M4A, M4B, M4P, M4V, MP4
ASF: ASF, WMA, WMV
DIVX: AVI, DIVX, WAV
ID3v1: AAC, FLAC, M2A, MP1, MP2, MP3
ID3v2: AAC, AIF, AIFF, AVI, DIVX, FLAC, M2A, MP1, MP2, MP3, WAV
Matroska/WebM: MK3D, MKA, MKS, MKV, WEBM read-only
MovieID: AVI, DIVX, WAV
RIFF Info: AVI, DIVX, WAV
Xiph Comment: FLAC, OGA, OGG, OGV, OPUS
... More coming soon

Supported File Formats

Advanced Audio Codec (AAC): AAC
Advanced Systems Format (ASF): ASF, WMA, WMV
Audio Interchange Format (AIFF): AIF, AIFF
Free Lossless Audio Codec (FLAC): FLAC
Matroska: MK3D, MKA, MKS, MKV
MPEG-1/2 Audio: M2A, MP1, MP2, MP3
MPEG-1/2 Video: M2V, MPE, MPEG, MPG, MPV2
MPEG4: M4A, M4B, M4P, M4V, MP4
Monkey's Audio: APE
Ogg: OGA, OGG, OGV, OPUS
Resource Interchange File Format (RIFF): AVI, DIVX, WAV
WebM: WEBM
... More coming soon

Installation

npm install --save node-taglib-sharp

Getting Started

Getting started with node-taglib-sharp is surprisingly easy. The main entry point into the library is via the File class.

import {File} from "node-taglib-sharp";

const myFile = File.createFromPath("path/to/my/file.mp3");

The File class provides factory methods for generating instances of classes that inherit from File to provide implementation specific to a file format (such as ApeFile providing support for Monkey's Audio files). The File class has exposes the properties and tag properties to allow manipulation of the tagging information and reading audio/video properties.

See the docs for the File class for complete details of the available properties.

console.log(myFile.properties.audioBitrate);
console.log(myFile.tag.title);

The Tag base class provides a tagging-format agnostic interface to modify tag(s) on the file object. Set tag properties as needed and they will be stored in a tagging format that is supported by the file type. The changes can be easily written back to the file with save().

See the docs for the Tag class for complete details of the fields supported by the format-agnostic Tag class.

myFile.tag.title = "Time Won't Let Me Go";
myFile.tag.album = "The Sun And The Moon";
myFile.tag.performers = ["The Bravery"];
myFile.save();
myFile.dispose();

Known Issues

Maximum supported file size is 8192TB
- Why is this an issue? 8192TB is yuuuuge, but .NET implementation supports 8192PB file sizes.
- The Node.js 12 fs library only supports integer types for position arguments, which safely goes up to 2^52 - 1. Node 15 supports number or biginteger for position arguments which would increase supported sizes to 64-bit integers. Please create issue if this is a blocker.