Enhance touchscreen handling, fake deck configuration, and UI styling by designgears · Pull Request #512 · StreamController/StreamController

designgears · 2026-01-02T19:23:17Z

Summary

This PR improves touchscreen handling, enhances fake deck configuration capabilities, fixes UI styling to accurately match physical hardware, and resolves a GObject Introspection warning.

Changes

1. Enhance touchscreen handling and fake deck configuration

Added safety checks for touchscreen size to prevent errors when touchscreen is not available
Updated DeckController and related classes to return None for touchscreen size when not applicable
Improved fake deck loading logic to allow for customizable deck types based on settings
Refactored settings page to dynamically update deck type selections based on the number of fake decks configured

Files changed:

src/backend/DeckManagement/DeckController.py
src/backend/DeckManagement/DeckManager.py
src/backend/DeckManagement/Subclasses/FakeDeck.py
src/windows/Settings/Settings.py
src/windows/mainWindow/DeckPlus/ScreenBar.py
src/windows/mainWindow/elements/KeyGrid.py

2. Fix GObject Introspection warning

Added gi.require_version("Gdk", "4.0") to HelperMethods.py to resolve GObject Introspection version warning

Files changed:

src/backend/DeckManagement/HelperMethods.py

Testing

Verified touchscreen handling works correctly when touchscreen is available
Verified no errors occur when touchscreen is not available
Tested fake deck configuration with different deck types
Verified settings page correctly updates deck type selections
Verified no GObject Introspection warnings appear

Impact

Improved reliability: Prevents errors when touchscreen is unavailable
Enhanced flexibility: Fake deck configuration is more customizable
Code quality: Resolved GObject Introspection warning

Images

Before:

After:

Fake Decks:

Fixed focus logic in ScreenBar to properly detect swipe gestures Corrected inverted swipe direction (left/right events were swapped) Added swipe event support for dial inputs (matching existing touch press behavior)

restored deleted code I didn't mean to delete.

clean up whitespace

I need to stop editing on github, it's bad idea.

…und image handling

…es in DeckController and BackgroundVideoCache

… there were ampersands.

- Added checks for touchscreen size to prevent errors when it is not available. - Updated DeckController and related classes to return None for touchscreen size when not applicable. - Improved fake deck loading logic to allow for customizable deck types based on settings. - Enhanced UI components to adapt to real touchscreen sizes, ensuring accurate display and interaction. - Refactored settings page to dynamically update deck type selections based on the number of fake decks configured.

This reverts commit 75a485a.

Core447 · 2026-01-03T08:26:58Z

First of all, thank you!
Some things I noticed:

For the change in Fake Deck Type a restart of the app is required which is a bit annoying. Especially because it isn't noted anywhere. I know that the app doesn't handle it well if we change the deck configuration on the fly. But maybe we can internally remove the old deck and then add the new one on each change?
For consistency reasons the keys in the UI should be the same size across the different devices. (I know that they differ on the physical devices, but still).
I understand that you prefer black as the background for the keys in the UI, as this is again how it is on the physical deck. However, the old grey looks way cleaner in the app. And I don't see a case where the user would get something from having the black backgrounds. But I actually see a use case where the transparent background is neat: To see if the action uses a transparent background or not. This allows the user to quickly see if a wallpaper or background color would be visible on a key.
You replaced all "&" with "and" in locales.csv, even for other languages than English.

I really like that it's not possible to configure the type of fake decks! Great work!

designgears · 2026-01-03T15:22:52Z

First of all, thank you! Some things I noticed:

For the change in Fake Deck Type a restart of the app is required which is a bit annoying. Especially because it isn't noted anywhere. I know that the app doesn't handle it well if we change the deck configuration on the fly. But maybe we can internally remove the old deck and then add the new one on each change?

For consistency reasons the keys in the UI should be the same size across the different devices. (I know that they differ on the physical devices, but still).

I understand that you prefer black as the background for the keys in the UI, as this is again how it is on the physical deck. However, the old grey looks way cleaner in the app. And I don't see a case where the user would get something from having the black backgrounds. But I actually see a use case where the transparent background is neat: To see if the action uses a transparent background or not. This allows the user to quickly see if a wallpaper or background color would be visible on a key.

You replaced all "&" with "and" in locales.csv, even for other languages than English.

I really like that it's not possible to configure the type of fake decks! Great work!

I noticed this as well and was trying to work around it, it's pretty odd, you can add them all, change the type, remove them all, and add them again and it works. Even before this PR things can end up very slow and a restart is needed to correct that.
Selfish reasons on my part for this one since the keys are larger on the SD+, it's very nice seeing the full resolution of them and the touchbar. An option to render them to the full size would be a good compromise I think.
Selfish reasons again here, it made finding rendering issues easier, but then again I swapped thru a lot of colors while testing. This we can omit, setting the background color per button or deck wide is sufficient.
Didn't think that thru, oof.

This was all rushed together just as a proof of concept, I'll keep hammering on the fake deck type swap and see if I can make that play nice.

Edit: reworked what I was trying to do before, figured out my mistake and made that work pretty well!

…k types - Added reload_fake_deck method to DeckManager for targeted fake deck updates without reloading all decks. - Method removes and re-adds specific fake deck at correct position to apply type changes. - Updated settings page to use reload_fake_deck instead of load_fake_decks for better performance when changing deck types. - Ensures proper ordering of hardware and fake decks in controller lists and UI.

… accurrate." This reverts commit 29a4ebd.

…xt where there were ampersands." This reverts commit 5a921a7.

…references components - Added background color styling to preferenceswindow, preferencespage, and preferencesgroup elements to prevent text rendering artifacts in the settings interface.

- Import html module for entity escaping - Escape HTML/XML entities in translated strings before returning them to prevent markup parsing issues in GTK labels and UI elements

…d as CSV column separators, causing the column alignment to shift.

…rence dialogs

designgears added 18 commits November 16, 2025 19:23

Fix swipe event detection on Stream Deck Plus touchscreen

75a485a

Fixed focus logic in ScreenBar to properly detect swipe gestures Corrected inverted swipe direction (left/right events were swapped) Added swipe event support for dial inputs (matching existing touch press behavior)

whoops

853ed83

restored deleted code I didn't mean to delete.

clean up whitespace

0509583

clean up whitespace

Cleanup

1b7e57e

I need to stop editing on github, it's bad idea.

feat(KeyGrid): Set fixed size and pixel size for key button images

f8ea684

feat: Add alignment property to labels and implement touchbar backgro…

5bc7369

…und image handling

fix(DeckManagement): Ensure proper cleanup of video and image resourc…

ccef613

…es in DeckController and BackgroundVideoCache

Merge branch 'icon-fix'

25c3fe6

Merge branch 'enhancements'

c103669

Merge remote-tracking branch 'upstream/main'

35d3db4

Merge remote-tracking branch 'upstream/main'

6b7c48e

Remove the ampersands to fix the parse warning and missing text where…

5a921a7

… there were ampersands.

Fix warning

5174d05

rework styles to matches the physical hardware so previews is accurrate.

29a4ebd

fix warning

f2e30b0

Merge remote-tracking branch 'upstream/main'

5ef91c5

Revert "Fix swipe event detection on Stream Deck Plus touchscreen"

ff80659

This reverts commit 75a485a.

github-project-automation Bot added this to Dev Jan 2, 2026

designgears mentioned this pull request Jan 2, 2026

fix(KeyGrid): Set fixed size and pixel size for key button images #509

Merged

designgears added 6 commits January 3, 2026 08:56

Revert "rework styles to matches the physical hardware so previews is…

b0aa9c2

… accurrate." This reverts commit 29a4ebd.

Revert "Remove the ampersands to fix the parse warning and missing te…

75d0296

…xt where there were ampersands." This reverts commit 5a921a7.

Fix text artifacts in settings window by adding background color to p…

73b3fd2

…references components - Added background color styling to preferenceswindow, preferencespage, and preferencesgroup elements to prevent text rendering artifacts in the settings interface.

Add HTML entity escaping to locale strings for GTK markup compatibility

5a86069

- Import html module for entity escaping - Escape HTML/XML entities in translated strings before returning them to prevent markup parsing issues in GTK labels and UI elements

Fix German text that contained semicolons which were being interprete…

c48a30e

…d as CSV column separators, causing the column alignment to shift.

designgears force-pushed the fake_deck_changes branch from bc6235e to c48a30e Compare January 3, 2026 16:45

Scope settings window background fix to prevent affecting other prefe…

5c0eda8

…rence dialogs

Add custom CSS class to settings window for targeted styling

f15122d

designgears marked this pull request as draft January 3, 2026 16:58

Provide feedback

Saved searches

Use saved searches to filter your results more quickly

Uh oh!

Uh oh!

Enhance touchscreen handling, fake deck configuration, and UI styling#512

Enhance touchscreen handling, fake deck configuration, and UI styling#512
designgears wants to merge 26 commits into
StreamController:mainfrom
designgears:fake_deck_changes

designgears commented Jan 2, 2026 •

edited

Loading

Uh oh!

Core447 commented Jan 3, 2026 •

edited

Loading

Uh oh!

designgears commented Jan 3, 2026 •

edited

Loading

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

2 participants

Uh oh!

Uh oh!

Conversation

designgears commented Jan 2, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Summary

Changes

1. Enhance touchscreen handling and fake deck configuration

2. Fix GObject Introspection warning

Testing

Impact

Images

Uh oh!

Core447 commented Jan 3, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Uh oh!

designgears commented Jan 3, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

2 participants

designgears commented Jan 2, 2026 •

edited

Loading

Core447 commented Jan 3, 2026 •

edited

Loading

designgears commented Jan 3, 2026 •

edited

Loading