Your music. Your curve. Your workspace.
A Windows parametric EQ editor for FiiO and Snowsky devices, and for any Windows output through Equalizer APO.
Download • Changelog • Discord app channel • Report an issue
A friendlier WolfEQ. Settings has been rebuilt around your device: one glance shows your K13 with its real light colours, whether USB and Bluetooth are working, and colour-coded sections for everything else. Small ? tips explain each setting when you hover, so the fine print is gone. Lights got a proper editor, Stream Deck got a step-by-step guide, and four more FiiO devices joined the list.
| New in 0.9.0 | |
|---|---|
| 🎛️ Settings at a glance | A device card with a live drawing of your K13, USB and Bluetooth status chips, and colour-coded sections: Your device, Sound, Lights, Windows output, Shortcuts, Look and About. |
| ❔ Help where you need it | Hover any ? for a short, plain explanation. Preamp, Live sync, band count, volume limit, high gain and more. |
| 🌈 A real lights editor | Preview the top bar and knob, edit Both, Top or Knob, and pick any built-in effect: Solid, Breathing, Rainbow, Rainbow breathing or Follow audio. Two-tone looks set both at once. |
| 📶 Bluetooth in one click | Find my K13 flashes your unit green and saves it when you say yes. No pairing in Windows and no separate save step. |
| ⌨️ Stream Deck made easy | Pick a slot from Stream Deck-style keys, then follow a four-step guide to save the shortcut and add it to a key. |
| 🎧 More FiiO devices | Added the K17, K19, FP3 and Oak Nano. The QX13 and BTR17 are now recognised by their USB IDs. |
| ⚡ Fast on every PC | Device detection, slot switching and readback no longer wait on unrelated USB devices. |
| ✨ Polish everywhere | Matching headers, buttons and spacing across the editor, Library, Settings and dialogs. Clipping warnings sit right next to their Avoid clipping fix. |
![]() |
![]() |
| Settings: your device first, then colour-coded sections | Lights: preview, effects and colours |
![]() |
![]() |
| Stream Deck setup guide | Preset library |
Also in 0.8: Software EQ brings WolfEQ to any Windows output through Equalizer APO (bundled), with bypass from the app or tray, a roomier library with Favorites, and --system-eq-bypass / --preset automation.
| Workspace highlights | |
|---|---|
| 🎚️ Make room for your mix | Drag EQ nodes, edit frequency/gain/Q/filter shape, and resize Band controls live with the divider. |
| 🎶 See what's playing | Colorful spectrum bars behind the curve, with smooth motion and a one-click toggle. |
| 🎨 Make it yours | Light or dark backgrounds, green by default, solid accents, and Aurora, Sunset, Neon, and Ocean palettes. |
| 📚 Find, name, and open | A compact library, naming before saving, Curve/Table online previews, and local names for device slots. |
See light mode
Choose Settings → Look → Background. Background mode is saved, and accent colors adapt for readable contrast.
- Windows x64 installer — normal installation and shortcuts.
- Portable Windows x64 ZIP — extract everything, then run
WolfEQ.exe. - Both include the .NET runtime and the official Equalizer APO 1.4.2 x64 installer for Software EQ. SHA-256 checksums are supplied with the release.
Using a FiiO or Snowsky device? Follow the steps below. Using anything else, such as a laptop jack, another DAC, or Bluetooth headphones? Start with Software EQ.
- Connect your DAC over USB. In Settings → Your device, refresh the USB list, select your device, and choose Save USB device.
- For K13 lights and input switching, choose Find my K13 under Bluetooth. Your K13 flashes green; choose Yes, use it.
- Open Library. Choose a saved preset, or search AutoEQ and OPRA on the Discover online tab and check its Curve or Bands preview.
- Choose Open in editor. Opening a preset closes the library; browsing alone does not replace your edits.
- Shape the curve or expand Band controls. Use Avoid clipping to make room for boosts, then Save to Library to choose a name.
- Select the intended USER slot and write when ready. On supported devices, Live sync sends edits automatically; hover its ? for a short explanation.
The Tools menu groups editing, A/B comparison, device preparation, and sharing. Undo/redo is available in the title bar and with Ctrl+Z / Ctrl+Y. Import and Export at the top of the library cover Equalizer APO / Peace, FiiO XML, WolfEQ JSON, and library backups.
Software EQ applies WolfEQ's EQ to any Windows playback output you choose, using Equalizer APO as the audio engine. The library, AutoEQ and OPRA search, graph, band controls, undo/redo, and presets all work the same as with a DAC. There are no USER slots to write: edits reach your outputs within about a quarter of a second, and the EQ keeps playing after WolfEQ closes.
Setup
- Choose Software EQ from the device menu in the toolbar (or Settings → Your device). WolfEQ remembers this choice.
- If Equalizer APO is not installed, choose Install Equalizer APO. WolfEQ uses the official Equalizer APO 1.4.2 installer it ships with (or downloads and verifies it if missing) and shows progress. Windows asks for administrator permission.
- In Equalizer APO's Device Selector, tick each output you want to EQ (for example Speakers or Headphones) and close it.
- Restart Windows if the installer asks you to.
- Back in WolfEQ, tick the same outputs in the Software EQ output list. Each output shows whether Equalizer APO is active on it. Use Add outputs to reopen the Device Selector later.
Nothing is applied until at least one output is ticked.
Bypass. Turn the EQ off and on from the editor or the tray without losing your curve. Bypass is remembered across restarts. Choosing a FiiO device again turns Software EQ off; Remove from Equalizer APO (or uninstalling WolfEQ) takes WolfEQ's EQ out of Equalizer APO completely.
Coexistence with Peace and hand-written configs. WolfEQ keeps its EQ in its own WolfEQ.txt file and adds one marked block to Equalizer APO's config.txt. The rest of config.txt is left alone, and WolfEQ restores its block if another tool rewrites the file. If Peace is also active, or a ticked output is a FiiO device that may already have EQ on board, WolfEQ shows a double-EQ warning. It does not block you; turn one of them off if the sound is doubled.
Limitations
- Apps that use exclusive mode (WASAPI exclusive) or ASIO bypass Equalizer APO, so they play without Software EQ. There is no workaround.
- Windows feature updates and audio driver updates can remove Equalizer APO from an output. If an output's status changes, use Add outputs, tick it again, and restart if asked.
- Bluetooth headphones appear as two outputs: stereo and hands-free (used during calls). Tick each one you want to EQ.
- Software EQ uses the editor's 10-band limit and applies the same EQ to both channels.
The Spectrum toggle beside EQ Curve shows audio playing through the default Windows multimedia output. It is a visual monitor: it does not process audio or measure the DAC's final analog response. Spectrum height uses its own relative level scale, separate from the EQ gain axis.
- Enabled by default; an explicitly saved off choice is respected.
- Follows output-device changes and fades to silence when playback stops.
- Pauses capture and animation when disabled, hidden, minimized, inactive, or scrolled out of view.
- Separate drawing layers, cached colors, and precomputed FFT data reduce repeated work.
Open Library for your presets on the left and a large preview on the right: the curve or a band table, preamp, filter count, whether the preset fits your device, and where it came from.
- My Library, Favorites, and Discover online tabs. Saved presets can be filtered by category; online results by AutoEQ or OPRA.
- Hover a saved preset to star it, rename it (✎ or F2), or delete it. Double-click opens it in the editor.
- Hover an online result to save it to My Library without opening it.
- Import and Export sit at the top of the library: Equalizer APO / Peace text, FiiO XML, WolfEQ JSON, library backups, and a copyable tuning report.
- Save to Library asks for a name before saving. Online presets are saved locally before opening or writing.
WolfEQ remembers descriptive names locally for each saved USB device and slot. They appear in the USER slot menu, the tray, and the selected-slot subtitle. These labels stay on your PC; they are not names written into device firmware.
Click or right-click the green waveform for the tray panel. Double-click it or choose Open editor to return to the workspace.
- Now playing shows the active slot or preset. In Software EQ mode it has an EQ switch for bypass.
- FiiO mode shows your USER slots as chips, with a check on the active one. Software EQ mode shows up to six quick presets, favorites first.
- Tray options holds Close to tray (on by default) and Minimize to tray (off by default). Both are saved.
- Quit exits the app and checks for unsaved edits.
Tray and automation switches select EQ already stored on the device. Save or discard editor changes before switching; use the editor to write a library preset into a slot.
In Settings → Shortcuts, pick a USER slot from the Stream Deck keys and choose Set up this key. A four-step guide saves a shortcut for that slot and shows where it goes in Stream Deck (System → Open). Repeat for each slot.
Prefer the Windows ScriptDeck plugin? Open Advanced & troubleshooting → Windows ScriptDeck setup:
- Follow the link to Windows ScriptDeck by Start-Automating in the Elgato Marketplace.
- Choose the USER slot to switch to.
- Copy the generated PowerShell script. WolfEQ fills in its executable location and saved USB device path, with argument quoting handled for you.
- Add the plugin's script action to a Stream Deck key and paste the script into On Press. Repeat for other slots.
Re-copy scripts if you move WolfEQ or change its saved connection. For lighting, save the Bluetooth connection and enable Switch lights when I change USER slot under Lights.
Already know the steps? Save shortcut... saves a slot's .lnk straight away; assign it to Stream Deck's System → Open action.
Command-line automation and exit codes
WolfEQ.exe --slot 2
WolfEQ.exe --device "Desk K13" --slot 3
WolfEQ.exe --list-devices
WolfEQ.exe --help
WolfEQ.exe --system-eq-bypass toggle
WolfEQ.exe --preset "My Headphones"
In Software EQ mode, --system-eq-bypass on|off|toggle controls bypass and --preset "<name>" loads a library preset by name and applies it to your chosen outputs. --slot is not available in Software EQ mode and returns a clear "not available in Software EQ mode" result. An unknown preset name returns an error.
--device accepts the saved connection name or exact USB path. It must match the saved connection and never silently reassigns Bluetooth. Existing instances receive requests without taking focus; cold commands run without opening the editor.
Exit codes: 0 success, 1 failure/disconnected, 2 invalid arguments/unsupported slot, 3 busy/unsaved edits, 4 slot switched but lighting failed.
Results are also written to %LOCALAPPDATA%\WolfEQ\automation-result.json. Use PowerShell Start-Process -Wait -PassThru when you need the GUI executable's exit code.
| Device | Status | Notes |
|---|---|---|
| Software EQ | 🆕 Beta | Any Windows playback output through Equalizer APO 1.4.2 (bundled installer). Live edits, bypass, 10-band PEQ, no USER slots. See Software EQ. |
| FiiO K13 R2R | ✅ Working · hardware-tested | Main tested target. USB detection, EQ readback, USER slot switching, PEQ writes, global preamp writes, preset storage, LED cues, USB/COAX input switching. |
| FiiO K17 | ✅ Working · save-only | 31-band PEQ, USER 1-10, 0x21 save command. Matched by product name. |
| FiiO K19 | ✅ Working · save-only | Same 31-band layout as the K17. Matched by product name. |
| FiiO BR15 R2R | ✅ Working · save-only | 10-band layout, USER 1-10. |
| FiiO QX13 | ✅ Working · save-only | 10-band layout, USER 1-10. USB ID 0x0128. |
| FiiO BTR17 | ✅ Working · save-only | 10-band USER 1-10 layout with 0x21 save command. USB ID 0x0088. |
| FiiO BTR13 | ✅ Working · save-only | 10-band layout, USER 1-3. |
| FiiO KA15 | ✅ Working | 10-band PEQ, USER 1-3. |
| FiiO KA17 | ✅ Working | 10-band PEQ, USER 1-3. |
| FiiO JA11 | ✅ Working | 5-band PEQ, core filters. |
| FiiO FP3 | ✅ Working · save-only | 10-band PEQ, one USER slot. Matched by product name. |
| FiiO Oak Nano | ✅ Working · save-only | 8-band PEQ, one USER slot. USB ID 0x4016. |
| Snowsky Melody | ✅ Working | 10-band PEQ and USER 1-3 writes. The device does not answer EQ readback, so Load from slot is unavailable by design. |
| Snowsky Retro Nano | ✅ Working | 10-band PEQ, USER 1-3. |
For full Windows audio format support, set the K13 to UAC2.0 mode. FiiO documents that enabling K13 R2R PEQ limits playback to PCM 192 kHz/24-bit, disables MQA processing, and can briefly reconnect USB when switching between EQ Off and an active EQ mode.
The BR15 R2R, QX13, BTR17, and BTR13 layouts are adapted from the 0BSD-licensed DevicePEQ project and cross-checked against FiiO's published PEQ documentation. See THIRD_PARTY_NOTICES.md. Profiles for the K17, K19, FP3 and Oak Nano, and the QX13 and BTR17 USB IDs, also come from DevicePEQ (0BSD) and fiioctl (MIT) captures. Save-only means WolfEQ writes EQ to a USER slot but keeps live sync and automatic readback off until that model has been checked on real hardware.
The K15 is not listed yet because its control path may use USB serial instead of HID. If a K17 or K19 turns out to use serial too, it will not be detected over HID. K11 R2R support likewise needs the separate WalkPlay protocol rather than WolfEQ's current FiiO HID handler.
- Preset, library, settings, online-profile, release-metadata, and installer sizes are bounded before parsing or saving.
- FiiO XML import prohibits DTD/entity expansion; imported numeric values are normalized to safe finite ranges.
- Local library, lighting, and BLE cache updates use atomic replacement to reduce corruption after an interrupted save.
- AutoEQ, OPRA, and application-update downloads are restricted to their expected HTTPS hosts and repository paths.
- Update downloads use unique temporary paths, enforce a 250 MB limit, and must have a Windows executable header.
- FiiO writes validate the device profile, writable slot, band number, filter support, numeric ranges, HID report size, and response timeout.
- Application logs escape line breaks, truncate oversized entries, and rotate at 5 MB.
- The bundled Equalizer APO installer is the unmodified upstream file. The release build refuses to package it unless its SHA-256 matches the pinned 1.4.2 value. Software EQ writes only
WolfEQ.txtand one marked block in Equalizer APO'sconfig.txt, using atomic replacement.
WolfEQ does not upload local presets or device data. Online search and update checks contact the providers named above. Installer code signing or published checksum verification remains recommended for a stable release.
This is beta software. Every listed device is supported, and the K13 R2R is the one tested on hardware by WolfEQ. Devices marked save-only keep automatic readback and live writes off until their Windows HID behavior is confirmed on physical hardware.
If you use a device other than the K13 R2R, please help confirm it:
- Select the exact device model in Settings and use Reconnect device.
- Start with a flat or low-gain profile and an unused USER slot.
- Confirm the selected slot on the device before choosing Write to USER.
- Report the Windows version, device firmware, USB mode, selected slot, and whether the device stayed connected.
- Attach
%LOCALAPPDATA%\WolfEQ\logs\wolfeq.logwhen reporting a failure.
K13 controls still being explored:
- front-panel LCD text
- volume control
- EQ on/off switching
- NOS / OS / SAM mode switching
- optical and Bluetooth input switching
Please open an issue if something breaks or feels strange. Include your Windows version, device model, USB mode, and the exact preset/slot action you were doing.
git clone https://github.com/audioslayer/wolfeq.git
cd wolfeq
dotnet build WolfEQ.csproj
dotnet run --project WolfEQ.csprojRun the regression suite and dependency vulnerability audit:
dotnet test tests\WolfEQ.Tests\WolfEQ.Tests.csproj
dotnet list WolfEQ.csproj package --vulnerable --include-transitiveFor a local build-and-launch from a mapped drive or network share, use deploy.bat. It keeps WPF intermediate files under %LOCALAPPDATA%\WolfEQ\deploy-build so switching between drive letters and UNC paths cannot leave stale generated-source references.
If an older checkout reports missing Views\*.g.cs files, close any active build, remove the generated obj folder, and run the current deploy.bat again.
Build the installer with Inno Setup 6 installed:
.\build-installer.batMIT. See LICENSE for details.
Built by Tyson Wolf
Buy me a coffee





