Transformer documentation: int_daisy_audioTagger
Transformer Purpose
Add ID3 tags and playlists to filesets containing audio.
The transformer has been written with the intention to work on any file/fileset that
can be represented by the org.daisy.util.fileset package.
However, preference has been given to DTB filesets - other types are not explicitly supported.
Output
- Tagging of MP3 files
- ID3v23 tags are added to all MP3 files, containing values for title (heading), album title (book title) artist (author) and order (n/x) fields of these were settable based on the input fileset.
- Playlist generation
- The following playlist types are generated:
On success
A file/fileset whose members have had ID3v23 Tags added to its MP3files and/or has had playlists generated to the set output directory. See parameters
On error
On error, this transformer will send a fatal message, then throw an exception and abort.
Configuration/Customization
Parameters (tdf)
- input
- The input fileset manifest file (ncc, opf, etc)
- output
- The output directory
- doID3Tagging
- Whether to perform ID3 tagging. Defaults to true.
- doPlaylistGeneration
- Whether to generate playlists. Defaults to true.
Extended configurability
None.
Further development
Extend support for non-DTB filesets.
Dependencies
- jaudiotagger.jar (at time of writing: a tweaked and locally compiled version (available on pipeline SVN /lib/) that renders ID3Tags in UTF16LE, else win media player will not play the files.)
Author
Markus Gylling, Daisy Consortium
Licensing
LGPL