|
| 1 | +--- |
| 2 | +author: Polybar Team |
| 3 | +account: polybar |
| 4 | +title: Polybar 3.7.0 Release |
| 5 | +excerpt: The new old tray module |
| 6 | +--- |
| 7 | + |
| 8 | +### The Numbers |
| 9 | + |
| 10 | +* **24** contributors (**17** first-time) |
| 11 | +* **120** pull-requests |
| 12 | +* **267** commits |
| 13 | +* **230** files changed |
| 14 | +* **8250** lines added |
| 15 | +* **5067** lines deleted |
| 16 | +* **45** issues closed |
| 17 | +* **27** bugs fixed |
| 18 | + |
| 19 | +### What's New? |
| 20 | + |
| 21 | +The big addition in this release is a new shiny tray module described below. |
| 22 | + |
| 23 | +On top of that we have added a bunch of smaller features and fixes. |
| 24 | +The full changelog can be found on the [release page][tag-3.7.0], but I want to |
| 25 | +highlight a few here. |
| 26 | + |
| 27 | +Restacking the bar window (defining its position in the window stack with |
| 28 | +`wm-restack`) has gotten more powerful with two new possible stacking |
| 29 | +strategies: `bottom`, `ewmh`. |
| 30 | +The `bottom` strategy is the same as the old `generic` strategy and puts |
| 31 | +polybar below all other windows. |
| 32 | +`ewmh` puts the bar above the window set in the `_NET_SUPPORTING_WM_CHECK` |
| 33 | +hint (if it is set); this is a window created by the window manager and, in |
| 34 | +some WMs, appears below other user windows, but above windows created by the WM |
| 35 | +(e.g. dedicated wallpaper windows). |
| 36 | +Finally, the `generic` strategy has been changed to first try the `ewmh` |
| 37 | +strategy and fall back to the `bottom` strategy. |
| 38 | + |
| 39 | +The `internal/temperature` module now has a `zone-type` setting where the |
| 40 | +thermal zone can be selected by name instead of by number (through |
| 41 | +`thermal-zone`) or full path (through `hwmon-path`). |
| 42 | +This makes it easier to consistenly select the desired thermal sensor because |
| 43 | +both the number or full path of the sensor may change between reboots (e.g. if |
| 44 | +the hardware configuration changes). |
| 45 | + |
| 46 | +### Tray Module |
| 47 | + |
| 48 | +This new module has the same underlying functionality as the old tray (this is |
| 49 | +not a `StatusNotifier`/`AppIndicator` tray) with the added benefit that it can |
| 50 | +be positioned just like a module instead of being restricted to the bar edges |
| 51 | +or center. |
| 52 | + |
| 53 | +In addition, we have almost completely rewritten the handling of tray icons. |
| 54 | +This effectively fixes any issues regarding the positioning of the tray and it |
| 55 | +appearing above fullscreen windows (when the bar itself does not). |
| 56 | + |
| 57 | +Read the [tracking issue](https://github.com/polybar/polybar/issues/2689) and |
| 58 | +all the issues it links to (especially |
| 59 | +[`#2595`](https://github.com/polybar/polybar/pull/2595) and |
| 60 | +[`#2609`](https://github.com/polybar/polybar/pull/2609)) for the whole story. |
| 61 | + |
| 62 | +Using the new tray module is as simple as adding a new module with the |
| 63 | +following contents (this is the entire tray configuration I am using right |
| 64 | +now): |
| 65 | + |
| 66 | +```ini |
| 67 | +[module/tray] |
| 68 | +type = internal/tray |
| 69 | +``` |
| 70 | + |
| 71 | +The old way of adding a tray to the bar is deprecated, will no longer receive |
| 72 | +any bug fixes, and everyone should migrate to the new tray module. |
| 73 | + |
| 74 | + |
| 75 | +### Migration Guide |
| 76 | + |
| 77 | +Starting with version 3.7, the migration guide now lives in the [readthedocs |
| 78 | +documentation][migration-guide]. |
| 79 | + |
| 80 | +### Next Steps |
| 81 | + |
| 82 | +As always I have big plans for the future of polybar. |
| 83 | +However, my life has gotten busier this year and I have found less time to work |
| 84 | +on polybar. |
| 85 | +This will likely not change in the foreseeable future and as a result |
| 86 | +development on polybar will necessarily slow down. |
| 87 | +In fact it already has; one reason why this release took so long to get out. |
| 88 | + |
| 89 | +Nevertheless, I still want to work on polybar, albeit more slowly. |
| 90 | +It will on be things I enjoy and not necessarily features that are much |
| 91 | +requested by the community. |
| 92 | + |
| 93 | +Until next time --- Patrick |
| 94 | + |
| 95 | +[post-3.6.0]: https://polybar.github.io/2022/03/01/Release-3.6.0.html |
| 96 | +[tag-3.7.0]: https://github.com/polybar/polybar/releases/tag/3.7.0 |
| 97 | +[milestone-3.8.0]: https://github.com/polybar/polybar/milestone/15 |
| 98 | +[migration-guide]: https://polybar.readthedocs.io/en/stable/migration/3.7/index.html |
0 commit comments