Luminescence.Audio

Luminescence.Audio is a C++/CLI library for tagging (with TagLib) and fingerprinting (with FFmpeg and Acoustid Chromaprint) audio files, in managed code. To play media files with FFmpeg in managed code, it is recommended to use the ffmediaelement control.

Do not forget to install all required runtimes.

This library has been designed to be used with my tags editor, Metatogger.

Here is a screenshot of that software:

Feel free to fork the code and contribute to Luminescence.Audio.

How to use the tagging API in C♯

using Luminescence.Audio;

// supports the following audio formats: MP3 (*.mp3), FLAC (*.flac), Ogg Vorbis (*.ogg), WMA (*.wma) and AAC/ALAC (*.m4a)
var tagger = new TaglibTagger(@"C:\MyFolder\MyAudioFile.flac");

// getting technical informations

string codecName = tagger.Codec; // "FLAC"
string codecVersion = tagger.CodecVersion; // "1.2.1"
byte channelsCount = tagger.Channels; // 2
TimeSpan duration = tagger.Duration;
int sampleRateInHertz = tagger.SampleRate; // 44100
int bitsPerSample = tagger.BitsPerSample; // 16

// getting or setting textual tags

// textual tags is stored in a dictionary where the key is the tag name in uppercase
Dictionary<string, List<string>> tagsRepository = tagger.Tags;
string artist = tagger.GetTagValues(TagNameKey.Artist).FirstOrDefault();
tagger.AddTag(TagNameKey.Artist, "Artist 2", "Artist 3");
tagger.ReplaceTag(TagNameKey.Title, "All You Need Is Love");
tagger.RemoveTag(TagNameKey.Comment);
tagger.AddTag("MY_KEY_NAME", "Custom Tag Value");

// getting or setting embedded covers

List<Picture> pictures = tagger.Pictures;
if (pictures != null && pictures.Count != 0)
{
   Picture mainPicture = pictures.FirstOrDefault(p => p.Type == PictureType.FrontCover);
   if (mainPicture == null) mainPicture = pictures[0];

   byte[] data = mainPicture.Data;
   Format pictureFormat = mainPicture.PictureFormat; // Format.JPEG
}

pictures.Clear();

tagger.Save(); // saving changes

How to use the fingerprinting API in C♯

using Luminescence.Audio;

// all audio formats supported by FFmpeg can be fingerprinted
int lengthToFingerprintInSeconds = 120; // 0 to fingerprint all the file
int[] fingerprint1 = ChromaprintFingerprinter.GetRawFingerprint(@"C:\MyFolder\MyAudioFile1.flac", lengthToFingerprintInSeconds);
int[] fingerprint2 = ChromaprintFingerprinter.GetRawFingerprint(@"C:\MyFolder\MyAudioFile2.flac", lengthToFingerprintInSeconds);

float comparison = ChromaprintFingerprinter.MatchFingerprints(fingerprint1, fingerprint2);
float concordanceLevel = 0.9; // the file should be the same if the concordance level is > 0.9
bool sameFile = comparison > concordanceLevel;

string readableFingerprint = ChromaprintFingerprinter.EncodeFingerprintBase64(fingerprint1);

bool sameFile2 = ChromaprintFingerprinter.CompareFile(@"C:\MyFolder\MyAudioFile3.flac", @"C:\MyFolder\MyAudioFile4.flac") > concordanceLevel;

Native dependencies required

The Luminescence.Audio library requires the Visual C++ 2017 x86 runtime that you can download here (14 MB).

Licence

Luminescence.Audio is released under the Mozilla Public License Version 2.0

Sylvain Rougeaux (Cyber Sinh)