taglib-api: An FFI layer over TagLib's C bindings

[ audio, bsd3, library ] [ Propose Tags ]

Provides functions for reading and writing metadata for a variety of common audio formats. Currently supports both ID3v1 and ID3v2 for MP3 files, Ogg Vorbis comments and ID3 tags and Vorbis comments in FLAC, MPC, Speex, WavPack TrueAudio, WAV, AIFF, MP4 and ASF files. It also handles management of taglib files and strings, automatically freeing allocations when computation is finished.

[Skip to Readme]

Versions	0.1.0.0, 0.1.1.0, 0.1.1.1, 0.1.1.2, 0.1.1.3
Dependencies	base (==4.), bytestring (>=0.9 && <0.11), containers (==0.5.), mtl (==2.1.), text (==0.11.), transformers (>=0.2 && <0.4) [details]
License	BSD-3-Clause
Copyright	Copyright 2013 Kyle Carter
Author	Kyle Carter
Maintainer	kylcarte@gmail.com
Category	Audio
Uploaded	by KyleCarter at Fri May 24 09:50:11 UTC 2013
Distributions	NixOS:0.1.1.3
Downloads	1903 total (18 in the last 30 days)
Rating	(no votes yet) [estimated by rule of succession]
Your Rating	λ λ λ
Status	Docs uploaded by user Build status unknown [no reports yet] Hackage Matrix CI

Modules

[Index]

Audio
- Audio.TagLib
  - Audio.TagLib.Internal

Flags

Name	Description	Default	Type
usepkgconfig	Use pkg-config to check for library dependencies.	Enabled	Automatic

Use -f <flag> to enable a flag, or -f -<flag> to disable that flag. More info

Downloads

taglib-api-0.1.1.3.tar.gz [browse] (Cabal source package)
Package description (as included in the package)

Maintainer's Corner

For package maintainers and hackage trustees

edit package information

Readme for taglib-api-0.1.1.3

[back to package description]

taglib-api

An FFI layer over TagLib's C bindings that provides functions for reading and writing metadata for a variety of common audio formats.

It also manages taglib files and strings, automatically freeing allocations when computation is finished.

TagLib currently supports:

ID3v1 and ID3v2 for MP3 files
Ogg Vorbis comments
ID3 tags and Vorbis comments in FLAC, MPC, Speex, WavPack TrueAudio, WAV, AIFF, MP4 and ASF files.

The library is split into two modules, Audio.TagLib, and Audio.TagLib.Internal.

Audio.TagLib provides a memory-managing interface. The function 'taglib' embeds a TagLib computation into the IO monad. Files may be opened with 'openFile', and their metadata read and written with the provided functions. When the block is finished, all open files are saved, and all memory allocated will be freed.

Audio.TagLib.Internal provides bindings for all functions necessary for manual management of TagLib memory. 'runTagLib' embeds a TagLib computation into the IO monad, but it takes an initial TagLibEnv and returns the final TagLibEnv along with the result of the computation.

Any changes made to audio files will not be saved unless 'cleanupFile' is called on their 'Ptr File'. Additionally, TagLib allocates space in order to return its string values, and these will remain allocated unless freed by the managed 'taglib' function, or by the manual 'freeTagLibStrings' function.