Spek.NET.WinUI 0.2.0

There is a newer prerelease version of this package available.
See the version list below for details.
dotnet add package Spek.NET.WinUI --version 0.2.0
                    
NuGet\Install-Package Spek.NET.WinUI -Version 0.2.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="Spek.NET.WinUI" Version="0.2.0" />
                    
For projects that support PackageReference, copy this XML node into the project file to reference the package.
<PackageVersion Include="Spek.NET.WinUI" Version="0.2.0" />
                    
Directory.Packages.props
<PackageReference Include="Spek.NET.WinUI" />
                    
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 Spek.NET.WinUI --version 0.2.0
                    
#r "nuget: Spek.NET.WinUI, 0.2.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 Spek.NET.WinUI@0.2.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=Spek.NET.WinUI&version=0.2.0
                    
Install as a Cake Addin
#tool nuget:?package=Spek.NET.WinUI&version=0.2.0
                    
Install as a Cake Tool

Spek.NET.WinUI

SpekView is a WinUI 3 control that shows Spek's spectrogram of an audio file and draws the columns as the file decodes. It's drawn with Win2D and uses Spek.NET for the analysis.

<Page xmlns:spek="using:Spek.Net.WinUI">
    <spek:SpekView x:Name="Spectrogram" FilePath="C:\Music\song.flac" />
</Page>
Spectrogram.FfmpegPath = @"C:\Tools\ffmpeg.exe"; // optional; otherwise ffmpeg is taken from PATH
Spectrogram.Palette = Palette.Sox;
await Spectrogram.SaveAsync(@"C:\Temp\song.png");
  • Changing FilePath, Stream, Channel, FftBits or WindowFunction, or the control's width, analyses again. Changing Palette, LowerDb or UpperDb recolours what's there.
  • StreamCount, ChannelCount, Description and IsAnalyzing report the current file, and AnalysisCompleted fires when a file is done.
  • ShowFullPath, ShowDetailedDescription, BrandName, BrandVersion and Interpolation change how it looks.
  • With focus, the control takes Spek's keys: c, f, l, p, s, u and w, with Shift to step back.
  • SpekExporter.ExportAsync renders a file to a PNG without a window.

Inspection

  • Hover or use arrow keys for the time, frequency and level readout in ReadoutText.
  • Ctrl+wheel zooms both time and frequency around the pointer. + and - zoom around the center of the view, and R resets both axes. MinimumFrequency and MaximumFrequency expose the frequency interval; a maximum of 0 selects Nyquist. MinimumTime and MaximumTime expose the time interval in seconds; a maximum of 0 selects the end of the file. VisibleTimeRange reports the effective interval. ZoomToTimeRange and ZoomToFrequencyRange set each interval independently. ResetZoom resets both axes, while ResetFrequencyZoom resets only frequency for existing hosts.
  • Zooming first crops and enlarges the existing image. After a 350 ms pause, a background decode analyses only the visible time interval with preceding FFT context. The old image stays visible until the replacement is ready. A new zoom cancels obsolete work; reset uses the cached overview without another decode. One completed detail interval is cached, with value/pixel buffers capped at 32 MiB. IsRefining includes the debounce wait, and RefinementStatus reports progress, completion or failure without changing IsAnalyzing.
  • The FFT size does not change. Interactive time zoom stops at one FFT window or 0.01 seconds, whichever is longer. Hover and keyboard readout use refined data where available, and selection uses absolute file times. The profile and cutoff still use the overview's selected passage, or the whole file if no passage is selected; zoom refinement does not change those measurements.
  • SaveAsync exports the current view, including completed detail. It does not wait for pending refinement or start another decode. Failures preserve the existing image, and unloading cancels work and clears the detail cache.
  • Drag across the plot or use Shift+left/right to select a passage. SelectTimeRange takes start and end seconds, and ClearSelection or Escape selects the whole file.
  • Set ShowSpectrum to get SpectrumProfile after analysis. SpectrumProfileView draws that profile. Set its Profile and FrequencyRange when SpekView.InspectionChanged fires.
  • Set ShowCutoffMarker to draw the optional MeasuredDrop. This measures a sustained spectral edge, not the original bitrate, codec or lossless authenticity.
  • Set ReferenceLines to ReferenceLines.Mp3Lame for approximate LAME stereo CBR low-pass references. The default is None.

SaveAsync exports the current zoom, reference lines and optional cutoff marker. ExportOptions provides the same reference and frequency options for a windowless export.

The control is written in C# with no XAML file, so there's no compiled XAML to merge into your app. It needs Windows App SDK 2.5.1 or later, Win2D 1.4.0, and an app built for x64 or ARM64.

Licensed under GPL-3.0, like Spek. Source: https://github.com/DerekYang2/FluentSpek

Product Compatible and additional computed target framework versions.
.NET net10.0-windows10.0.22621 is compatible. 
Compatible target framework(s)
Included target framework(s) (in package)
Learn more about Target Frameworks and .NET Standard.

NuGet packages

This package is not used by any NuGet packages.

GitHub repositories

This package is not used by any popular GitHub repositories.

Version Downloads Last Updated
0.3.0-preview.1 203 10/17/2026
0.2.0 130 10/17/2026
0.1.0 106 10/15/2026