SoundFingerprinting.Emy 17.4.0

Prefix Reserved
dotnet add package SoundFingerprinting.Emy --version 17.4.0
                    
NuGet\Install-Package SoundFingerprinting.Emy -Version 17.4.0
                    
This command is intended to be used within the Package Manager Console in Visual Studio, as it uses the NuGet module's version of Install-Package.
<PackageReference Include="SoundFingerprinting.Emy" Version="17.4.0" />
                    
For projects that support PackageReference, copy this XML node into the project file to reference the package.
<PackageVersion Include="SoundFingerprinting.Emy" Version="17.4.0" />
                    
Directory.Packages.props
<PackageReference Include="SoundFingerprinting.Emy" />
                    
Project file
For projects that support Central Package Management (CPM), copy this XML node into the solution Directory.Packages.props file to version the package.
paket add SoundFingerprinting.Emy --version 17.4.0
                    
#r "nuget: SoundFingerprinting.Emy, 17.4.0"
                    
#r directive can be used in F# Interactive and Polyglot Notebooks. Copy this into the interactive tool or source code of the script to reference the package.
#:package SoundFingerprinting.Emy@17.4.0
                    
#:package directive can be used in C# file-based apps starting in .NET 10 preview 4. Copy this into a .cs file before any lines of code to reference the package.
#addin nuget:?package=SoundFingerprinting.Emy&version=17.4.0
                    
Install as a Cake Addin
#tool nuget:?package=SoundFingerprinting.Emy&version=17.4.0
                    
Install as a Cake Tool

Emy

Emy provides an efficient database for audio/video fingerprints. Enables storing tens of thousands of audio/video tracks, which can be searched later.

Use cases:

  • audio fingerprinting API
  • broadcast content monitoring
  • content deduplication
  • second screen synchronization
  • repeating content detection
  • shazam style apps

Community Edition is free for non-commercial use. To run the server:

docker run -d -v /persistent-dir:/app/data -p 3399:3399 -p 3340:3340 addictedcs/soundfingerprinting.emy:latest

Emy provides a backoffice interface which you can access on port :3340. In order to insert and query Emy server please install SoundFingerprinting.Emy NuGet package.

Anonymous usage telemetry

Community Edition sends an anonymous pulse every 30 minutes: the Emy version, the OS, the CPU and memory size, and the audio and video track counts. The server derives the country and the network operator from the request and does not store the IP address. The pulse carries no host name, no track titles, and no client data.

To disable it, set EMY_TELEMETRY_DISABLED=true (or DO_NOT_TRACK=1):

docker run -d -e EMY_TELEMETRY_DISABLED=true -v /persistent-dir:/app/data -p 3399:3399 -p 3340:3340 addictedcs/soundfingerprinting.emy:latest

More details on how audio fingerprinting works and how to use Emy can be found at https://emysound.com.

Blog: https://emysound.com/blog.

Product Compatible and additional computed target framework versions.
.NET net5.0 was computed.  net5.0-windows was computed.  net6.0 was computed.  net6.0-android was computed.  net6.0-ios was computed.  net6.0-maccatalyst was computed.  net6.0-macos was computed.  net6.0-tvos was computed.  net6.0-windows was computed.  net7.0 was computed.  net7.0-android was computed.  net7.0-ios was computed.  net7.0-maccatalyst was computed.  net7.0-macos was computed.  net7.0-tvos was computed.  net7.0-windows was computed.  net8.0 was computed.  net8.0-android was computed.  net8.0-browser was computed.  net8.0-ios was computed.  net8.0-maccatalyst was computed.  net8.0-macos was computed.  net8.0-tvos was computed.  net8.0-windows was computed.  net9.0 was computed.  net9.0-android was computed.  net9.0-browser was computed.  net9.0-ios was computed.  net9.0-maccatalyst was computed.  net9.0-macos was computed.  net9.0-tvos was computed.  net9.0-windows was computed.  net10.0 was computed.  net10.0-android was computed.  net10.0-browser was computed.  net10.0-ios was computed.  net10.0-maccatalyst was computed.  net10.0-macos was computed.  net10.0-tvos was computed.  net10.0-windows was computed. 
.NET Core netcoreapp2.0 was computed.  netcoreapp2.1 was computed.  netcoreapp2.2 was computed.  netcoreapp3.0 was computed.  netcoreapp3.1 was computed. 
.NET Standard netstandard2.0 is compatible.  netstandard2.1 was computed. 
.NET Framework net461 was computed.  net462 was computed.  net463 was computed.  net47 was computed.  net471 was computed.  net472 was computed.  net48 was computed.  net481 was computed. 
MonoAndroid monoandroid was computed. 
MonoMac monomac was computed. 
MonoTouch monotouch was computed. 
Tizen tizen40 was computed.  tizen60 was computed. 
Xamarin.iOS xamarinios was computed. 
Xamarin.Mac xamarinmac was computed. 
Xamarin.TVOS xamarintvos was computed. 
Xamarin.WatchOS xamarinwatchos was computed. 
Compatible target framework(s)
Included target framework(s) (in package)
Learn more about Target Frameworks and .NET Standard.

NuGet packages (1)

Showing the top 1 NuGet packages that depend on SoundFingerprinting.Emy:

Package Downloads
SaberSongPatcher

Add and distribute custom songs for Beat Saber without including any copyrighted content! Assists in (1) distributing custom maps without copyrighted data and (2) quickly and reliably using these maps by providing your own legally purchases/ripped copy of the song. https://medium.com/@idolize/beat-saber-the-future-of-custom-songs-d64756818be7

GitHub repositories (1)

Showing the top 1 popular GitHub repositories that depend on SoundFingerprinting.Emy:

Repository Stars
cjmanca/plex-credits-detect
Augments plex's built in intro detection, additionally detecting credits.
Version Downloads Last Updated
17.4.0 110 11/11/2026
17.2.0 150 11/4/2026
17.1.0 121 11/2/2026
17.0.0 131 10/31/2026
16.2.0 112 10/30/2026
16.1.0 109 10/29/2026
16.0.7 201 10/21/2026
16.0.0 163 10/18/2026
15.17.0 119 10/15/2026
15.16.4 110 10/13/2026
15.16.0 126 10/12/2026
15.16.0-ffmpeg4 104 10/12/2026
15.15.1-ffmpeg4 104 10/10/2026
15.15.0 132 10/9/2026
15.14.1 201 9/25/2026
15.13.0 698 9/3/2026
15.12.1 138 8/27/2026
15.12.0 118 8/27/2026
15.11.1 130 8/25/2026
15.11.0 134 8/24/2026
Loading failed

Version 17.4.0
       - Breaking: the realtime query service and the match selection types are removed from the package; a recorder publishes hashes with AVStreamingPublishService
       - Upgrade to SoundFingerprinting 17.4.0
       Version 17.3.4
       - AVStreamingQueryService.Query never throws: after StopService or DisposeAsync, or when a station does not start or rejects the file, it logs and reports the file through the file callback with no fingerprints
       - AVStreamingQueryService.StopService reads every queued file and then disposes IResultEntryCallbacks.Disposable; with DefaultResultEntryCallbacksFactory this registers the held spot groups (before, only DisposeAsync did)
       - AVStreamingQueryService.DisposeAsync reads the queued files before the flush, waits at most 30 seconds for all stations together, and never throws; after the wait the query loops still call the callbacks and the registry, so await StopService first for a graceful stop
       - IResultEntryCallbacks.Disposable is disposed by the station when its query loop ends, after the last callback: during StopService or DisposeAsync, after a cancel of the service token, or after a loop fault
       - IResultEntryCallbacksFactory.Create runs under the service lock and must not call the service
       - AvQueryResultsSelectionStrategy.DisposeAsync leaves GroupCount at 0; a second call registers nothing
       Version 17.2.0
       - Advertisement.Transcript: the speech transcript of the advertisement, when known
       - Breaking: the Transcript class is removed; use Advertisement.Transcript
       Version 17.0.0
       - Upgrade to FFmpeg 9.x (FFmpeg.AutoGen 9.0.1.1); the loaded FFmpeg build must include libsoxr
       - Upgrade to SoundFingerprinting 17.x
       Version 16.1.0
       - Breaking: IEmyModelService, IModelServiceFactory and ModelServiceFactory are removed; EmyModelService implements only IModelService, IDisposable and IAsyncDisposable
       - Streams, matches, duplicates, ads and original points are reached through IEmyClient (EmyClient.NewInstance) and its Streams, Matches, Duplicates, Ads and Models facets; IEmyClientFactory replaces IModelServiceFactory
       - Wire protocol unchanged: 16.0.x servers and 16.1.0 clients interoperate in both directions
       - EmyClient.NewInstance (single server) reports the correct message when the receive/send timeout exceeds the idle timeout or the idle timeout exceeds the lifetime

       Version 16.0.14
       - ICrossValidationMatchRegistry gains ClaimDuplicateMatchGroupAsync and ReleaseDuplicateMatchGroupAsync (opcodes 54 and 55, CV leader only); external implementers must add both members
       - DeleteDuplicateMatchGroupAsync deletes only the rows no claim holds and returns the deleted count; a claimed row stays until its release

       Version 16.0.0
       - Requires SoundFingerprinting 16.0.0: IModelService, IQueryService, IQueryCommand, IRealtimeQueryCommand and IAVQueryMatchRegistry are async-only and take a CancellationToken
       - All client facets are async-only (IEmyModels, IOriginalPointsReader, IStreamingContentSearcher, ICrossValidationMatchRegistry, IAdsRegistry, IAVQueryMatchRegistry, IAVRealtimeQueryMatchRegistry); sync members removed
       - Async transport end to end (IEmyClientConnection.RequestReplyAsync); connect, send and receive timeouts enforced in code; cancellation throws OperationCanceledException and is never retried
       - EmyClient.NewInstance: operationTimeoutMs (one deadline for queueing, connect, exchange and retries, TimeoutException) and maxQueuedRequests (ClientOverloadedException)
       - Protocol version 0 removed on both sides; CompressionMethod.None sends framed uncompressed requests
       - Realtime callbacks return Task; AvQueryResultsSelectionStrategy, AVStationQueryService, AVStreamingQueryService, IEmyClient, IEmyModelService and the pooled connection are IAsyncDisposable
       - ITcpClientFactory.GetTcpClientAsync replaces GetTcpClient
       - IBackwardsCompatibleMethods and the ReadAll and BatchedQueryV2 opcodes removed: use GetTrackIdsAsync + ReadTrackByIdAsync and QueryEfficientlyAsync
       - QueryInterfaces.Owner and IStreamsQueryInterfaceResolver.DisposeQueryInterfacesOnStreamEndAsync; IAlgorithmMapper, RepeatingContentStreamsDriverAdapter and BackgroundQueryMatchRegistry are IAsyncDisposable
       - Every await is ConfigureAwait(false), enforced by CA2007: continuations and callbacks never resume on the caller SynchronizationContext
       - Error.SuspendedAccount removed: the server no longer suspends accounts or refuses requests on account status

       Version 15.17.0
       - Updated SoundFingerprinting to 15.17.0: the realtime aggregator continues the tracked occurrence through tracks that repeat their own audio, and RealtimeQueryConfiguration.SeamJumpPolicy decides what a jump of the track position across a query seam means
       - AVStationQueryService sets SeamJumpPolicy.NewOccurrenceAbove(AdLengthStrategy.StandardAdLengthCeiling): a chunk that lands on a copy of the audio further than a whole standard spot away starts a new match instead of extending the current one
       - IAdLengthStrategy.IsStandardAd and IsLongForm: a length inside the tolerance of a standard bin is a standard spot, a length above the ceiling that is not one is long-form
       - LongFormCoverageFloor and LongFormCoverageFloorEntryFilter: a completed match on a long-form track must cover more than a whole standard spot (or 60% of a track just above the ceiling) to pass the wrapped tenant filter
       - PodGapsDetectionStrategy measures the airtime a match occupies on the stream (QueryDiscreteCoverageLength), not the spread of its matched points inside the track
       - Added EmyClient (IEmyClient, IEmyClientFactory, EmyClientFactory): one client owns the connections to an Emy server or a leader/follower pair and exposes focused services: Models (IEmyModels), Streams (IStreamingContentSearcher), Matches (IEmyMatches), Duplicates (ICrossValidationMatchRegistry) and Ads (IAdsRegistry). Services borrow the client's connections; dispose the client, not the services.
       - EmyModelService and IEmyModelService are unchanged: EmyModelService now forwards every call to one owned EmyClient, with the same routing, validation and results.
       - Disposing a client while a connection attempt is in flight now releases the pending socket instead of leaving it open until garbage collection.
       - Breaking change (intentional source and binary compatibility break): removed the client-side sharding API in the SoundFingerprinting.Emy.Sharding namespace: ShardingModelService, IShardInsertStrategy, LoadShardInsertStrategy and RoundRobinStrategy. There is no replacement.
       Version 15.16.0
       - Updated SoundFingerprinting to 15.16.0: FFmpegAudioService crops a frame region out of the decoded frames of every file when the video fingerprint configuration carries an IFrameCropSink (VideoFingerprintConfiguration.FrameCropSink, AVFingerprintConfiguration.WithFrameCropSink).
       - FFmpegAudioService has one public constructor, FFmpegAudioService(ILoggerFactory?); SupportedFormats now lists the demuxer names of the loaded FFmpeg build (read once, lazily) instead of a static list.
       - AVStreamingPublishOptions.MediaServiceFactory is Func<string, IMediaService>; the publish worker hands its frame crop sink to the media service through the fingerprint configuration.
       Version 15.14.1
       - Updated SoundFingerprinting to 15.14.1 to recover retrospective cut-off occurrences, retain fixed-axis matching, and remove timestamp-origin-dependent match selection.
       Version 15.3.0
       - Updated SoundFingerprinting dependency to 15.3.0 (ComputeSpectralProfile now defaults to true, so fingerprinted tracks carry the per-second spectral profile out of the box).
       Version 15.2.0
       - Updated SoundFingerprinting dependency to 15.2.0 (MatchedWithType provenance on matches, TruePositivesFilter.ignoreBridgedCoverage, SilenceBridgingStrategy rename).
       - SimilarTracksQuery's true-positives filter now ignores bridged coverage by default — only real fingerprint anchors count toward the coverage bar — so spectral bridging can no longer inflate a coincidental cross-advertiser match over the threshold.
       Version 15.1.0
       - Updated SoundFingerprinting dependency to 15.1.0 (windowed spectral-profile bridging, order-independent CompositeBridgingStrategy, per-strategy bridge caps).
       - SimilarTracksQuery now bridges noisy/quiet gaps with the windowed broadband + silent composite, fully recovering cross-station ad matches that previously matched only partially.
       Version 15.0.9
       - Updated SoundFingerprinting dependency to 15.0.9 (fixed Hashes.GetRange for spectral profiles)
       Version 15.0.4
       - Fixed FFmpegTranscoder JIFF marker update
       Version 15.0.0
       - Upgraded SoundFingerprinting dependency to 15.0.0
       Version 14.0.0
       - Upgraded SoundFingerprinting dependency to 14.0.0
       - Updated FFmpeg.AutoGen to v8.0.0
       Version 12.7.0
       - Updated SoundFingerprinting dependency to 12.7.0