# Introduction
This file contains significant user-visible changes for each version.
For full changelog, use `git log`.
The format is based on [Keep a Changelog]
# Summary of Releases
| Date | Release notes | wlroots version | lines-of-code |
|------------|---------------|-----------------|---------------|
| 2023-05-08 | [0.6.3] | 0.16.2 | 13050 |
| 2023-03-20 | [0.6.2] | 0.16.2 | 12157 |
| 2023-01-29 | [0.6.1] | 0.16.1 | 11828 |
| 2022-11-17 | [0.6.0] | 0.16.0 | 10830 |
| 2022-07-15 | [0.5.3] | 0.15.1 | 9216 |
| 2022-05-17 | [0.5.2] | 0.15.1 | 8829 |
| 2022-04-08 | [0.5.1] | 0.15.1 | 8829 |
| 2022-02-18 | [0.5.0] | 0.15.1 | 8766 |
| 2021-12-31 | [0.4.0] | 0.15.0 | 8159 |
| 2021-06-28 | [0.3.0] | 0.14.0 | 5051 |
| 2021-04-15 | [0.2.0] | 0.13.0 | 5011 |
| 2021-03-05 | [0.1.0] | 0.12.0 | 4627 |
## 0.6.3 - 2023-05-08
### Added
- Add `focus.followMouseRequiresMovement` to allow a stricter
focus-what-is-under-the-cursor configuration. #862
- Support window-rules including properties and on-first-map actions.
Any actions in labwc-actions(5) can be used. Only 'serverDecoration'
has been added as a property so far. Example config:
- Support configuration of window switcher field definitions.
Issues #852 #855 #879
- Add actions:
- 'Lower' Written-by: @jech
- 'Maximize'
- Support ext-session-lock protocol. Helped-by: @heroin-moose
- Handle XWayland unmanaged surface requests for 'activate' and
'override-redirect'. Fixes: #874
- Add config support for scroll-factor. Fixes #846
- Support 'follow' attribute for SendToDesktop action. Fixes #841
### Fixed
- Fix adaptive sync configuration. Helped-by: @heroin-moose #642
- Ignore SIGPIPE to fix crash caused by Wayland clients requesting X11
clipboard but closing the read-fd before/while the X11 clipboard is
being written to. Fixes #890
- Ellipsize on-screen-display text
- Validate PID before activating XWayland unmanaged surfaces to check that
the surface trying to grab focus is actually a child of the topmost
mapped window.
- Respect cursor constraint hints when cursor movement occurs after
unlocking the pointer. Written-by: @FuzzyQuills Fixes #872
- Fix invisible cursor on startup and output loss/restore.
Reported-by: @Flrian Fixes #820
- Fix decoration protocol implementation
- Respect earlier decoration negotiation results via the
xdg-decoration protocol. Previously setting `` to
`client` would cause applications which prefer server side
decorations to not have any decorations at all.
Fixes #297 #831
- Handle results of kde-server-decoration negotiations
- Fix `` cursor glitches and issues with focus
switching via Alt-Tab. Issue #830 #849
### Changed
- Make `` a toplevel element rather than a child of
``
- Default to follow="true" for SendToDesktop action as per Openbox 3.6
specification.
## 0.6.2 - 2023-03-20
This release contains refactoring and simplification relating to
view-output association and xdg/xwayland configure/map events.
Unless otherwise stated all contributions are by the core-devs
(@Consolatis, @jlindgren90 and @johanmalm).
### Added
- Add config option `` to hide
windowSwitcher (also known as On Screen Display) when switching windows.
- Enable config option `` by default.
- Add ToggleKeybinds action to disable/enable all keybinds (other than
ToggleKeybinds itself). This can be used to better control Virtual
Machines, VNC clients, nested compositors or similar. (#738 and #810)
- Implement cursor constraints (Written-by: @Ph42oN) and lock confinement.
- Support xdg-activation protocol to allow applications to activate
themselves (e.g. raise to the top and get keyboard focus) if they
provide a valid `xdg_activation token`.
- Allow clearing key/mouse bindings by using the 'None' action. This
enables the use of `` and then selectively removing keybinds.
For example the following could be used to allow using A-Left/Right with
Firefox.
### Fixed
- Prevent cursor based region-snapping when starting a move with Alt-Left.
If region-snapping is wanted in this situation, just press the modifier
again. (#761)
- Prevent rare crash due to layering move/resize/menu operations. (#817)
- Fully reset config default values on Reconfigure if not set in config
file.
- Fix visual glitch when resizing xfce4-terminal from left edge caused by
windows not accepting their request size exactly.
- Fix issue with havoc not having a valid size on map.
- Save `natural_geometry.x/y` with initially maximized xdg-view to fix an
issue where, if Thunar was started maximized, it would un-maximize to
the top-left corner rather than the center.
### Changed
- Change config option `` to ``.
Use ``
instead of:
yes
yes
yes
## 0.6.1 - 2023-01-29
As usual, this release contains lots of refactoring and bug fixes with
particular thanks going to @Consolatis, @jlindgren90, @bi4k8, @Flrian and
@Joshua-Ashton.
### Added
- Add `` config option allowing the definition of regions to which
windows can be snapped by keeping a keyboard modifier pressed while dragging
or by using the SnapToRegion action. Written-by: @Consolatis
- Add `` action to send SIGTERM to a client process. Written-by: @bi4k8
- Add config option `` to support flicker free boot
(issue #724). Written-by: @Consolatis
- Enable single-pixel-buffer-v1
- Support theme setting override by reading `/themerc-override`
- Scale down SSD button icons if necessary to allow using larger ones for high
and mixed DPI usecases. Issue #609. Written-by: @Consolatis
- Handle client request for layer-change
- Support setting color of client menu buttons. Written-by: @Flrian
- Dynamically adjust menu width based on widest item. Written-by: @Consolatis
- Add theme options menu.width.{min,max} and menu.items.padding.{x,y}
### Fixed
- Scale cursor correctly at startup and on output scale-change.
Written-by: @bi4k8
- Release layer tree when releasing output. Written-by: @yuanye
- Ensure natural geometry is restored when no outputs available.
Reported-by: @Flrian
- Fixes memory leaks and prevent crashes associated with missing outputs
Thanks to @Consolatis.
- Update translations for new client menus strings. Thanks-to: @01micko and
@ersen0
- On un-fullscreen, restore SSD before applying previous geometry to avoid
rendering offscreen in some instances. Written-by: @Consolatis
- Allow snapping to the same edge. Thanks-to: @Consolatis and @Flrian
- Send enter event when new layer surface appears under pointer. Issue #667
- Prevent re-focus for always-on-top views when switching workspaces.
Written-by: @Consolatis
- Make sure a default libinput category always exists to avoid devices not
being configured is some insances. Written-by: @jlindgren90
- Update cursor if it is within the OSD area when OSD appears/disappears.
Written-by: @bi4k8
- Provide generic parsing of XML action arguments to enable the use of the
`direction` argument in menu entries. Written-by: @Consolatis
- Fix SSD margin computation. Written-by: @jlindgren90
- Hide SSD decorations for fullscreen views to avoid rendering them on
adjacent outputs. Written-by: @jlindgren90
- Set inactive window button color correctly. Written-by: @ScarcelyThere
- Fix positioning of initially-maximized XWayland views.
Written-by: @jlindgren90
- Check for modifiers when merging mousebinds. Issue #630.
- Handle layer-shell exclusive and on-demand keyboard-interactivity
correctly, and thus support xfce4-panel better. Issues #704 and #725.
- Only overwrite wlroots's automatic layout when necessary.
### Changed
- Filter out wp_drm_lease_device from Xwayland to avoid Electron apps such as
VS Code and Discord lagging over time. Issue #553. Written-by: @Joshua-Ashton
- Do not switch output on SnapToEdge if view is maximized. Written-by: @Flrian
## 0.6.0 - 2022-11-17
This release contains significant refactoring to use the wlroots
scene-graph API. This touches many areas of the code, particularly
rendering, server-side-decoration, the layer-shell implementation and the
menu. Many thanks to @Consolatis for doing most of the heavy lifting with
this.
Noteworthy, related changes include:
- The use of a buffer implementation instead of using wlr_texture. It
handles both images and fonts, and scales according to output scale.
- The use of node-descriptors to assign roles to wlr_scene_nodes in order
to simplify the code.
- Improving the "Debug" action to print scene-graph trees
A large number of bugs and regressions have been fixed following the
re-factoring, too many to list here, but we are grateful to all who have
reported, tested and fixed issues. Particular mentions go to @bi4k8,
@flrian, @heroin-moose, @jlindgren90, @Joshua-Ashton, @01micko and @skerit
### Added
- Set environment variable LABWC_PID to the pid of the compositor so that
SIGHUP and SIGTERM can be sent to specific instances.
- Add command line options --exit and --reconfigure.
- Support setting keyboard repeat and delay at runtime. Written-by: @bi4k8
- Add support for mouse-wheel bindings. Set default bindings to switch
workspaces when scrolling on the desktop. Written-by: @Arnaudv6
- Implement key repeat for keybindings. Written-by: @jlindgren90
- Support smooth scroll and horizontal scroll. Written-by: @bi4k8
- Implement virtual keyboard and pointer protocols, enabling the use of
clients such as wtype and wayvnc. Written-by: @Joshua-Ashton
- Add github workflow CI including Debian, FreeBSD, Arch and Void,
including a build without xwayland.
- Support keybind "None" action to clear other actions for a particular
keybind context. Written-by: @jlindgren90
- Support font slant (itliacs) and weight (bold). Written-by: @jlindgren90
- Support `` mousebinds to load default mousebinds and provide
a way to keep config files simpler whilst allowing user specific binds.
Issue #416. Written-by: @Consolatis
- Add config option `` to enable/disable preview
of outlines. Written-by: @Flrian
- Render submenu arrows
- Allow highest level menu definitions - typically used for root-menu and
client-menu - to be defined without label attritube, for example like this:
``. Issue #472
- Allow xdg-desktop-portal-wlr to work out of the box by initializing dbus
and systemd activation environment. This enables for example OBS Studio
to work with no user configuration. If systemd or dbus is not available
the environment update will fail gracefully. PR #461
Written-by: @Joshua-Ashton and @Consolatis
- Workspaces. Written-by: @Consolatis
- presentation-time protocol
- Native language support for client-menus. Written-by: @01micko
- Touch support. Written-by: @bi4k8
- drm_lease_v1 for VR to work and leasing of desktop displays.
Written-by: Joshua Ashton
- ToggleAlwaysOnTop action. Written-by: @Consolatis
- Command line option -C to specify config directory
- Theme options osd.border.color and osd.border.width. Written-by: @Consolatis
- Menu `` and associated theme options:
menu.separator.width, menu.separator.padding.width,
menu.separator.padding.height and menu.separator.color
- Adjust maximized and tiled windows according to usable_area taking
into account exclusive layer-shell clients. Written-by: @Consolatis
- Restore natural geometry when moving tiled/maximized window
Fixes #391. Written-by: @Consolatis
- Improve action implementation to take a list of arguments in preperation
for actions with multiple arguments. Written-by: @Consolatis
### Fixed
- Remove unwanted gap when initially (on map) positioning windows larger
than output usable area (issue #403).
- Prevent setting cursor icon on drag. Written-by: @Consolatis (issue #549)
- Fix bugs relating to sending matching pairs of press and release
keycodes to clients when using keybinds. Also fix related key-repeat
bug. (Issue #510)
- Fix wlr_output_cursor initialization bug on new output.
Written-by: @jlindgren90
- Show correct cursor for resize action triggered by keybind.
Written-by: @jlindgren
- Fix bug which manifest itself when keeping button pressed in GTK3 menu
and firefox context menu. Written-by: @jlindgren90
- Enable tap be default on non-touch devices (which some laptop trackpads
apparently are)
- Handle missing cursor theme (issue #246). Written-by: @Consolatis
- Fix various surface syncronization, stacking, positioning and focus
issues, including those related to both xwayland, scroll/drag events
and also #526 #483
- On first map, do not center xwayland views with explicitly specified
position. Written-by: @jlindgren90
- Give keyboard focus back to topmost mapped view when unmapping topmost
xwayland unmanaged surfaces, such as dmenu. Written-by: @Consolatis.
- Fix mousebind ordering and replace earlier mousebinds by later ones
Written-by: @Consolatis
- Fix various bugs associated with destroying/disabling outputs, including
issue #497
- Hide Alt-Tab switcher when canceling via Escape. @jlindgren90
- (Re)set seat when xwayland is ready (because wlroots reset the seat
assigned to xwayland to NULL whenever Xwayland terminates).
Issues #166 #444. Written-by: @Consolatis. Helped-by: @droc12345
- Increase File Descriptor (FD) limit to max because a compositor has to
handle many: client connections, DMA-BUFs, wl_data_device pipes and so on.
Fixes client freeze/crashes (swaywm/sway#6642). Written-by: @Joshua-Ashton
- Fix crash when creating a cursor constraint and there is no currently
focused view.
- Gracefully handle dying client during interactive move.
Written-by: @Consolatis
- Dynamically adjust server-side-deccoration invisible resize areas based
on usable_area to ensure that cursor events are sent to clients such as
panels in preference to grabbing window edges. Fixes #265.
Written-by: @Consolatis
- Always position submenus inside output extents. Fixes #276
Written-by: @Consolatis
- Do not crash when changing TTY. Written-by: @bi4k8
- Set wlroots.wrap to a specific commit rather than master because it
enables labwc commits to be checked out and build without manually
having to find the right wlroots commit if there are upstream breaking
changes.
- Increase accuracy of window center-alignment, taking into account
usable_area and window decoration. Also, top/left align if window is
bigger than usable area.
- Handle view-destruction during alt-tab cycling.
Written-by: @Joshua-Ashton
- Survive all outputs being disabled
- Check that double-clicks are on the same window. Written-by: yizixiao
- Set xdg-shell window position before maximize on first map so that the
unmaximized geometry is known when started in maximized mode.
Fixes issue #305. Reported-by: @01micko
- Support `