@ng.huyy/node-id3v2.4

####node-id3v2.4

###node id3 tagger
- read/write ID3v2.3 / ID3v2.4 tags
- use/convert encodings 'ISO-8859-1','UTF-16',(ID3v2.4)'UTF-16BE','UTF-8'
- add, convert (imagemagic) and extract images ('APIC')

###Installation
``
npm install node-id3v2.4
`
##Include
To use the library:
`
const nodeID3v2 = require('node-id3v2.4');
`
To read a tag:
`
let tag = nodeID3v2.readTag(filename);
`

###node-id3tag
After installation 'node-id3tag' command will also be available for use in shell/cmd.

##Help:
you can try to get help on 'topic' (and 'subtopic')
`
node-id3tag [-?|-h]
node-id3tag -? picturetype
node-id3tag -h frametype image
`
##List tag with:
`
node-id3tag -l 'path/to/file.mp3'
`
##Add frame:
`
node-id3tag -af artist,'the artists name' 'path/to/file.mp3'
`
##Add frame and list tag:
`
node-id3tag -l -af image,'path/to/image','picturetype' 'path/to/file.mp3'
`
##Tag is not writen until you add '-u' argument:
`
node-id3tag -l -u -af TXXX,'my description','my text' 'path/to/file.mp3'
`
##Remove frame:
`
node-id3tag -u -RF title 'path/to/file.mp3'
`
##Remove ambiguous frame with:
`
node-id3tag -u -RF TXXX 'path/to/file.mp3'
`
gives a message:
`
[-1] : removeFrame: insufficient criteria: ''. should be 'description'
`
so you have to:
`
node-id3tag -u -RF TXXX,'my description' 'path/to/file.mp3'
``

##Notes:

There are many media files in the wild with malformed tags or frames, which
sometimes leads to unpredictable behaviour.

TODO:

- support for all possible frame types
- use 'template' approach for reading in data ( add Buffer.eat() )
- clean code
- improve stability with malformed tags/frames