EQVita: Difference between revisions

EQVita
EQVita
General
Author	shev0k
Type	Utilities
Version	1.13.0
License	GPL-3.0
Last Updated	2026/06/17
Links
	Download
	Website
	Source

← Older edit

Latest revision as of 07:42, 19 June 2026

EQVita is a hobby homebrew project made to give the Vita a richer sound. It ships as a kernel plugin plus a small Vita app.

Install it, open the app, pick a preset, and make the Vita sound less flat. Nerd version: the plugin hooks sceAudioOutOutput, while the app handles presets, route hints, themes, logs, and boot state.

Features

10-band graphic EQ from 31 Hz to 16 kHz.
Simple EQ mode for bass, mids, treble, and preamp.
Advanced EQ mode for every band and preamp.
Built-in STOCK Depth and MOD Switch presets.
Preset slots with save/load support.
Music Preview for playing a local OGG, MP3, or WAV while tuning EQ.
Speaker-only mode or all-output mode for wired/Bluetooth too.
Optional HPF (Bass guard), which cuts very low rumble.
Safe, Loud, and Direct headroom modes.
Vita-style app UI with themes. Crimson Vita is the default.
Boot persistence through ur0:data/eqvita/boot.eqbs.
App log at ur0:data/eqvita/app.log.

Installation

Copy eq_speaker.skprx to ur0:tai/.

Add to ur0:tai/config.txt under *KERNEL:

*KERNEL
ur0:tai/eq_speaker.skprx

Reboot, install EQVita.vpk through VitaShell.

Open EQVita and pick a preset.

Note: Keep the app and plugin from the same release. Mixed versions can fail or behave weirdly.

User guide

Presets And Data

EQVita stores data in: ur0:data/eqvita/

Files you may see there:

preset0.eqvp, preset1.eqvp, preset2.eqvp - preset slots.
boot.eqbs - boot state.
theme.cfg - selected app theme.
app.log - useful log for bug reports.

There are three preset slots. EQ changes apply live, and saving writes the current settings into the selected slot.

The built-in presets are starting points. Applying STOCK Depth or MOD Switch saves that preset into the active slot and startup state.

Small warning: every Vita, speaker mod, headphone, and Bluetooth setup is different. Blindly copying my bass-heavy presets can cause clipping or ugly distortion on your setup. If that happens, lower preamp first.

If you make a preset that sounds nice, please share it in this repo's Discussions. Over time, it would be cool to build a small preset library from real user setups instead of pretending one preset fits everything.

The boot state is what lets the plugin load your saved sound after reboot, before you open the app again.

Old raw preset%d.bin files are imported read-only when a matching .eqvp file does not exist.

Music Preview

The app can play a local song while you tune EQ.

Put an OGG, MP3, or WAV file somewhere on your Vita, open Music Preview, choose the file, then adjust EQ like normal.

Notes:

No music is bundled in the VPK.
ux0:music/ is shown as a shortcut in the file picker when available.
Preview playback stops and releases the audio port when you stop it or close EQVita.
This is only for tuning. It is not trying to replace your normal music player.

Output Modes

Vita speakers mode applies EQ only to the Vita speakers.

All outputs mode also allows wired headphones and Bluetooth output.

If EQ is bypassed, the app tries to show why. Common reasons are:

EQ is turned off.
The selected output mode does not match the current route.
The output port is unknown or busy.
The audio format is unsupported.
The app and plugin ABI do not match.

Short bypasses can happen when the Vita opens, closes, or reconfigures audio ports. If it is quick and does not sound bad, it is usually fine.

Controls

D-Pad/Left Analog - Move through rows

Left/Right - Adjust selected value

L/R - Bigger EQ value changes

Cross - Select, toggle, or activate

Circle - Back, Exit from main menu

Start - Quick EQ on/off

Triangle - Help

Touch - Tap rows or drag lists

EQVita follows the Vita enter-button setting for Cross/Circle.

Screenshots

Compatibility

Hardware Tested:

Vita model - PS Vita 1000
Firmware - 3.65 Enso
Output - Vita speakers, Bluetooth
Games/apps tested - Persona 4 Golden, God of War, VitaShell, Vita home screen
Known limits - heavy games can still stress Vita audio; short bypasses during port changes can happen.

Changelog

v1.13.0

What's New
- New Vita-style app UI with themes, cleaner pages, and better controls.
- New Music Preview screen for playing a local OGG, MP3, or WAV while tuning EQ.
- New preset flow with save prompts, discard behavior, and active preset persistence.
- Better logs and telemetry for audio/debug reports.
- Proper full system-wide equalizer support. The plugin should now affect all audio ports.
Fixed
- Fixed preset saving/loading and active slot persistence.
- Fixed compatibility with the official Music Player; the plugin now affects it correctly.
- Fixed compatibility with the music_premium.skprx plugin.
- Improved app exit, theme switching, and Music Preview cleanup.
- Improved audio stability and reduced timing spikes on stock Vita clocks.
- Fixed Windows/WSL script and source-test release checks.
Notes
- Current app/plugin ABI: 1.13.0
- Official builds only come from this GitHub repo.
- If audio behaves weirdly, open EQVita once after the issue happens, then share ur0:data/eqvita/app.log.
- Presets are a starting point. Every Vita/speaker mod is different, so lower preamp if you hear distortion.
- No music files are bundled in the VPK.

v1.10

First Release.

Credits

UI images adapted from VitaShell.

External links

GitHub - https://github.com/shev0k/EQVita
VitaDB - https://www.rinnegatamante.eu/vitadb/#/info/1353

@@ Line 1: / Line 1: @@
 {{Infobox Vita Homebrews
 |title=EQVita
-|image=EQVita.png
+|image=EQVita2.png
 |description=System-wide EQ kernel plugin and app for PS Vita.
 |author=shev0k
-|lastupdated=2025/12/22
+|lastupdated=2026/06/17
 |type=Utilities
-|version=1.10
+|version=1.13.0
-|license=N/A
+|license=GPL-3.0
 |download=https://dlhb.gamebrew.org/vitahomebrews/EQVita.7z
 |website=https://github.com/shev0k/EQVita
@@ Line 19: / Line 19: @@
 |image_alt=EQVita
 }}
-EQVita is a system-wide 8-band graphic equalizer kernel plugin + companion app for PS Vita (3.65 Ensō).
+EQVita is a hobby homebrew project made to give the Vita a richer sound. It ships as a kernel plugin plus a small Vita app.
+Install it, open the app, pick a preset, and make the Vita sound less flat. Nerd version: the plugin hooks <code>sceAudioOutOutput</code>, while the app handles presets, route hints, themes, logs, and boot state.
-This is the first EQ app to control frequency bands across the entire PS Vita audio system.
+== Features ==
+* 10-band graphic EQ from <code>31 Hz</code> to <code>16 kHz</code>.
+* Simple EQ mode for bass, mids, treble, and preamp.
+* Advanced EQ mode for every band and preamp.
+* Built-in <code>STOCK Depth</code> and <code>MOD Switch</code> presets.
+* Preset slots with save/load support.
+* Music Preview for playing a local <code>OGG</code>, <code>MP3</code>, or <code>WAV</code> while tuning EQ.
+* Speaker-only mode or all-output mode for wired/Bluetooth too.
+* Optional HPF (Bass guard), which cuts very low rumble.
+* Safe, Loud, and Direct headroom modes.
+* Vita-style app UI with themes. <code>Crimson Vita</code> is the default.
+* Boot persistence through <code>ur0:data/eqvita/boot.eqbs</code>.
+* App log at <code>ur0:data/eqvita/app.log</code>.
 == Installation ==
-* Copy <code>eq_speaker.skprx</code> to <code>ur0:tai/</code>.
+Copy <code>eq_speaker.skprx</code> to <code>ur0:tai/</code>.
-* Add to <code>ur0:tai/config.txt</code> under <code>*KERNEL</code>:
+Add to <code>ur0:tai/config.txt</code> under <code>*KERNEL</code>:
 <pre>*KERNEL
 ur0:tai/eq_speaker.skprx</pre>
-* Reboot.
-* Install <code>EQVita.vpk</code> through [[VitaShell]].
-* Run EQVita to adjust settings.
-'''Note:''' The plugin is disabled by default to prevent boot issues. Launch EQVita to enable it.
+Reboot, install <code>EQVita.vpk</code> through [[VitaShell]].
+Open EQVita and pick a preset.
+'''Note:''' Keep the app and plugin from the same release. Mixed versions can fail or behave weirdly.
 == User guide ==
-Options:
+=== Presets And Data ===
-* Bands: 31Hz - 4kHz (Note: HPF option disables frequencies under 70Hz).
+EQVita stores data in: <code>ur0:data/eqvita/</code>
-* Gain: ±12 dB
-* Status: Shows route, sample rate, and clip count.
+Files you may see there:
+* <code>preset0.eqvp</code>, <code>preset1.eqvp</code>, <code>preset2.eqvp</code> - preset slots.
+* <code>boot.eqbs</code> - boot state.
+* <code>theme.cfg</code> - selected app theme.
+* <code>app.log</code> - useful log for bug reports.
+There are three preset slots. EQ changes apply live, and saving writes the current settings into the selected slot.
+The built-in presets are starting points. Applying <code>STOCK Depth</code> or <code>MOD Switch</code> saves that preset into the active slot and startup state.
+Small warning: every Vita, speaker mod, headphone, and Bluetooth setup is different. Blindly copying my bass-heavy presets can cause clipping or ugly distortion on your setup. If that happens, lower preamp first.
+If you make a preset that sounds nice, please share it in this repo's [https://github.com/shev0k/EQVita/discussions Discussions]. Over time, it would be cool to build a small preset library from real user setups instead of pretending one preset fits everything.
+The boot state is what lets the plugin load your saved sound after reboot, before you open the app again.
+Old raw <code>preset%d.bin</code> files are imported read-only when a matching <code>.eqvp</code> file does not exist.
+=== Music Preview ===
+The app can play a local song while you tune EQ.
+Put an <code>OGG</code>, <code>MP3</code>, or <code>WAV</code> file somewhere on your Vita, open <code>Music Preview</code>, choose the file, then adjust EQ like normal.
 Notes:
-* Bluetooth detection is not yet implemented.
+* No music is bundled in the VPK.
-* DSP uses an in-place biquad chain with smoothing.
+* <code>ux0:music/</code> is shown as a shortcut in the file picker when available.
-* If audio crackles, reduce gain or preamp.
+* Preview playback stops and releases the audio port when you stop it or close EQVita.
+* This is only for tuning. It is not trying to replace your normal music player.
+=== Output Modes ===
+<code>Vita speakers</code> mode applies EQ only to the Vita speakers.
+<code>All outputs</code> mode also allows wired headphones and Bluetooth output.
+If EQ is bypassed, the app tries to show why. Common reasons are:
+* EQ is turned off.
+* The selected output mode does not match the current route.
+* The output port is unknown or busy.
+* The audio format is unsupported.
+* The app and plugin ABI do not match.
+Short bypasses can happen when the Vita opens, closes, or reconfigures audio ports. If it is quick and does not sound bad, it is usually fine.
 == Controls ==
-Triangle - Save preset
+D-Pad/Left Analog - Move through rows
-Square - Load preset (<code>ux0:data/eqvita/preset0.bin</code>)
+Left/Right - Adjust selected value
+L/R - Bigger EQ value changes
+Cross - Select, toggle, or activate
+Circle - Back, Exit from main menu
+Start - Quick EQ on/off
+Triangle - Help
+Touch - Tap rows or drag lists
+EQVita follows the Vita enter-button setting for Cross/Circle.
 ==Screenshots==
-https://dlhb.gamebrew.org/vitahomebrews/images/EQVita-01.png
+https://dlhb.gamebrew.org/vitahomebrews/images/EQVita3.png
-https://dlhb.gamebrew.org/vitahomebrews/images/EQVita-02.png
+https://dlhb.gamebrew.org/vitahomebrews/images/EQVita4.png
+https://dlhb.gamebrew.org/vitahomebrews/images/EQVita5.png
 ==Compatibility==
-Tested on PS Vita 1000 (PCH-1000) with Switch OLED speaker mod. Should work on other models.
+Hardware Tested:
+* Vita model - PS Vita 1000
+* Firmware - 3.65 Enso
+* Output - Vita speakers, Bluetooth
+* Games/apps tested - Persona 4 Golden, God of War, VitaShell, Vita home screen
+* Known limits - heavy games can still stress Vita audio; short bypasses during port changes can happen.
+==Changelog==
+'''v1.13.0'''
+* What's New
+** New Vita-style app UI with themes, cleaner pages, and better controls.
+** New Music Preview screen for playing a local <code>OGG</code>, <code>MP3</code>, or <code>WAV</code> while tuning EQ.
+** New preset flow with save prompts, discard behavior, and active preset persistence.
+** Better logs and telemetry for audio/debug reports.
+** Proper full system-wide equalizer support. The plugin should now affect all audio ports.
+* Fixed
+** Fixed preset saving/loading and active slot persistence.
+** Fixed compatibility with the official Music Player; the plugin now affects it correctly.
+** Fixed compatibility with the music_premium.skprx plugin.
+** Improved app exit, theme switching, and Music Preview cleanup.
+** Improved audio stability and reduced timing spikes on stock Vita clocks.
+** Fixed Windows/WSL script and source-test release checks.
+* Notes
+** Current app/plugin ABI: <code>1.13.0</code>
+** Official builds only come from this GitHub repo.
+** If audio behaves weirdly, open EQVita once after the issue happens, then share <code>ur0:data/eqvita/app.log</code>.
+** Presets are a starting point. Every Vita/speaker mod is different, so lower preamp if you hear distortion.
+** No music files are bundled in the VPK.
-==Changelog==
 '''v1.10'''
 * First Release.