Just some trivia: There are 1.5MB of source files with 52487 lines. Of that, 844kb and 23911 lines are API documentation comments. That means over 50% of the contents of the source is documentation.

Had I been faced with these facts a year and a half ago, I may have simply not written the library, but since I did, you can enjoy the documentation at http://www.taglib-sharp.com/docs/ Yes, that “Documentation” link at the top of the page now actually leads to documentation.

- Brian

After a bit of a delay TagLib# 2.0.3.0 is out. This release features fixes to a tonne of bugs that have been discovered since 2.0.2.0. I would recommend this upgrade to anyone using 2.0.2.0.

NEWS Entry

Version 2.0.3.0
January 10, 2008

This release of TagLib# features many bug fixes and a complete rework of the
documentation to better serve the Windows community. Fixes include:
	* Make Asf.Tag enumerable.
	* Don't duplicate genres stored in "(0)Blues" format.
	* Save Id3v2.RelativeVolumeFrame as XRVA and XRV in ID3v2.3 and ID3v2.2.
	* Insert new comments before other comment frames in Id3v2.Tag
	* Use CultureInfo.CurrentCulture to get the correct comment language in
	  Id3v2.Tag.
	* Skip iTunes comments in Id3v2.CommentsFrame.
	* Save multi-string values as a single box with a semicolon separator
	  in Mpeg4.AppleTag to improve compatability with iTunes.
	* Make the Id3v2.Tag.DefaultVersion = 3 because most commercial programs
	  have some crippling ID3v2.4 problem.
	* Added Id3v2.Tag.IsCompilation
	* Don't crash on misformatted field in XiphComment.
	* Recognize the .divx extension as a RIFF file.
	* Use one byte rather than four to store compilation in Mpeg4.AppleTag.
	* Don't check the image format flags anymore in Mpeg4.AppleTag, just use
	  the file contents.
	* Don't crash in NonContainer.EndTag when the file is less than 128
	  bytes.
	* Allow saving of multi-page comment packets in Ogg through massive
	  rewrite of pagination.
	* Allow correct reading of multi-page comment packets in Ogg.Bitstream.
	* Use try/finally on all load and save operations to prevent files from
	  being left open.
	* Produce correct output on empty ID3v1 tag.
	* Remove broken Id3v1.Tag.IsEmpty.
	* src/TagLib/Riff/List.cs: Make sure fields are cleared when SetValue
	* Clear value when null is passed in Riff.List.SetValue.
	* Make Riff.DivXTag.Clear clear the title.
	* Read genres correctly in Riff.MovieIdTag.
	* Complete codec descriptions for RIFF and ASF files.
	* Fix reading of UTF16-BE Id3v2.SynchronizedLyricsFrames.
	* Throw NotImplementedException for private frames in ID3v2.2.
	* Fix writing Id3v2.GeneralEncapulatedObjectFrame in UTF16.
	* Added support for multiple non-indexed artists in ID3v2.3
	* Correctly parse nil separated UTF-16BE strings.
	* Allow parsing of variable length years in Ape.Tag.
	* Fix writing of Mpeg4 files by correctly reading in values to
	  Mpeg4.FileParser.UtdaTree.
	* Allow parsing of all year lengths in Mpeg4.AppleTag and correctly
	  clear zeroed values.
	* Use Semicolons rather than commas in Tag.Joined* to reflect the
	  behavior of Windows Media Player.
	* Remove "WM/GenreID" from Asf.Tag when storing a new genre.
	* Switch ordering of check in looking for ASF content descriptors to
	  emphasize name rather than order.
	* Don't throw exception on zero byte strings in ByteVector.ToString ().
	* Use ContentDescriptionObject.Copyright in Asf.Tag.
	* Switch order of play_duration and send_duration in Asf.HeaderObject.
	  This is backwards from the specification but conforms to actual files.
	* Don't count preroll in ASF durations.
	* Don't double-count position when counting frames.
	* Ensure Id3v2.FrameHeader is converting headers from versions 2 and 3.
	* Always set the encoding to default in Id3v2.Tag when writing a frame
	  to prevent misencoding.
	* Stopped ArgumentOutOfRangeExceptions from occuring when corrupt
	  RelativeVolumeframe is encountered.
	* Fixed rendering of Ape.Item on non-latin characters.
	* Added new constructors to Picture to obsolete CreateFromFile,
	  CreateFromPath.
	* Changed Asf.Tag to write large pictures to the ASF Metadata Library
	  Object rather than ignoring them.
	* Changed the way Mpeg.AudioHeader checked for Xing identifier to
	  prevent first change exception if none was found.
	* Use StringBuilder instead of string addition.
	* Don't crash if Mpeg4.IsoHandlerBox does not contain a nil delimiter.
	* Limit scanning in Mpeg.AudioFile to 4096 bytes of audio stream to
	  prevent reading whole file if corrupt.
	* Replace protected CombinedTag constructor with public one to allow
	  compiling in Orcas.
	* Include MonoDevelop files in distributed package.
	* Correctly parse beats per minute when they contain floating point
	  numbers.

Added features:
	* Added support for Fraunhofer VBRI header. (Authored by hwahrmann.)
	* Obsoleted Tag.Duplicate in favor of Tag.CopyTo which can be extended
	  to provide better support for copying between matching tag types.
	* Added ByteVector.UseBrokenLatin1Behavior that when true reads tags
	  from the system encoding instead of Latin1.
	* Added support for reading APE files. (Authored by hwahrmann.)
	* Added generic Id3v2.GetFrames() to reduce casting.
	* Added support for one of each type of cover image in Ape.Tag
	* Added recognition of BMP and GIF images in Picture.
	* Added Id3v2.PopularimeterFrame capable of handling ratings from
	  Windows Media Player.
	* Added Id3v2.Tag.UseNumericGenres which can be disabled to prevent
	  genres from being written as indices.
	* Added File.InvariantStartPosition and File.InvariantEndPosition to
	  mark the edges of the media portion of the file.

Special thanks to those who contributed since the last release:
	AgentS, codi, craig, Dakuja, DavidT@Imerge, evgeni, hwahrmann, jms,
	jmurphy, jocker, jonx, jposen, kajic, kurros, nokturnal, oliphant,
	renzska, sambeckett, sukhjinder, and anyone else who I may have
	forgotten.

Thanks,
Brian

TagLib# 2.0.2.0 is out. This release features fixes to bugs in tag reading, and a problem where TagLib.Tag.Artists (added in 2.0.1) did not work.

Important to note is that the Windows package (taglib-sharp-2.0.2.0-windows.zip) was compiled on Linux. There should be no issues, but if any do appear, don’t hesitate to submit a bug report and compile the binary yourself.

The Windows library is now signed with the public key, db62eba44689b5b0, and includes a policy which can be installed into the GAC.

gacutil /i taglib-sharp.dll /package taglib-sharp
gacutil /i policy.2.0.taglib-sharp.dll

NEWS Entry

Version 2.0.2.0
July 3, 2007

This is the second bug fix release for TagLib#. Fixes include:
	* Read AttachedPictureFrame correctly when UTF-16 encoded.
	* Stop infinite recursion with rare Xing header.
	* Add "VBR" to the MPEG Audio description if a Xing header is present.
	* Update unit tests for changes in 2.0.1.
	* Fix Artists (added in 2.0.1) to point to Performers. Was pointing
	nowhere.
	* Make ByteVector.Find return correctly if (data.Count == pattern.Count
	+ offset).
	* Set to this.data instead of data in PrivateFrame constructor.

Outstanding bugs:
	* MPEG-4 tags do not show up in Nokia N95 Phone.
	* Large pictures should be stored in the ASF HeaderExtensionObject.

Outstanding feature requests:
	* Add slow read support to get correct information from VBR MP3's
	lacking Xing headers.
	* Add TagLib.Tag.Key
	* Add TagLib.Id3v2.PopularimeterFrame
	* Support ID3v2 chapters.
	* Return invariant data sections for a file.

Special thanks to those who contributed in some way to the project over the past
year:
	Aaron Bockover, Alan, Alexander Hixon, Andrés Gómez Aragoneses,
	Clint Banzhaf, D Bera, David Wu, Da_FileServer, Dennis Cranston,
	Fabrice Deshayes aka Xtream, Gabriel Rosenhouse, gozza11, Gustavo Rubio,
	Herman Mahone, HugoPalma, Ilya Konstantinov, Ion Todirel, jc BAUDHUIN,
	jmurphy, JustinC, lindea, Michael Monreal, maciej, mikec, mtampe,
	Patrick Laplante, pipes, renzska, sambeckett, Sebastian Dröge,
	Timm Preetz, wilson, and anyone else who I may have forgotten.

So, download it here: http://www.taglib-sharp.com/Download/test/taglib-sharp-2.0.2.0-windows.zip, try it with your program, and comment here on whether or not it works.

Thanks,
Brian

I’ve recently started work on reformatting the source to use the Mono Project Coding Guidelines and rewriting the docs from scratch in the source. One goal I have for this transition is to add at least one example per class, and to have the examples in at least C#, VB.NET, Managed C++, and Boo (other languages a bonus). As I only really know C# well, this means I’ll need some help.

So grab your ego and head over to the language forum where the work is waiting on TagLib.Id3v2.PrivateFrame. My best guesses are there but they could stand some review. If all goes well, I’ll be regularly adding examples to be translated.

Thanks!
Brian

TagLib# 2.0.1 is out, in all its glory. This release features many bug fixes, most importantly the resolution to the problem of album artists and performers being flip-flopped in a lot of players. It is highly recommended that you upgrade from the previous release.

From the NEWS file:

Version 2.0.1
June 24, 2007

This is the first bug fix release for TagLib#. Fixes include:
	* Use Picard Tag mapping for all tags to improve constistency.
	* Add JoinedAlbumArtists and FirstAlbumArtist for clarity.
	* Add Artist pointing to Performers with an ObsoleteAttribute.
	* Handle ID3v2 comments ending with text delimiters better.
	* Clear ID3v2 pictures when Pictures is set to null.
	* Don't try storing pictures larger than 64K in ASF files.
	* Don't throw an exception when saving MPEG-4 files without UTDA boxes.
	* Fix the clearing of MPEG-4 boxes.
	* Use Box.DataSize instead of Header.DataSize when calculating the
	MPEG-4 padding.
	* Recognize WMA Lossless in the codec description.

Outstanding bugs:
	* MPEG-4 tags do not show up in Nokia N95 Phone.

Special thanks to those who contributed in some way to the project over the past
year:
	Aaron Bockover, Alan, Alexander Hixon, Andrés Gómez Aragoneses,
	Clint Banzhaf, D Bera, David Wu, Da_FileServer, Dennis Cranston,
	Fabrice Deshayes aka Xtream, Gabriel Rosenhouse, gozza11, Gustavo Rubio,
	Herman Mahone, HugoPalma, Ilya Konstantinov, Ion Todirel, jc BAUDHUIN,
	jmurphy, JustinC, lindea, Michael Monreal, maciej, mikec, mtampe,
	Patrick Laplante, renzska, Sebastian Dröge, Timm Preetz, wilson, and
	anyone else who I may have forgotten.

On another note, TagLib# 0.0.0 was released on June 23, 2006, making it one year old as of yesterday. (I didn’t have a chance to get online yesterday.) From the TagLib# mailing list:

Date: Fri, 23 Jun 2006 04:57:35 -0700
From: "Brian Kerrick Nickel" <*********>
To: *********
Subject: Announcing taglib-sharp-0.0.0 - TESTERS NEEDED

Greetings and salutations,

With hopes of solving the tagging deficiencies in C#, I've started a port of
TagLib to the .NET framework. This will allow easier and more complete
adoption by programs like Cowbell and Muine, and hopefully replace
entagged-sharp in Banshee (It doesn't play nice with multi-field text and is
not very expendable). It'll also be a very smooth port to Windows.

This first release (0.0.0) contains a complete but very untested port of
TagLib 1.4.1 to C# with some minor bug fixes (I'll report them) and some API
additions. This release doesn't install, but provides a test program
"read-files" to read the tags from files. I've tested reading with many
ogg-vorbis and mp3's and a single FLAC. (I'll check out writing tomorrow.)

What I would ask (for those of you who use mono) is for you to test the
reader with files you have and report any errors to me. Usage is as follows:

   1. Download
   http://www.public.asu.edu/~bnickel/TagLibSharp/taglib-sharp-0.0.0.tar.gz
   2. Untar the file.
   3. Enter the directory in a shell.
   4. ./compile.sh
   5. cd tests/
   6. ./read-files /path/to/files/*

The port was not that smooth with lots of typecasting and a few mistakes I
was able to find, so hopefully with some testing it should be good to go.

Thanks in advance for your testing.
  --
Brian Kerrick Nickel <brian.nickel@gmail.com>

From the same list it looks like I started all the hard work sometime after May 26:

Date: Fri, 26 May 2006 02:50:28 -0700
From: "Brian Kerrick Nickel" <*********>
To: "Antti Sykäri" <*********>
Subject: Re: C# bindings for TagLib 1.4. Tested on Windows/MSVC2005
Cc: *********

Antti,

A while ago, I made an extensive binding of specific features for the Muine
music player here: http://www.public.asu.edu/~bnickel/SharpTagger/

This library is a little more robust than the C bindings allow for,
providing things like "string [] Artists" rather than "string Artist". It
also provides other items like total tracks, disk# in set, disk title, album
cover, etc. Unfortunately, it also leaks quite a bit of memory but if you
can work around its shortcomings, it has write support and provides examples
of how to extend certain features.

I think the best idea overall would be a full port of TagLib to C#, as it
could take advantage of .NET's built in libraries for data structures and
unicode. I have some prior work on this I could share, but I'm an
organizational disaster and never really devised a systematic way of working
on it. (A goal of mine for this summer.)

Best of luck,
Brian Nickel

On 5/25/06, Antti Syk=E4ri  wrote:
>
> Hi,
>
> I’m writing a music player in C# but couldn’t find a good C# library
> for reading id3v2 tags, so I wrote an initial version of C# bindings
> for TagLib. It uses the C interface and writing tags is not yet
> supported.  It should be straightforward to add but I decided to get
> some sleep instead. Also Unicode doesn’t quite work yet - I assume that
> my wrapper thinks it’s getting ISO-8859-1/ASCII from the file when it
> actually gets UTF8 encoded data. But otherwise it seems to work 
>
> I used Visual Studio 2005 on Windows XP (Express should work as well)
> and Stefan Gehn’s MSVC port of TagLib
> (http://metz.gehn.net/files/taglib-snapshot-win32.zip), which I
> augmented with a slightly modified tag_c.cpp. It is available at:
>
> http://jsykari.lucid.fi/soft/TagLib/taglib-1.4.0-win32-with-c-bindings.zip
>
> The C# bindings are at:
>
> http://jsykari.lucid.fi/soft/TagLib/TagLib.cs
>
> Perhaps someone finds it useful.
>
> -Antti
>
> –
> - I still say that private enterprise is acceptable at a village level,
> providing it is strictly controlled by the party.
> - We must not let petty bourgeois aspirations taint socialist pedagogy.
> Reform is the enemy of revolution.

It’s been a really great year with a lot of interesting changes, obstacles, head aches, contributions, and successes. I hope the next year is easier.

Sincerely,
Brian

After over 10 months of development, TagLib# 2.0 is officially out. This release is API and ABI stable and ready for use in production systems and inclusion in Linux distributions.

PS. I’ve included /doc output in the .NET 2.0 package. Is there a better way to package things for Windows?

- Brian

Namespaces:            14
Visible Types:         152
   Classes:            89
   Abstract Classes:   9
   Static Classes:     7
   Structures:         18
   Interfaces:         5
   Enumerations:       20
   Delegates:          3
Visible Members:       1264
   Constructors:       260
   Methods:            393
   Properties:         469
   Fields:             142
 
Lines of Code:         21198
Missing Documentation: 849