v2.23.0

What's Changed

• fix: prevent render flickering on macOS 26
• fix: prevent crashes on wake
• fix: prevent pixel shifts in animations due to off-by-one error
• feat: multiple modifiers by @erics118 in #695
• feat: truetype font features by @erics118 in #692
• build: replace deprecated '-Ofast' flag with '-O3' by @MrPiggy105 in #766
• feat: add fn modifier by @erics118 in #764
• add x_offset for background by @kylerm42 in #771

Full Changelog: v2.22.1...v2.23.0

v2.22.1

Additions

• --query displays option to obtain information about the current display configuration

Fixes

• Improve reliability of mouse events
• Improve display layout tracking

Full Changelog: v2.22.0...v2.22.1

v2.22.0

Additions

• Scroll fields are contained in the query responses
• Modifier keys held down while scrolling over an item are sent to the script
• Add compatibility with Displays have separate spaces turned off
• Support notch_display_height property by @ifedyukin in #626

Fixes

• Fix crash on scroll over a popup on a secondary monitor
• Fix crash in media_change event
• bar_item_set_position now removes the item from any popups by @Capybara121 in #619
• Fixed off-by-1 error by @Capybara121 in #592
• fix off-by-1 error for center items by @izeau in #640
• Fix popup rendering when first adding an item in and removing all items by @Capybara121 in #631

Full Changelog: v2.21.0...v2.22.0

v2.21.0

Additions

• All scripts have access to the new environment variable BAR_NAME, which holds the bar instance name (for use with multiple bars)
• Allow bracket items to host popups
• Add scroll_duration property for texts (#478)
• Allow setting the image through image.string=<image>, equivalent to image=<image>
• Add domain --load-font <path>, which makes a font from a custom path available to use

Fixes

• enable scrolling with touchpad gestures #505
• Fix memory leaks in truncated text width calculation
• Fix memory corruption if an item is set to a popup position multiple times
• Improve reliability of mouse.exited events
• Limit hotloading to avoid hotload loops

Optimizations

• Reduce draw calls for backgrounds
• Improve the animation system (threaded rendering, better frame skip detection, better chained animations)
• Sort the query response of default_menu_items by their position in the macOS bar

Full Changelog: v2.20.1...v2.21.0

v2.20.1

Improvements

• Improve default config
• Reimplement the sticky property -- with sticky=on, the bar is now stationary during space change animations (#493)

Fixes

• Fix memory leak in space_windows_change event logic
• Fix duplicate keys in $INFO for space_windows_change event (#498)
• Fix timing issues on system wake (#497)

Full Changelog: v2.20.0...v2.20.1

v2.20.0

Changes

• We now check for the "Displays have separate spaces" option being enabled on startup, because several things are not working properly in a different space management mode. (#392)
  See https://felixkratz.github.io/SketchyBar/setup#prerequisite for details where to find that option. Since this is the default setting it is probable that most people will not have any problems with this.

Fixes

• fix volume_change event not triggering for bluetooth mute (#481)
• fix bar being unhidden after wake if it was hidden (#477)
• fix hidden windows not properly triggering the space_windows_change event (#492)

Full Changelog: v2.19.6...v2.20.0

Overall Improvements

Fixes

• Properly scale app icon images, such that they have the same size on all displays
• Fix the bar disappearing after sleep in certain scenarios
• Fix rare crash on front_app_switched event
• Fix rare crash on media_change event
• always fire a volume_change event when a new device is connected (#458)
• properly update space windows when a space is created/destroyed
• add hidden property to query output (#467)
• fix default color for graphs (#468)
• fix broken json output for some queries containing single quotes (#474)

Additions

• Emit media_change event on startup to populate items
• Automatically emit a space_change event on space creation and destruction (Ventura and up)
• Add more image properties (#428)
• New option for bar items: scroll_texts=<boolean> which will automatically scroll though texts which are truncated with the max_chars property.
• Add media.artwork value option for all images
• Add space_windows_change event (#435)

Changes

• The sticky bar property does nothing on Sonoma, since it is no longer required
• Rework the window levels sketchybar uses
• Using the localized application name for the image domain app... is now possible

Full Changelog: v2.18.0...v2.19.6

Local Documentation & Bug Fixes

Fixes

• Partially fix the wifi_change event on macOS Sonoma (#407)
• Fix a crash when using image app icons (#423)
• Fix for bars not properly rebuilding after wake from sleep in rare circumstances (#422)

Additions

• Add max_chars property to all texts to simplify string truncation (#414)
• Local documentation (via man)

Contributions

• Local documentation by @ralphptorres in #421
• Update volume icons by @AndreasNasman in #418

Full Changelog: v2.17.1...v2.18.0

Sonoma improvements

Fixes

• Fix problems with animations slightly changing color properties in some circumstances (#404)
• Fix animations not showing the last animation frame
• Fix the bar frame from being changed by a draw call (#240)

Improvements

• Use transactional window ordering on Sonoma since Apple seems to have fixed the api (#336)
• the properties associated_display and associated_space are now equivalent to display and space respectively.
• chdir into config dir before executing the config

Full Changelog: v2.16.4...v2.17.1

Hotload, reload and color subdomains

Improvements

• Remove Cocoa as library dependencies
• Better internal event logic
• The animation system now uses a CVDisplayLink to create properly paced animation frames

Additions

• New subdomain for all color properties where individual channels can be changed (docs here)
• Add mouse.scrolled event by @revan in #380
• Add configuration reload and hotload functionality (docs here)

Fixes

• Replace default config wifi icon

Full Changelog: v2.15.2...v2.16.4