Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

https://github.com/voltraco/node-taglib2

A rewrite of the now unmaintained node-taglib
https://github.com/voltraco/node-taglib2

metadata music taglib tags

Last synced: 3 months ago
JSON representation

A rewrite of the now unmaintained node-taglib

Awesome Lists containing this project

README

        

# SYNOPSIS
taglib version 2 bindings

# BUILD STATUS
[![Build status](https://ci.appveyor.com/api/projects/status/fkt7jiqubahuja5o?svg=true)](https://ci.appveyor.com/project/0x00A/node-taglib2)

# INSTALLATION

### OSX/Linux

You need to have installed a proper C/C++ compiler toolchain, like GCC (For OSX please download [Xcode and Command Line Tools](https://developer.apple.com/xcode/))

### Windows

You need to have Visual C++ Build Environment setup, which you can download as a standalone [Visual C++ Build Tools](http://landinghub.visualstudio.com/visual-cpp-build-tools) package or get it as part of [Visual Studio 2015](https://www.visualstudio.com/products/visual-studio-community-vs).

# USAGE
For example, with electron...

```
ELECTRON=1 npm install
```

### WRITING TAGS
Note that `track` will overwrite `tracknumber` if specified in the same write.

```js
const taglib = require('taglib2')
const mime = require('node-mime')
const fs = require('fs')

const props = {
artist: 'Howlin\' Wolf',
title: 'Evil is goin\' on',
album: 'Smokestack Lightnin\'',
comment: 'Chess Master Series',
genre: 'blues',
year: 1951,
track: 3,
tracknumber: '1/1',
discnumber: '1/1',
pictures: [
{
"mimetype": mime('./cover.jpg'),
"picture": fs.readFileSync('./cover.jpg')
}
],
}

taglib.writeTagsSync('./file.mp3', props)
```

### READING TAGS

```js
const taglib = require('taglib2')
const tags = taglib.readTagsSync('./file.mp3')
```

#### OUTPUT
`tags.pictures` will be an array of buffers that contain image data.

```json
{
"artist": "Howlin' Wolf",
"albumartist": "Howlin' Wolf",
"title": "Evil is goin' on",
"album": "Smokestack Lightnin'",
"comment": "Chess Master Series",
"composer": "Chester Burnett",
"genre": "blues",
"year": 1951,
"track": 3,
"tracknumber": "3/3",
"discnumber": "1/1",
"pictures": [
{
"mimetype": "image/jpeg",
"picture":
}
],
"bitrate": 192,
"bpm": 120,
"samplerate": 44100,
"channels": 2,
"compilation": false,
"time": "1:30",
"length": 90
}
```