npm package discovery and stats viewer.

Discover Tips

  • General search

    [free text search, go nuts!]

  • Package details

    pkg:[package-name]

  • User packages

    @[username]

Sponsor

Optimize Toolset

I’ve always been into building performant and accessible sites, but lately I’ve been taking it extremely seriously. So much so that I’ve been building a tool to help me optimize and monitor the sites that I build to make sure that I’m making an attempt to offer the best experience to those who visit them. If you’re into performant, accessible and SEO friendly sites, you might like it too! You can check it out at Optimize Toolset.

About

Hi, 👋, I’m Ryan Hefner  and I built this site for me, and you! The goal of this site was to provide an easy way for me to check the stats on my npm packages, both for prioritizing issues and updates, and to give me a little kick in the pants to keep up on stuff.

As I was building it, I realized that I was actually using the tool to build the tool, and figured I might as well put this out there and hopefully others will find it to be a fast and useful way to search and browse npm packages as I have.

If you’re interested in other things I’m working on, follow me on Twitter or check out the open source projects I’ve been publishing on GitHub.

I am also working on a Twitter bot for this site to tweet the most popular, newest, random packages from npm. Please follow that account now and it will start sending out packages soon–ish.

Open Software & Tools

This site wouldn’t be possible without the immense generosity and tireless efforts from the people who make contributions to the world and share their work via open source initiatives. Thank you 🙏

© 2024 – Pkg Stats / Ryan Hefner

@jrohlandt/ffmetadata

v1.7.0

Published

Read and write media metadata using ffmpeg

Downloads

14

Readme

node-ffmetadata

Read and write media metadata using ffmpeg's metadata framework.

Alternatives

  • https://github.com/voltraco/node-taglib2
  • https://github.com/vankasteelj/mediainfo-wrapper

See also #19 for some discussion.

Usage

var ffmetadata = require("ffmetadata");

// Set path to ffmpeg - optional if in $PATH or $FFMPEG_PATH
ffmetadata.setFfmpegPath("/path/to/ffmpeg");

// Read song.mp3 metadata
ffmetadata.read("song.mp3", function(err, data) {
	if (err) console.error("Error reading metadata", err);
	else console.log(data);
});

// Set the artist for song.mp3
var data = {
  artist: "Me",
};
ffmetadata.write("song.mp3", data, function(err) {
	if (err) console.error("Error writing metadata", err);
	else console.log("Data written");
});

Artwork

You can optionally include an array of files to be added to the source file. This is a destructive action, it will overwrite any previous streams on the file. For audio data, this is typically just one image. For video, this is where you would write additional audio streams or subtitle tracks.

var options = {
  attachments: ["cover.jpg"],
};
ffmetadata.write("song.mp3", {}, options, function(err) {
	if (err) console.error("Error writing cover art");
	else console.log("Cover art added");
});

Metadata

Metadata might include the following fields:

  • "artist": artist name
  • "album": album name
  • "title": song title
  • "track": place in the album (e.g. "5/8")
  • "disc": for multidisc albums
  • "label": record label
  • "date": arbitrary, but usually year (e.g. "2002")

See FFmpeg Metadata for details.

API

ffmetadata.read(file, [options], callback)

The callback function is called (callback(err, data)) with an error or an object containing metadata from file.

If options.dryRun is truthy, the ffmpeg process is not actually invoked and instead an array of the arguments that would have been used to invoke ffmpeg is returned synchronously. The callback argument is not used in this case.

options.coverPath: Option to provide a path, where ffmpeg will save cover image. Unfortunately, ffmpeg will always convert resulted image, based on extension in provided coverPath.

ffmetadata.write(file, data, [options], callback)

Write metadata to file and optionally append additional attachments (e.g., artwork image).

The data object should contain metadata fields supported by FFmpeg. See the metadata section above for more information.

The options object may be provided with any of the following fields:

  • options.attachments: An array of files that should be appended as additional streams to the output. This can be used to e.g., attach artwork images; see the artwork section above for more information.

  • options["id3v1"]: If this property is truthy, id3 v1 will also be included. This is useful if compatibility with Windows Explorer is desired.

  • options["id3v2.3"]: If this property is truthy, id3 v2.3 will be used (instead of the default of v2.4). This is useful if compatibility with Windows Explorer is desired (see #8).

  • options.dryRun: If this property is truthy, the ffmpeg process is not actually invoked and instead an array of the arguments that would have been used to invoke ffmpeg is returned synchronously. The callback argument is not used in this case.

callback(err) is called when finished, with an error if one occurred.

Path to FFmpeg

By default, the module looks for the ffmpeg executable either in the FFMPEG_PATH and PATH environmental variables. You may also set this path in the code by calling the ffmetadata.setFfmpegPath("path/to/ffmpeg") function.

Installation

Dependency: FFmpeg or libav must be installed on the system. This module uses the ffmpeg command-line tool. Version: 0.10.

npm install ffmetadata