TagLib#

(aka Taglib-sharp) is a .NET platform-independent library (tested on Windows/Linux) for reading and writing metadata in media files, including video, audio, and photo formats. This is a convenient one-stop-shop to present or tag all your media collection, regardless of which format/container these might use. You can read/write the standard or more common tags/properties of a media, or you can also create and retrieve your own custom tags.

It supports the following formats (by file-extensions):

• Video: mkv, ogv, avi, wmv, asf, mp4 (m4p, m4v), mpeg (mpg, mpe, mpv, mpg, m2v)
• Audio: aa, aax, aac, aiff, ape, dsf, flac, m4a, m4b, m4p, mp3, mpc, mpp, ogg, oga, wav, wma, wv, webm
• Images: bmp, gif, jpeg, pbm, pgm, ppm, pnm, pcx, png, tiff, dng, svg

It is API stable, with only API additions (not changes or removals) occuring in the 2.0 series.

Examples

Read/write metadata from a video

vartfile=TagLib.File.Create(@"C:\My video.avi");stringtitle=tfile.Tag.Title;TimeSpanduration=tfile.Properties.Duration;Console.WriteLine("Title: {0}, duration: {1}",title,duration);// change title in the filetfile.Tag.Title="my new title";tfile.Save();

Read/write metadata from a Audio file

vartfile=TagLib.File.Create(@"C:\My audio.mp3");stringtitle=tfile.Tag.Title;TimeSpanduration=tfile.Properties.Duration;Console.WriteLine("Title: {0}, duration: {1}",title,duration);// change title in the filetfile.Tag.Title="my new title";tfile.Save();

Read/write metadata from an Image

vartfile=TagLib.File.Create(@"C:\My picture.jpg");stringtitle=tfile.Tag.Title;vartag=tfile.TagasTagLib.Image.CombinedImageTag;DateTime?snapshot=tag.DateTime;Console.WriteLine("Title: {0}, snapshot taken on {1}",title,snapshot);// change title in the filetfile.Tag.Title="my new title";tfile.Save();

Read/write custom tags from a specific format

vartfile=TagLib.File.Create(@"C:\My song.flac");varcustom=(TagLib.Ogg.XiphComment)tfile.GetTag(TagLib.TagTypes.Xiph);// Readstring[]myfields=custom.GetField("MY_TAG");Console.WriteLine("First MY_TAG entry: {0}",myfields[0]);// Writecustom.SetField("MY_TAG",newstring[]{"value1","value2"});custom.RemoveField("OTHER_FIELD");rgFile.Save();

Website

TagLib# is available on GitHub: https://github.com/mono/taglib-sharp

• Bugs: Create an issue
• Chat: Join us at Gitter
• Git: Get the source at git://github.com/mono/taglib-sharp.git

Installation From NuGet

TagLib# is available on NuGet: https://www.nuget.org/packages/TagLibSharp

Install from package manager:

PM> Install-Package TagLibSharp -Version 2.3.0

Building and Running

Command Line

To Build From Git:

git clone https://github.com/mono/taglib-sharp.git
cd taglib-sharp
dotnet build

To Test:

dotnet test

Build in IDE (Visual Studio, Visual Studio for Mac, Rider, etc):

You can open it in Visual Studio by using TaglibSharp.sln

Running regression by using Nunit 3 Test Adapter:

1. Ensure NuGet packages have been restored
   1. See: https://docs.microsoft.com/en-us/nuget/consume-packages/package-restore
2. In Visual Studio, go to menu: Tools > Extensions and Updates > Online (In Visual Studio 2019, use Extensions > Manage Extensions)
3. Search: Nunit 3 Test Adapter
4. Download and install it
5. Open from menu: Test > Windows > Test Explorer (In Visual Studio 2019, use Test > Test Explorer)
6. You can run your tests from this panel (not using the "Start" button)
7. You can debug your tests from this panel:
   1. Double click on a test. Set some breakpoints in the test in the editor panel.
   2. right-click on the same test, select "Debug Selected tests".

To test some scenarios and take advantage of the debugger:

1. Make the "debug" project the Startup project (Right-click on the project, select: "Set as StartUp Project")
2. Just modify the "Program.cs"
3. Set some breakpoints and hit the "Start" button

They also use TagLib#

Non exhaustive list of projects that use TagLib#:

• Lidarr
• MediaPortal 2
• F-Spot

And you, what do you use TagLib# for? Reply here

Contributions

TagLib# is free/open source software, released under the LGPL. We welcome contributions! Please try to match our coding style, and include unit tests with any patches. Patches can be submitted by issuing a Pull Request (Git).