GSP
Quick Navigator

Search Site

Unix VPS
A - Starter
B - Basic
C - Preferred
D - Commercial
MPS - Dedicated
Previous VPSs
* Sign Up! *

Support
Contact Us
Online Help
Handbooks
Domain Status
Man Pages

FAQ
Virtual Servers
Pricing
Billing
Technical

Network
Facilities
Connectivity
Topology Map

Miscellaneous
Server Agreement
Year 2038
Credits
 

USA Flag

 

 

Man Pages
waybar-styles(5) FreeBSD File Formats Manual waybar-styles(5)

waybar-styles - using stylesheets for waybar

Waybar uses Cascading Style Sheets (CSS) to configure its appearance.

It uses the first file found in this search order:

  • $XDG_CONFIG_HOME/waybar/style.css
  • ~/.config/waybar/style.css
  • ~/waybar/style.css
  • /etc/xdg/waybar/style.css
  • /usr/local/etc/xdg/waybar/style.css

An example user-controlled stylesheet that just changes the color of the clock to be green on black, while keeping the rest of the system config the same would be:

@import url("file:///etc/xdg/waybar/style.css")
#clock {

background: #000000;
color: #00ff00; }

You can apply special styling to any module for when the cursor hovers it.

#clock:hover {

background-color: #ffffff; }

Most, if not all, module types support setting the `cursor` option. This is configured in your `config.jsonc`. If set to `false`, when hovering the module a "pointer"(as commonly known from web CSS styling `cursor: pointer`) style cursor will not be shown. Default behavior is to indicate an interaction event is available.

There are more cursor types to choose from by setting the `cursor` option to a number, see Gdk3 official docs for all possible cursor types: https://docs.gtk.org/gdk3/enum.CursorType.html. However, note that not all cursor options listed may be available on your system. If you attempt to use a cursor which is not available, the application will crash.

Example of disabling pointer(`Gdk::Hand2`) cursor type on a custom module:

"custom/my-custom-module": {

...
"cursor": false, }

Example of setting cursor type to `Gdk::Boat`(according to https://docs.gtk.org/gdk3/enum.CursorType.html#boat):

"custom/my-custom-module": {

...
"cursor": 8, }

waybar(5)
2025-07-19

Search for    or go to Top of page |  Section 5 |  Main Index

Powered by GSP Visit the GSP FreeBSD Man Page Interface.
Output converted with ManDoc.