Skip to content

Equalizer

Get and set equalizer settings


Turn on the EQ

GET
/EQOn

https://10.10.10.254/httpapi.asp?command=EQOn

Responses

Default response

text/html
JSON
{
  
"status": "OK"
}

Playground

Samples


Turn off the EQ setting

GET
/EQOff

https://10.10.10.254/httpapi.asp?command=EQOff

Responses

Default response

text/html
JSON
{
  
"status": "OK"
}

Playground

Samples


Check if the EQ is ON or OFF

GET
/EQGetStat

http://10.10.10.254/httpapi.asp?command=EQGetStat

JSON Response:
{"EQStat":"On"} or {"EQStat":"Off"}

Responses

Default response

application/json
JSON
{
  
"EQStat": "string"
}

Playground

Samples


Check all the possible EQ settings

GET
/EQGetList

http://10.10.10.254/httpapi.asp?command=EQGetList

Response:

["Flat", "Acoustic", "Bass Booster", "Bass Reducer", "Classical",
"Dance", "Deep", "Electronic",

"Hip-Hop", "Jazz", "Latin", "Loudness", "Lounge", "Piano", "Pop", "R&B",
"Rock", "Small

Speakers", "Spoken Word", "Treble Booster", "Treble Reducer", "Vocal
Booster"]

Responses

Default response

text/html
JSON
[
]

Playground

Samples


Get the current EQ band

GET
/EQGetBand

http://10.10.10.254/httpapi.asp?command=EQGetBand

Response:

{"status":"OK","source_name":"wifi","EQStat":"Off","Name":"Rock","pluginURI":"http://moddevices.com/plugins/caps/Eq10HP","channelMode":"Stereo","EQBand":[{"index":0,"param_name":"band31hz","value":71},{"index":1,"param_name":"band63hz","value":67},{"index":2,"param_name":"band125hz","value":63},{"index":3,"param_name":"band250hz","value":56},{"index":4,"param_name":"band500hz","value":48},{"index":5,"param_name":"band1khz","value":46},{"index":6,"param_name":"band2khz","value":52},{"index":7,"param_name":"band4khz","value":60},{"index":8,"param_name":"band8khz","value":65},{"index":9,"param_name":"band16khz","value":56}]}

Responses

Default response

text/html
JSON
[
]

Playground

Samples


Set the specific EQ with name

GET
/EQLoad:{name}

http://10.10.10.254/httpapi.asp?command=EQLoad:xxx

Note: xxx is the one of the name in the list returned by EQGetList,
i.e., EQLoad:Flat

Parameters

Path Parameters

name*

The name in the list returned by EQGetList, i.e., EQLoad:Flat

Type
string
Required
Valid values
"Flat""Acoustic""Bass Booster""Bass Reducer""Classical""Dance""Deep""Electronic""Hip-Hop""Jazz""Latin""Loudness""Lounge""Piano""Pop""R&B""Rock""Small Speakers""Spoken Word""Treble Booster""Treble Reducer""Vocal Booster"

Responses

Default response

text/html
JSON
{
  
"status": "OK"
}

Playground

Variables
Key
Value

Samples


Set Bass level

GET
/EQSet:Bass:{n}

...

Parameters

Path Parameters

n*

Unknown

Type
integer
Required

Responses

Successful response

Playground

Variables
Key
Value

Samples


Set Treble level

GET
/EQSet:Treble:{n}

...

Parameters

Path Parameters

n*

Unknown

Type
integer
Required

Responses

Successful response

Playground

Variables
Key
Value

Samples


Equalizer enable

GET
/EQEnable

...

Responses

Successful response

Playground

Samples


Equalizer disable

GET
/EQDisable

...

Responses

Successful response

Playground

Samples


Set (a specific) band of the 10-band EQ

GET
/EQSetBand:%7B%22EQBand%22:[%7B%22index%22:{n1},%22param_name%22:{str},%22value%22:{n2}%7D]%7D

https://10.10.10.254/httpapi.asp?command=EQSetBand:{"EQBand":[{"index":0,"param_name":"band31hz","value":10}]}

A way to control the 10-band EQ, including real-time updates from external inputs.

Example 1 - single band change to 10:

https://10.10.10.254/httpapi.asp?command=EQSetBand:{"EQBand":[{"index":0,"param_name":"band31hz","value":10}]}'

Example 2 - sets all bands to 52:

https://10.10.10.254/httpapi.asp?command=EQSetBand:{"EQBand":[{"index":0,"param_name":"band31hz","value":52},{"index":1,"param_name":"band63hz","value":52},{"index":2,"param_name":"band125hz","value":52},{"index":3,"param_name":"band250hz","value":52},{"index":4,"param_name":"band500hz","value":52},{"index":5,"param_name":"band1khz","value":52},{"index":6,"param_name":"band2khz","value":52},{"index":7,"param_name":"band4khz","value":52},{"index":8,"param_name":"band8khz","value":52},{"index":9,"param_name":"band16khz","value":52}]}'

Notes:

  • using WiiM Ultra with firmware version 5.2.809757 (beta), build date 20260304
  • works instantly on the device
  • changes the currently selected source's EQ
  • values are 0-99 (50 = flat)
  • app UI reflects changes after leaving/re-entering the EQ screen for that source
  • driven from a wireless EQ deck that posts physical slider positions to MQTT, which are then read, scaled, and sent on to the WiiM
  • with ~0.4s throttle the WiiM keeps up and tracks slider movements well
  • EQGetBand tells you info about your current source, including the band values, which is how I worked this out.

Parameters

Path Parameters

n1*

Index of the EQ band to set, where 0 corresponds to the 31Hz band, 1 to the 62Hz band, and so on up to 9 for the 16kHz band.

Type
integer
Required
str*

Name of the parameter to set, which should be in the format "band{frequency}hz", where {frequency} is the center frequency of the band (e.g., "band31hz", "band63hz", "band125hz", "band250hz", "band500hz", "band1khz", "band2khz", "band4khz", "band8khz", "band16khz").

Type
string
Required
n2*

Value to set for the specified EQ band, where 0-99 represents the gain level (50 = flat, values above 50 boost the band, and values below 50 cut the band).

Type
integer
Required

Responses

Successful response

Playground

Variables
Key
Value

Samples


Set LV2 band

GET
/EQSetLV2Band:{str}

...

Parameters

Path Parameters

str*

Unknown

Type
string
Required

Responses

Successful response

Playground

Variables
Key
Value

Samples


Set LV2 source band

GET
/EQSetLV2SourceBand:{str}

...

Parameters

Path Parameters

str*

Unknown

Type
string
Required

Responses

Successful response

Playground

Variables
Key
Value

Samples


Delete EQ v2 settings

GET
/EQv2Delete:{str}

...

Parameters

Path Parameters

str*

Unknown

Type
string
Required

Responses

Successful response

Playground

Variables
Key
Value

Samples


Rename EQ v2 settings

GET
/EQv2Rename:{str}

...

Parameters

Path Parameters

str*

Unknown

Type
string
Required

Responses

Successful response

Playground

Variables
Key
Value

Samples


Change source FX

GET
/EQChangeSourceFX:{str}

...

Parameters

Path Parameters

str*

Unknown

Type
string
Required

Responses

Successful response

Playground

Variables
Key
Value

Samples


Change FX

GET
/EQChangeFX:{str}

...

Parameters

Path Parameters

str*

Unknown

Type
string
Required

Responses

Successful response

Playground

Variables
Key
Value

Samples


Get LV2 band

GET
/EQGetLV2Band:{pluginURI}

...

Parameters

Path Parameters

pluginURI*

Unknown

Type
string
Required
Example"http://moddevices.com/plugins/caps/Eq10HP"

Responses

Successful response

Playground

Variables
Key
Value

Samples


Get LV2 source band

GET
/EQGetLV2SourceBand:{str}

...

Parameters

Path Parameters

str*

Unknown

Type
string
Required

Responses

Successful response

Playground

Variables
Key
Value

Samples


Get LV2 source band with extra parameters

GET
/EQGetLV2SourceBandEx:{str}

...

Parameters

Path Parameters

str*

Unknown

Type
string
Required

Responses

Successful response

Playground

Variables
Key
Value

Samples


Get EQ v2 list

GET
/EQv2GetList:{str}

...

Parameters

Path Parameters

str*

Unknown

Type
string
Required

Responses

Successful response

Playground

Variables
Key
Value

Samples


Get new EQ v2 list

GET
/EQv2GetNewList:{str}

...

Parameters

Path Parameters

str*

Unknown

Type
string
Required

Responses

Successful response

Playground

Variables
Key
Value

Samples


Load EQ v2 settings

GET
/EQv2Load:{str}

...

Parameters

Path Parameters

str*

Unknown

Type
string
Required

Responses

Successful response

Playground

Variables
Key
Value

Samples


Source load EQ v2 settings

GET
/EQv2SourceLoad:{str}

...

Parameters

Path Parameters

str*

Unknown

Type
string
Required

Responses

Successful response

Playground

Variables
Key
Value

Samples


Turn off EQ source

GET
/EQSourceOff:{str}

...

Parameters

Path Parameters

str*

Unknown

Type
string
Required

Responses

Successful response

Playground

Variables
Key
Value

Samples


Set channel mode

GET
/EQSetChannelMode:{str}

...

Parameters

Path Parameters

str*

Unknown

Type
string
Required

Responses

Successful response

Playground

Variables
Key
Value

Samples


Save EQ source settings

GET
/EQSourceSave:{str}

...

Parameters

Path Parameters

str*

Unknown

Type
string
Required

Responses

Successful response

Playground

Variables
Key
Value

Samples


Save EQ settings

GET
/EQSave:{str}

...

Parameters

Path Parameters

str*

Unknown

Type
string
Required

Responses

Successful response

Playground

Variables
Key
Value

Samples


Get LV2 band with extra parameters

GET
/EQGetLV2BandEx:{pluginURI}

...

Parameters

Path Parameters

pluginURI*

Unknown

Type
string
Required
Example"http://moddevices.com/plugins/caps/Eq10HP"

Responses

Successful response

Playground

Variables
Key
Value

Samples


Get the EQ source modes

GET
/EQGetSourceModes

Makes a call to https://10.10.10.254/httpapi.asp?command=EQGetSourceModes

Responses

Successful response

application/json
JSON
[
  
{
  
  
"source_name": "string",
  
  
"NameLR": "string",
  
  
"EQStat": "string",
  
  
"Name": "string",
  
  
"pluginURI": "string",
  
  
"channelMode": "string"
  
}
]

Playground

Samples


Save the current EQ setting as "Custom"

GET
/EQSave:Custom

Makes a call to https://10.10.10.254/httpapi.asp?command=EQSave:Custom

Responses

Successful response

Playground

Samples


Powered by VitePress OpenAPI