Spek.NET.WinUI
0.3.0-preview.1
dotnet add package Spek.NET.WinUI --version 0.3.0-preview.1
NuGet\Install-Package Spek.NET.WinUI -Version 0.3.0-preview.1
<PackageReference Include="Spek.NET.WinUI" Version="0.3.0-preview.1" />
<PackageVersion Include="Spek.NET.WinUI" Version="0.3.0-preview.1" />
<PackageReference Include="Spek.NET.WinUI" />
paket add Spek.NET.WinUI --version 0.3.0-preview.1
#r "nuget: Spek.NET.WinUI, 0.3.0-preview.1"
#:package Spek.NET.WinUI@0.3.0-preview.1
#addin nuget:?package=Spek.NET.WinUI&version=0.3.0-preview.1&prerelease
#tool nuget:?package=Spek.NET.WinUI&version=0.3.0-preview.1&prerelease
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,FftBitsorWindowFunction, or the control's width, analyses again. ChangingPalette,LowerDborUpperDbrecolours what's there. StreamCount,ChannelCount,DescriptionandIsAnalyzingreport the current file, andAnalysisCompletedfires when a file is done.ShowFullPath,ShowDetailedDescription,BrandName,BrandVersionandInterpolationchange how it looks.- With focus, the control takes Spek's keys:
c,f,l,p,s,uandw, with Shift to step back. SpekExporter.ExportAsyncrenders a file to a PNG without a window.
Inspection
- Hover or use arrow keys for the time, frequency and level readout in
ReadoutText. ReadoutTimeText,ReadoutFrequencyTextandReadoutLevelTextexpose the same values separately. Hosts can bind them to fixed-width fields so changing digits do not move neighboring controls. All four readout properties clear when the inspection cursor leaves the plot.TimeZoomFactorandFrequencyZoomFactorreport each axis's magnification relative to the full file.DurationSecondsandNyquistFrequencyreport the full time and frequency extents. Read these properties whenInspectionChangedfires.PanTo(timeSeconds, frequencyHz)recenters both axes in one update, clamps at file boundaries and preserves their spans and the profile selection.- Add a
SpectrogramOverviewwith itsSourceset to theSpekViewto provide a two-axis minimap. Its default size is 200 × 100 device-independent pixels. It appears whenever either zoom factor, converted to a percentage and rounded to two decimal places, exceeds 100%. It hides at the whole-file view. It reuses the cached whole-file bitmap without another decode. Its rectangle has the actual proportions of the visible time and frequency ranges, with a larger invisible hit target for very small rectangles. Click to recenter or drag to pan both axes. Left/right pan time; up/down pan frequency. Page Up, Page Down, Home and End navigate time. Panning preserves zoom and the profile selection. UI Automation clients can pan both axes through the Scroll pattern, or set the visible start time in seconds through RangeValue. The minimap is not included in PNG exports. - The minimap overlays a progress ring while its source is refining the visible time interval. It hides the ring on completion, reset, source changes and unload. Hosts can keep
RefinementStatusfor errors without displaying progress or completion text. The host must merge the standardXamlControlsResourcesdictionary inApp.xamlfor the progress ring, as with other WinUI controls. - Ctrl+wheel zooms both time and frequency around the pointer.
+and-zoom around the center of the view, andRresets both axes.MinimumFrequencyandMaximumFrequencyexpose the frequency interval; a maximum of 0 selects Nyquist.MinimumTimeandMaximumTimeexpose the time interval in seconds; a maximum of 0 selects the end of the file.VisibleTimeRangereports the effective interval.ZoomToTimeRangeandZoomToFrequencyRangeset each interval independently.ResetZoomresets both axes, whileResetFrequencyZoomresets only frequency for existing hosts. - Whole-file analysis and light time zoom keep the original fast path. At 4x time zoom or deeper, refinement switches to dense, file-anchored FFTs with context on both sides and linear-power pixel averages. Detailed views share a measurement grid; the fast overview deliberately does not. Crossing that threshold can change brightness and event placement slightly. A cached fast result cannot suppress a required detailed analysis.
- Zooming first scales the current image. Refinement waits 350 ms, then runs in the background while the old image stays visible. 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.
IsRefiningincludes the debounce wait, andRefinementStatusreports progress, completion or failure without changingIsAnalyzing. - 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.
SaveAsyncexports 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.
SelectTimeRangetakes start and end seconds, andClearSelectionor Escape selects the whole file. - Set
ShowSpectrumto getSpectrumProfileafter analysis.SpectrumProfileViewdraws that profile. Set itsProfileandFrequencyRangewhenSpekView.InspectionChangedfires. - Set
SpectrumProfileView.Captionto include the selected passage's times without a separate status row. The default is "Average spectral level of the whole track". The control uses the caption as its accessible name too. - Set
ShowCutoffMarkerto draw the optionalMeasuredDrop. This measures a sustained spectral edge, not the original bitrate, codec or lossless authenticity. - Set
ReferenceLinestoReferenceLines.Mp3Lamefor approximate LAME stereo CBR low-pass references. The default isNone.
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/spek-z
| Product | Versions Compatible and additional computed target framework versions. |
|---|---|
| .NET | net10.0-windows10.0.22621 is compatible. |
-
net10.0-windows10.0.22621
- Microsoft.Graphics.Win2D (>= 1.4.0)
- Microsoft.WindowsAppSDK (>= 2.5.1)
- Spek.NET (>= 0.3.0-preview.1)
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 |