Commits

shuerhaaken committed cb7e23c

add README.markdown

  • Participants
  • Parent commits 0fbb6c9

Comments (0)

Files changed (1)

File README.markdown

+**TagInfo** is a library for reading media metadata (tags).
+
+It is a wrapper for TagLib. 
+TagLib is a library for reading and editing the meta-data of several popular audio formats. Currently it 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.
+
+TagInfo is quite fast. Tests have shown that it is about 40 - 60 times faster in file reading that with GStreamer based file reading using the codecs. This might be less accurate reading, but the convenience of a sync and fast library without many external dependencies outweighs this by far.
+
+This library offers **C and vala bindings** that provide a lot of features that are not available via TagLib's own C bindings (and the according vala bindings). The bindings are the original reason for the creation of this library
+
+Feature are reading/writing things like 
+ - Artist name
+ - Album name
+ - Track title
+ - Genre
+ - AlbumArtist
+ - Comments
+ - Disk number
+ - Compilation flag
+ - User labels
+ - Images
+ - Lyrics
+ - Audio properties (length, bitrate, ...)
+ - ...
+
+
+This library is under development!
+
+API might change, although it has been stabilized in the last months.
+
+API will be extended.
+
+A few functionalities are not implemented for some file types.
+
+
+
+***
+
+**PLEASE HELP IMPROVING TAGINFO!**
+
+I would appreciate to collect patches for this library and improve it for the benefit of everybody that needs a convenient, fast (and toolkit independent) C / Vala API for tag reading/writing.
+
+There is a TODO file in the project folder listing some things that need to be done.
+
+***
+
+This library has been developed by shuerhaaken for the xnoise media player.
+
+Original C++ code was extracted from the guayadeque media player.
+
+C bindings by shuerhaaken.
+
+Vala bindings by shuerhaaken.
+
+***
+If you have questions please ask on the xnoise mailing list:
+
+**[xnoise mailing list](http://groups.google.com/group/xnoise)**
+
+***
+
+**[xnoise home page](http://www.xnoise-media-player.com/)**
+