Skip to content

Add allmazz/decky-volume-mixer - #1019

Open
allmazz wants to merge 2 commits into
SteamDeckHomebrew:mainfrom
allmazz:add-decky-volume-mixer
Open

Add allmazz/decky-volume-mixer#1019
allmazz wants to merge 2 commits into
SteamDeckHomebrew:mainfrom
allmazz:add-decky-volume-mixer

Conversation

@allmazz

@allmazz allmazz commented Apr 8, 2026

Copy link
Copy Markdown

Add Mixer to Plugin Store

A configurable plugin that allows you to quickly control the volume of your applications.
There is similar plugin named "Volume Mixer", but it uses pactl instead of pipewire with wireplumber and not configurable.

Task Checklist

Developer

  • I am the original author or an authorized maintainer of this plugin.
  • I have abided by the licenses of the libraries I am utilizing, including attaching license notices where appropriate.

Plugin

  • I have verified that my plugin works properly on the Stable and Beta update channels of SteamOS.
  • I have verified my plugin is unique or provides more/alternative functionality to a plugin already on the store.

Backend

  • No: I am using a custom backend other than Python.
  • No: I am using a tool or software from a 3rd party FOSS project that does not have it's dependencies statically linked.
  • No: I am using a custom binary that has all of it's dependencies statically linked.

Community

  • I have tested and left feedback on two other pull requests for new or updating plugins.
  • I have commented links to my testing report in this PR.

Testing

  • Tested by a third party on SteamOS Stable or Beta update channel.

@allmazz
allmazz requested a review from a team as a code owner April 8, 2026 15:37
@github-actions github-actions Bot added the plugin-addition Adding a plugin to the Plugin Store label Apr 8, 2026
@github-actions

github-actions Bot commented Apr 8, 2026

Copy link
Copy Markdown

Issues Found

  • Both testing boxes are present in your description. Please remove one of them per the Markdown comment above the testing section.

Next Steps

  1. If we found any issues above, please edit your pull request description to resolve them and leave a comment saying you've done so.
  2. For the quickest review, please see the Community section of the pull request template for how you can help other developers.
  3. Once your description is correct, a maintainer will review your pull request as soon as possible.

Thank you for your contribution! If you need any help, please reach out on our Discord server. ❤️

@allmazz

allmazz commented Apr 8, 2026

Copy link
Copy Markdown
Author

Issues Found

* Both testing boxes are present in your description. Please remove one of them per the Markdown comment above the testing section.

Next Steps

1. If we found any issues above, please edit your pull request description to resolve them and leave a comment saying you've done so.

2. For the quickest review, please see the Community section of the pull request template for how you can help other developers.

3. Once your description is correct, a maintainer will review your pull request as soon as possible.

Thank you for your contribution! If you need any help, please reach out on our Discord server. ❤️

fixed

@allmazz

allmazz commented Apr 8, 2026

Copy link
Copy Markdown
Author

I would be glad to test it on SteamOS, but I do not have a Steam Deck.
Used and tested on desktop with Steam in -steamdeck mode with gamescope

@EMERALD0874

Copy link
Copy Markdown
Member

@allmazz Since this is a new plugin, please recruit a tester in our Discord server or elsewhere who can install and test this plugin on a Steam Deck. That is our primary userbase and any plugins on the store should generally work on Steam Decks unless very clearly intended for other devices.

@EMERALD0874

Copy link
Copy Markdown
Member

Sorry, I misremembered our requirements. It doesn't need to be tested on a Steam Deck, but you do need to test it on SteamOS in general. Please do that and we can move forward with the PR process! :)

@Managor

Managor commented Apr 12, 2026

Copy link
Copy Markdown
Contributor

Confirming that this works on the Deck

@beebls beebls left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Code LGTM, just want a confirmation that the dependencies you mentioned needing (wpctl and pw-dump) are present on a stock Steam Deck, we don't want plugins that require users disabling read-only or otherwise modifying the system.

If you can confirm that those packages exist on a stock install then I'll get it off to testing.

@allmazz

allmazz commented Apr 22, 2026

Copy link
Copy Markdown
Author

Code LGTM, just want a confirmation that the dependencies you mentioned needing (wpctl and pw-dump) are present on a stock Steam Deck, we don't want plugins that require users disabling read-only or otherwise modifying the system.

If you can confirm that those packages exist on a stock install then I'll get it off to testing.

Yes, they preinstalled since SteamOS uses pipewire with wireplumber and in Arch there is no separate package pipewire-tools like on Fedora. Kindly confirmed and tested by a discord server member.

#1019 (comment)

@github-actions

github-actions Bot commented May 1, 2026

Copy link
Copy Markdown

This pull request is stale as no updates or testing reports have been posted within the last 7 days. Please ensure you are actively recruiting testers or resolving the issues discussed. If you do not remove the stale label or comment, this will be closed in 7 days. Please close this pull request if you need more time to resolve issues so we can keep our repo healthy.

@github-actions github-actions Bot added the stale label May 1, 2026
@EMERALD0874

Copy link
Copy Markdown
Member

Just realized this was never deployed to the testing store. Sorry about that!

@Managor

Managor commented May 3, 2026

Copy link
Copy Markdown
Contributor

Plugin Testing Report

Installed Plugins

  • Decky Clipper - 1.0.2
  • SteamGridDB - 1.7.1
  • Mixer 0.1.0
  • Download All - 1.0.0
  • ProtonDB Badges - 1.2.0
  • PlayCount - 1.7

Specifications

  • SteamOS 3.9 (Main)
  • Steam 1777686279 (Beta)
  • Decky 3.2.3 (Prerelease)

Issues

Has the following major blocking issue(s):
Nothing

Has the following minor non-blocking issue(s):
Nothing

Summary

No noticeable issues with the plugin. Audio gets changed as expected and boost limit allows to boosting the audio. I did not test the regex excludes.

@github-actions github-actions Bot removed the stale label May 4, 2026
@beebls

beebls commented May 6, 2026

Copy link
Copy Markdown
Contributor

You have merge conflicts and we aren't authorized to update the PR, please rebase to fix the conflicts

@allmazz
allmazz force-pushed the add-decky-volume-mixer branch from b4390fd to 3bf361a Compare May 6, 2026 22:02
@allmazz

allmazz commented May 6, 2026

Copy link
Copy Markdown
Author

You have merge conflicts and we aren't authorized to update the PR, please rebase to fix the conflicts

done

@beebls

beebls commented May 13, 2026

Copy link
Copy Markdown
Contributor

Off to testing store now, just gonna need one more testing report saying that the testing store version itself works and then we can merge it (you can even get the same user from before to check again)

@github-actions

Copy link
Copy Markdown

This pull request is stale as no updates or testing reports have been posted within the last 7 days. Please ensure you are actively recruiting testers or resolving the issues discussed. If you do not remove the stale label or comment, this will be closed in 7 days. Please close this pull request if you need more time to resolve issues so we can keep our repo healthy.

@github-actions github-actions Bot added the stale label May 21, 2026
@bschelst

Copy link
Copy Markdown
Contributor

Plugin Testing Report

Installed Plugins

  • Crosshair - 1.1.0
  • ScreenshotUploader - 0.0.3
  • AutoFlatpaks - 1.6.8
  • DeckyParty File Manager - 0.1.0-40ad556
  • Decky-Framegen - 0.11.15
  • Decky LSFG-VK - 0.12.2
  • Speed Test - 1.0.0-7c9430b
  • SteamGridDB - 1.7.0
  • Decky Terminal - 0.5.3
  • HLTB for Deck - 2.0.6
  • MangoPeel - 0.0.7
  • Network Sentinel - 1.0.4-9c70b89
  • NonSteamLaunchers - 1.3.24
  • PlayCount - 1.6
  • ProtonDB Badges - 1.4.0
  • Animation Changer - 1.3.2
  • CSS Loader - 2.1.2
  • Game Theme Music - 1.7.1-1-4621abd
  • Shotty - 0.1.0
  • Steam Status - 1.2.3
  • Tailscale Control - 0.1.4-3e1f103
  • vibrantDeck - 2.0.1

Specifications

  • SteamOS 3.9 (Beta)
  • Steam 1778803745 (Beta)
  • Decky v3.2.4-pre1
  • Steam Deck LCD (512Gb)
  • Steam Dock.
  • Steam controller

Issues

Has the following major blocking issue(s): None
Has the following minor non-blocking issue(s): None

Summary

Works as documented, no issues at all.
[not 100% sure if a test report was still needed]

@github-actions github-actions Bot removed the stale label May 26, 2026
@BRiAn3274

Copy link
Copy Markdown

Plugin Testing Report

Plugin: decky-volume-mixer / Mixer
PR: #1019
Tester: BRiAn3274
Device: Steam Deck OLED 512GB
SteamOS channel: Stable
SteamOS version: 3.8.11
Steam version: 1782533657
Decky Loader version: v3.2.6
Install method: Manually installed from PR build for testing

Test Environment

  • Steam Deck: Steam Deck OLED 512GB
  • Mode: Game Mode
  • SteamOS version: 3.8.11
  • Steam version: 1782533657
  • Decky Loader: v3.2.6
  • Installed plugins during this test:
    • AirDeck
    • Mixer
    • Decky Clash
    • KDEck

Summary

I tested Mixer on a real Steam Deck OLED in Game Mode. The plugin installed and appeared in the Decky quick access menu, but it failed to load when opened.

The plugin showed a SteamUI / Decky plugin loading error immediately, so I was not able to test the volume mixing functionality.

Installation

  • Installed Mixer from the PR build.
  • The plugin appeared in the Decky quick access menu.
  • Opening the plugin resulted in a load error.
  • No further functional testing could be completed because the frontend failed to load.

Error Observed

20260629125101_1

When opening Mixer, Decky displayed the following error:

SyntaxError: Unexpected token 'export'
at PluginLoader.importReactPlugin
at async PluginLoader.importPlugin
at async Promise.all
at async PluginLoader.loadPlugins

@BRiAn3274

Copy link
Copy Markdown

I am also submitting my own plugin, KDEck, here:
#1067
If you have time, I would appreciate a test report in return. KDEck focuses on KDE Connect-style clipboard and file transfer in Game Mode.

@BRiAn3274 BRiAn3274 mentioned this pull request Jun 29, 2026
8 tasks
@allmazz

allmazz commented Jun 29, 2026

Copy link
Copy Markdown
Author

Plugin Testing Report

Plugin: decky-volume-mixer / Mixer PR: #1019 Tester: BRiAn3274 Device: Steam Deck OLED 512GB SteamOS channel: Stable SteamOS version: 3.8.11 Steam version: 1782533657 Decky Loader version: v3.2.6 Install method: Manually installed from PR build for testing

Test Environment

* Steam Deck: Steam Deck OLED 512GB

* Mode: Game Mode

* SteamOS version: 3.8.11

* Steam version: 1782533657

* Decky Loader: v3.2.6

* Installed plugins during this test:
  
  * AirDeck
  * Mixer
  * Decky Clash
  * KDEck

Summary

I tested Mixer on a real Steam Deck OLED in Game Mode. The plugin installed and appeared in the Decky quick access menu, but it failed to load when opened.

The plugin showed a SteamUI / Decky plugin loading error immediately, so I was not able to test the volume mixing functionality.

Installation

* Installed Mixer from the PR build.

* The plugin appeared in the Decky quick access menu.

* Opening the plugin resulted in a load error.

* No further functional testing could be completed because the frontend failed to load.

Error Observed

20260629125101_1

When opening Mixer, Decky displayed the following error:

SyntaxError: Unexpected token 'export'
at PluginLoader.importReactPlugin
at async PluginLoader.importPlugin
at async Promise.all
at async PluginLoader.loadPlugins

Are you using latest loader? I tried to reproduce it on latest stable SteamOS with plugin version from the store, but plugin loaded successfully. Or, could you try to unload other plugins temporary please? Error looks really uncommon, I think it's about installing/packaging/loader side error, not plugin itself.

@BRiAn3274

Copy link
Copy Markdown

Are you using latest loader? I tried to reproduce it on latest stable SteamOS with plugin version from the store, but plugin loaded successfully. Or, could you try to unload other plugins temporary please? Error looks really uncommon, I think it's about installing/packaging/loader side error, not plugin itself.

I updated the client/loader and the issue disappeared on my side. It may have just been a coincidence, or something specific to my Steam Deck setup.

Sorry if this caused any confusion. I think this can be ignored for now unless it happens to someone else too.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

plugin-addition Adding a plugin to the Plugin Store

Projects

None yet

Development

Successfully merging this pull request may close these issues.

6 participants