Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Add DSP settings info #142

Merged
merged 31 commits into from
Jan 4, 2025
Merged
Show file tree
Hide file tree
Changes from 9 commits
Commits
Show all changes
31 commits
Select commit Hold shift + click to select a range
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
Binary file added docs/assets/screenshots/dsp.jpg
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
21 changes: 21 additions & 0 deletions docs/player-support/index.md
Original file line number Diff line number Diff line change
Expand Up @@ -23,3 +23,24 @@ Players can only deleted if they are unavailable or disabled. Deleting a player
Audio quality is the principal reason why native MA players are developed. These players provide the highest quality playback experience. HA players should work and may work well but they may also have been written with a basic objective such as enabling text to speech. Therefore, if there is a MA player available and a HA integration then you should always choose the MA player.

A sample rate above 48kHz or a bit depth above 16 is considered High Resolution (Hi Res)

## DSP Settings

All providers have the option to apply [Digital Signal Processing](https://en.wikipedia.org/wiki/Digital_signal_processing) (DSP) filters to the audio stream. The option is found in the MA settings for each player which means that each player has its own independently configurable DSP settings.
OzGav marked this conversation as resolved.
Show resolved Hide resolved

DSP settings will be disabled for all groups except AirPlay and Snapcast.

The DSP path has mandatory INPUT and OUTPUT filters and optionally the following can also be added (multiple times if desired):
OzGav marked this conversation as resolved.
Show resolved Hide resolved

- Parametric Equalizer
- Tone Controls
OzGav marked this conversation as resolved.
Show resolved Hide resolved

The DSP settings can be enabled and disabled via a toggle which allows easy [A-B testing](https://www.youtube.com/watch?v=KefGjPYyIO4)

The line on the left of the DSP settings represents the audio path from the audio file (top) to the speaker (bottom).
OzGav marked this conversation as resolved.
Show resolved Hide resolved

A dot on the line represents a filter that changes the signal. The lack of a dot indicates that the particular filter has been disabled.

Using the icons at the top of the view, the additional filters can be reordered, disabled/enabled or deleted.

![DSP image](../assets/screenshots/dsp.jpg)