Skip to content

Releases: polybar/polybar

3.7.1

27 Nov 16:20
3.7.1
91bd85c
Compare
Choose a tag to compare

Download

polybar-3.7.1.tar.gz (sha256: 5de6ad385ba09dc453a4e5ec7054749a4882b5b21a62c17ae40bf7c90613ff0f)

Changelog

Build

  • Fixed missing header when using libc++ in clang 15 and below

Changed

  • internal/tray: The module must use the <tray> tag (this is the default) (#3037)

Fixed

  • Modules did not validate that all tags (e.g. <label>) used in a format were valid for that format (#3043, #3045)
  • internal/tray: Fixed module-margin and separator being applied to completely empty tray module (#3036, #3037)

Full Changelog: 3.7.0...3.7.1

3.7.0

05 Nov 22:37
3.7.0
2471f35
Compare
Choose a tag to compare

Download

polybar-3.7.0.tar.gz (sha256: b8e07aca94a013341b7d47ee548afe84f519113f202300565d4852885a11e91d)

Changelog

Migration Guide

Breaking

  • custom/script:
    • No longer hides the module if the exec command failed and did not change the output from the previous run (#2636). Somewhat similar original behaviour can be imitated with format-fail, if necessary.
    • If the exec command produced no output and exited with a non-zero exit code the module is no longer completely empty, but just has an empty %output% token. If you relied on this behavior to hide the module under certain circumstances, make sure the script exits with an exit code of zero. (#2857, #2861)

Build

  • Respect CMAKE_INSTALL_PREFIX when installing default config (#2770, #2917)
  • Change default CMAKE_INSTALL_PREFIX to /usr. Installations with default flags will now go into /usr instead of /usr/local (#2917)
  • Bump C++ version to C++17 (#2847)

Deprecated

  • custom/text: The content setting and all its properties are deprecated in favor of format with the same functionality. (#2676)
  • tray: All tray-related settings in the bar section are deprecated. They are replaced by the new tray module (#3002)
    • tray-position, tray-detached, tray-maxsize, tray-scale, tray-transparent, tray-background, tray-foreground, tray-padding, tray-offset-x, tray-offset-y

Added

  • A tray module with type internal/tray for positioning the tray like a module (#2689)
  • internal/temperature: %temperature-k% token displays the temperature in degrees Kelvin (#2774, #2784)
  • internal/pulseaudio: reverse-scroll option (#2664)
  • custom/script: Repeat interval for script failure (interval-fail) and exec-if (interval-if) (#943, #2606, #2630)
  • custom/ipc:
  • custom/text: Loads the format setting, which supports the <label> tag, if the deprecated content is not defined (#1331, #2673, #2676)
  • internal/backlight:
    • scroll-interval option (#2696, #2700)
    • poll-interval setting controls how often the module is updated (in case it does not happen when the brightness changes) (#2835, #3028)
  • internal/temperature: Added zone-type setting (#2572, #2752) by @xphoniex
  • internal/xwindow: %class% and %instance% tokens, which show the contents of the WM_CLASS property of the active window (#2830)
  • Added enable-struts option in bar section to enable/disable struts (#2769, #2844) by @VanillaViking.
  • wm-restack:
    • bottom: lowers polybar to the bottom of the window stack (same as the previous behavior of generic) (#2961)
    • ewmh: Tries to use the _NET_SUPPORTING_WM_CHECK hint to position the bar (#2961)
  • internal/xworkspaces: group-by-monitor setting to decide whether _NET_DESKTOP_VIEWPORT should be used to group workspaces by monitor; (#2603, #2926) by @slotThe.

Changed

  • custom/script:
    • No longer produces a completely empty module if the exec command failed. It only produces an empty module if the script had a zero exit code. (#2857, #2861)
    • Bumped the script polling interval (not related to the interval setting) to decrease wakeups. Polybar may take slightly longer to shut down. #2879
  • internal/fs: Use / as a fallback if no mountpoints are specified (#2572, #2705)
  • internal/backlight:
    • Detect backlight if none specified (#2572, #2728)
    • use-actual-brightness now always defaults to true (even for amdgpu backlights) (#2835, 2839)
  • Providing a negative min-width to a token adds right-padding (#2789, #2801) by @VanillaViking.
  • Changed fuzzy match option on i3 and bspwm modules to find longest match instead of the first match (#2831, #2829) by @Ron0Studios.
  • wm-restack
    • generic: Is now a best effort combination of other restacking strategies. First tries ewmh and then the bottom strategy (#2961)
    • bspwm: Will restack above the topmost bspwm root window instead of the root window associated with the monitor polybar is on (#3019)

Fixed

  • Waiting for double click interval on modules that don't have a double click action (#2663, #2695)
  • renderer:
    • Small gaps when rendering emojis (#2785, #2802)
    • Crash when using pseudo-transparency with certain wallpapers (#2798, #2813)
    • Crash when invalid UTF-8 text is encountered (#2091, #2958)
  • config:
    • Error reporting for deprecated config values (#2724)
    • Also monitor include-files for changes when --reload is set (#675, #2759)
  • internal/xwindow: module does not crash when a tag is not provided in format (#2826, #2833) by @VanillaViking
  • internal/i3: module errors when i3 has negative gaps (#2888, #2889)
  • internal/backlight: Fix module being one step behind every update (#2835, #3028)
  • wm-restack = bspwm: bar may become unclickable if there are overlapping monitors (#2873, #2961)

New Contributors

3.6.3

04 May 09:05
a962a26
Compare
Choose a tag to compare

Download:

polybar-3.6.3.tar.gz (sha256: f25758573567208fc7b6f4d4115a6117a87389cbcc094cf605d079775be95fa5)

Changelog

Fixed

  • custom/script: Output clearing when exec-if fails (#2674)
  • internal/battery: poll-interval not working (#2649, #2677)
  • ipc: Polybar failing to open IPC channel after another user already ran polybar, if XDG_RUNTIME_DIR is not set (#2683, #2684)
  • No overlines/underlines being drawn when using offsets (#2685)
  • Update struts (_NET_WM_STRUT_PARTIAL) when hiding the bar (#2702)
  • internal/pulseaudio: Hanging during startup (#2707, #2709)
  • internal/xworkspaces: Updates of _NET_DESKTOP_VIEWPORT being ignored (#2693, #2698)

Full Changelog: 3.6.2...3.6.3

3.6.2

03 Apr 17:55
77d611c
Compare
Choose a tag to compare

Download:

polybar-3.6.2.tar.gz (sha256: 73becc942e7d2418bc72bd194f2037a2a86792219fd561b663a8509fd5f547a0)

Changelog

Fixed

  • format-offset being ignored (#2643)
  • Negative struts (margin-bottom, margin-top) being ignored (#2642, #2644)
  • Positioning in awesomeWM (#2651)
  • internal/xworkspaces: The module sometimes crashed polybar when windows were closed. (#2655)
  • Mouseover error when only one cursor is defined (#2656)
  • custom/script: Timing inconsistencies (#2650, first described at #2630)

Full Changelog: 3.6.1...3.6.2

3.6.1

05 Mar 13:29
4a61d31
Compare
Choose a tag to compare

Download:

polybar-3.6.1.tar.gz (sha256: a898ba8c847895be41efe5a31bb1b839da2c10b130b8411d5016982fbaadff7b)

Changelog

Build

  • Fixed compiler warning in Clang 13 (#2613)
  • Fixed compiler error in GCC 12 (#2616, #2614)
  • Fixed installation of docs when some are not generated (man, html...) (#2612)
  • Fix LDFLAGS not being respected (#2619)

Fixed

  • tray-offset-x, tray-offset-y, offset-x, and offset-y were mistakenly capped below at 0 (#2620)
  • custom/script: Polybar shutdown being stalled by hanging script (#2621)
  • polybar-msg: Wrong hint when using deprecated hook (#2624)

New Contributors

Full Changelog: 3.6.0...3.6.1

3.6.0

01 Mar 18:28
fce5c44
Compare
Choose a tag to compare

Download:

polybar-3.6.0.tar.gz (sha256: 563473d5ae2b83d4dba6372f85cbcfd8d5a271b4cf3345ff57acff9c81e1b065)

Changelog

Breaking

  • We added the backslash escape character (\) for configuration values. This means that the literal backslash character now has special meaning in configuration files, therefore if you want to use it in a value as a literal backslash, you need to escape it with the backslash escape character. The parser logs an error if any unescaped backslashes are found in a value. This affects you only if you are using two consecutive backslashes in a config value, which will now be interpreted as a single literal backslash. (#2354)
  • We rewrote our formatting tag parser. This shouldn't break anything, if you experience any problems, please let us know. The new parser now gives errors for certain invalid tags where the old parser would just silently ignore them. Adding extra text to the end of a valid tag now produces an error. For example, tags like %{T-a}, %{T2abc}, %{rfoo}, and others will now start producing errors. This does not affect you unless you are producing your own invalid formatting tags (for example in a script).
  • For security reasons, the named pipe at /tmp/polybar_mqueue.<PID> had its permission bits changed from 666 to 600 to prevent sending ipc messages to polybar processes running under a different user.
  • Also for security reasons, the polybar-msg command will now only send messages to polybar processes running under the same user. See the IPC documentation for what exactly this means.

Build

  • New dependency: libuv. At least version 1.3 is required.
  • Bump the minimum cmake version to 3.5
  • The BUILD_IPC_MSG option has been renamed to BUILD_POLYBAR_MSG
  • Building the documentation is now enabled by default and not just when sphinx-build is found.
  • Users can control exactly which targets should be available with the following cmake options (together with their default value):
    • BUILD_POLYBAR=ON - Builds the polybar executable
    • BUILD_POLYBAR_MSG=ON - Builds the polybar-msg executable
    • BUILD_TESTS=OFF - Builds the test suite
    • BUILD_DOC=ON - Builds the documentation
    • BUILD_DOC_HTML=BUILD_DOC - Builds the html documentation (depends on BUILD_DOC)
    • BUILD_DOC_MAN=BUILD_DOC - Builds the manpages (depends on BUILD_DOC)
    • BUILD_CONFIG=ON - Generates the default config
    • BUILD_SHELL=ON - Generates shell completion files
    • DISABLE_ALL=OFF - Disables all above targets by default. Individual targets can still be enabled explicitly.
  • The documentation can no longer be built by directly configuring the doc directory.
  • The POLYBAR_FLAGS cmake variable can be used to pass extra C++ compiler flags.
  • The sample config file has been removed.
  • Polybar now ships a default config that is installed to /etc/polybar/config.ini, it lives in doc/config.ini. It will also be placed in the examples directory in the documentation folder. (#2405)
  • The userconfig target has been removed, you can no longer use make userconfig. As an alternative, you can copy the default config from /etc/polybar/config.ini.
  • The DEBUG_SHADED cmake variable and its associated functionality has been removed.

Deprecated

  • [settings]: throttle-output and throttle-output-for have been removed. The new event loop already does a similar thing where it coalesces update triggers if they happen directly after one another, leading to only a single bar update.
  • When not specifying the config file with --config, naming your config file config is deprecated. Rename your config file to config.ini.
  • Directly writing ipc messages to /tmp/polybar_mqueue.<PID> is deprecated, users should always use polybar-msg. As a consequence the message format used for IPC is deprecated as well.
  • polybar-msg hook is deprecated in favor of using the hook action. polybar-msg will tell you the correct command to use.

Added

  • Support px and pt units everyhwere where before only a number of spaces or pixels could be specified. (#2578, #1651, #951)
  • internal/alsa: Right and middle click settings. (#2566, #2573)
  • internal/network:
    • New token %mac% shows MAC address of selected interface (#2568, #2569)
    • New token %netspeed% that provides the total speed of the internet (up + down speed) (#2590, #1083)
    • speed-unit = B/s can be used to customize how network speeds are displayed. (#2068)
    • interface-type may be used in place of interface to automatically select a network interface (#2025, #339)
  • Polybar can now read config files from stdin: polybar -c /dev/stdin. (#2545)
  • custom/script:
    • Setting environment variables using env-* config option. (#2090, #2512)
    • Add formatting for script failure (format-fail, label-fail) (#2588, #2596)
  • Support for ramp weights. (#1750, #2505)
  • internal/memory: New tokens %used%, %free%, %total%, %swap_total%, %swap_free%, and %swap_used% that automatically switch between MiB and GiB when below or above 1GiB. (#2472, #2488)
  • internal/i3: show-urgent option to always show urgent windows when pin-workspace is active (#2374, #2378)
  • internal/xworkspaces:
    • reverse-scroll can be used to reverse the scroll direction when cycling through desktops. (#2365)
    • %nwin% can be used to display the number of open windows per workspace (#604, #2329)
  • Initial support for the backslash escape character (\) in configs. (#2354, #2361)
  • Warn states for the cpu, memory, fs, and battery modules. (#570, #956, #1871, #2141, #2199)
    • internal/battery: format-low, label-low, animation-low, low-at = 10.
    • internal/cpu: format-warn, label-warn, warn-percentage = 80
    • internal/fs: format-warn, label-warn, warn-percentage = 90
    • internal/memory: format-warn, label-warn, warn-percentage = 90
  • radius now affects the bar border as well (#1566, #2359)
  • Per-corner radius with radius-{bottom,top}-{left,right} (#2294, #2297)
  • internal/xkeyboard:
    • %variant% token to display the keyboard layout variant (#316, #2163)
    • Allow matching of variants in layout-icon (#2414, #2521)
  • Config option to hide a certain module (hidden = false) (#2108, #2342)
  • Actions to control visibility of modules (module_toggle, module_show, and module_hide) (#2108, #2426)
  • internal/backlight: use-actual-brightness option to use the actual_brightness file to get the brightness (#2380)
  • wm-restack = generic option that lowers polybar to the bottom of the window stack. Fixes the issue where the bar is being drawn on top of fullscreen windows in xmonad. (#2205, #2404)
  • internal/bspwm: occupied-scroll = true option allows scrolling through occupied desktops only. (#2427, #2428)
  • custom/ipc:
    • send action to send arbitrary strings to be displayed in the module. (#2455, #2463)
    • hook, next, prev, reset actions to control the module thr...

3.5.7

21 Sep 16:21
92722e0
Compare
Choose a tag to compare

Download:

polybar-3.5.7.tar.gz (sha256: 73210e6d74217acb953b253990b4302343b7b6a7870fe1da9a1855daa44123db)

Changelog

Fixed

  • The tray mistakenly removed tray icons that did not support XEMBED (#2479, #2442)
  • custom/ipc: Only the first appearance of the %pid% token was replaced (#2500)

3.5.6

23 May 23:05
eb9c192
Compare
Choose a tag to compare

Download:

polybar-3.5.6.tar.gz (sha256: dfe602fc6ac96eac2ae0f5deb2f87e0dd1f81ea5d0f04ad3b3bfd71efd5cc038)

Changelog

Build

  • Support building documentation on sphinx 4.0 (#2424)

Fixed

  • Tray icons sometimes appears outside of bar (#2430, #1679)
  • Crash in the i3 module (#2416)

3.5.5

01 Mar 20:39
1d033ed
Compare
Choose a tag to compare

Download:

polybar-3.5.5.tar.gz (sha256: 7e625d3b6f7885587e70200fd81c2a5d3fb03f5649422de8e138747152ca0bb1)

Changelog

Build

  • Support older python sphinx versions again (#2356)

3.5.4

07 Jan 12:53
fdc670a
Compare
Choose a tag to compare

Download:

polybar-3.5.4.tar.gz (sha256: 133af4e8b29f426595ad3b773948eee27275230887844473853e7940c7959c2b)

Changelog

Fixed

  • Wrong text displayed if module text ends with } (#2331)