Feat(bar): add a toggle for exclusion zone

[SpeakingPNG]

Pull Request

Add a toggle to be able to manually configure the 1px exclusion zone bleed. No translation, but could be added if needed.

Motivation

Currently, BarExclusionZone.qml hardcodes a 1 physical pixel reduction (bleedInset) to the bar's reserved space. This hardcoded approach does not work simultaneously for both Niri and hyprland. To fix this conflict, this PR makes the exclusion zone offset configurable, allowing users to change the bleed behavior on the fly depending on their compositor and gap preferences.

Type of Change

Mark the relevant option with an "x".

• Bug fix
• New feature
• Breaking change
• Refactoring

Related Issue

• 15539e1445f66934dcbdb099bbdcd7724ef81664 introduces a hairline under bar #716
• 35e7e34ebf28d521b026fe0289817c6e46e09ec3 introduces a hairline under bar. #1163
• 50685937da2b25d645b42f661b02fd6a964c0dbd introduces a hairline under bar #1252

Testing

• Tested on niri
• Tested on Hyprland
• Tested on sway
• Tested with different bar positions and density settings
• Tested at different interface scaling values
• Tested with multiple monitors (if applicable)

Screenshots / Videos

Menu

With the option turned off

With the option turned on

Checklist

• Code follows project style guidelines
• Self-reviewed my code
• No new warnings or errors
• Documentation or comments updated (if relevant)

Additional Notes

It's not a complete fix, as in niri with gaps (e.g. 4) and the setting turned off (enableExclusionZoneInset is false) there is still 1 extra pixel visible. It does seem like a niri issue though.

When scrolling left

When scrolling right

[Copilot]

Pull request overview

Adds a user-facing toggle to control whether the bar’s Wayland exclusion zone is reduced by 1 physical pixel (to influence window “bleed” under the bar), addressing compositor-specific behavior differences (e.g., Niri vs Hyprland).

Changes:

• Add a new bar.exclusionZoneOffset boolean setting with defaults.
• Expose the setting as an NToggle in the Bar → Appearance settings UI and include it in settings search indexing.
• Update BarExclusionZone.qml to apply a 0px/1px (physical) inset based on the toggle and display scale.

Reviewed changes

Copilot reviewed 5 out of 5 changed files in this pull request and generated 6 comments.

Show a summary per file

File	Description
Modules/Panels/Settings/Tabs/Bar/AppearanceSubTab.qml	Adds a new toggle in the Bar Appearance settings for the exclusion zone inset behavior.
Modules/MainScreen/BarExclusionZone.qml	Makes the 1-physical-pixel exclusion zone inset conditional on the new setting.
Commons/Settings.qml	Introduces the new bar.exclusionZoneOffset setting in the settings adapter.
Assets/settings-search-index.json	Adds the new toggle’s label/description keys to the settings search index.
Assets/settings-default.json	Defines the new setting’s default value in shipped defaults.

---

💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.

[Copilot]

Pull request overview

Copilot reviewed 6 out of 6 changed files in this pull request and generated 2 comments.

---

💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.