Handling metadata in WAV files

View as MarkdownMarkdown

Set up your AI agent

Give your coding agent live access to the GroupDocs documentation and API reference through the GroupDocs Docs MCP server — no install, no API key. Learn more

claude mcp add --transport http groupdocs-docs https://docs.groupdocs.com/mcp

Also process documents locally

The GroupDocs.Metadata MCP server lets your agent work with files on your machine; they are never uploaded. It needs the .NET 10 SDK or Docker.

claude mcp add groupdocs-metadata -- dnx GroupDocs.Metadata.Mcp --yes
Folders, licensing and more →

Reading audio details

The GroupDocs.Metadata API supports extracting technical audio information from WAV files.

The following are the steps to read audio details.

  1. Load a WAV audio
  2. Get the root metadata package
  3. Extract  the native metadata package using the WavRootPackage.WavPackage property
  4. Read the WAV audio properties

AdvancedUsage.ManagingMetadataForSpecificFormats.Audio.Wav.WavReadNativeMetadataProperties

using (Metadata metadata = new Metadata(Constants.InputWav))
{
	var root = metadata.GetRootPackage<WavRootPackage>();
	if (root.WavPackage != null)
	{
		Console.WriteLine(root.WavPackage.AudioFormat);
		Console.WriteLine(root.WavPackage.BitsPerSample);
		Console.WriteLine(root.WavPackage.BlockAlign);
		Console.WriteLine(root.WavPackage.ByteRate);
		Console.WriteLine(root.WavPackage.NumberOfChannels);
		Console.WriteLine(root.WavPackage.SampleRate);
	}
}

Extract RIFF INFO chunk metadata

The WAV format is derived from the RIFF container which acts as a wrapper for various audio and video coding formats. As a derivative of RIFF, WAV files can be tagged with metadata in the INFO chunk. The chunk may include information such as the title of the work, the author, the creation date, and copyright information. Here is an example of how the RIFF INFO metadata can be extracted:

AdvancedUsage.ManagingMetadataForSpecificFormats.Audio.Wav.WavReadInfoMetadata

using (Metadata metadata = new Metadata(Constants.InputWav))
{
    var root = metadata.GetRootPackage<WavRootPackage>();
    if (root.RiffInfoPackage != null)
    {
        Console.WriteLine(root.RiffInfoPackage.Artist);
        Console.WriteLine(root.RiffInfoPackage.Comment);
        Console.WriteLine(root.RiffInfoPackage.Copyright);
        Console.WriteLine(root.RiffInfoPackage.CreationDate);
        Console.WriteLine(root.RiffInfoPackage.Software);
        Console.WriteLine(root.RiffInfoPackage.Engineer);
        Console.WriteLine(root.RiffInfoPackage.Genre);
 
        // ...
    }
}

Working with XMP metadata

GroupDocs.Metadata for .NET also allows managing XMP metadata in WAV files. For more details please refer to the following guide: Handling metadata in WAV files

More resources

GitHub examples

You may easily run the code above and see the feature in action in our GitHub examples:

WAV metadata management demo App

The WAV Metadata Editing app is available to view and edit metadata of WAV audio files, including artist, title, genre, copyright, and other RIFF INFO tags.