waybar-menu(5)                File Formats Manual               waybar-menu(5)

<?><?><?> (NAME)
       waybar - <?><?><?><?><?> <?><?><?> (menu)

<?><?><?><?> <?><?><?> (OVERVIEW)
       <?><?><?><?> <?><?><?><?><?><?><?><?><?> <?><?> <?><?><?><?><?> 'menu'
       <?><?><?><?><?><?><?><?> <?><?><?><?><?><?><?> <?><?> <?><?><?><?><?>
       <?><?><?><?><?> <?><?> <?><?><?><?> <?><?><?><?><?><?> <?><?>
       <?><?><?><?><?> <?><?><?><?><?> <?><?><?><?>
       <?><?><?><?><?><?><?><?><?> <?><?><?> <?><?><?><?><?><?>
       <?><?><?><?><?> <?><?><?><?><?><?><?>.

<?><?><?><?><?><?><?><?> (PROPERTIES)
       <?><?><?><?><?><?><?> <?><?> <?><?><?><?><?> 'menu' <?><?>
       <?><?><?><?><?><?><?><?><?><?> <?><?><?><?><?><?><?>
       <?><?><?><?><?><?><?> <?> <?><?><?><?><?> <?><?><?><?><?><?><?><?><?>
       <?><?> <?><?><?><?><?><?><?><?> <?><?><?> <?><?><?>:

       menu:
       <?><?><?>: <?><?><?><?> (string)
       <?><?><?><?><?><?><?> (<?><?><?><?><?>) <?><?> <?><?><?> <?><?>
       <?><?><?> <?><?><?><?><?><?>. <?><?><?><?><?><?><?><?> <?><?><?><?>
       <?><?><?><?><?><?><?> <?><?>:

       +--------------------------+-------------------------------------------+
       |<?><?><?><?><?> (Option)  |    <?><?><?><?><?><?><?> (Description)    |
       +--------------------------+-------------------------------------------+
       |on-click                  | <?><?><?><?><?> <?><?><?><?> <?><?>       |
       |                          | <?><?><?> <?><?><?><?><?><?>              |
       +--------------------------+-------------------------------------------+
       |on-click-release          | <?><?><?><?><?> <?><?><?> <?><?><?><?>    |
       |                          | <?><?><?><?> <?><?> <?><?><?><?>          |
       |                          | <?><?><?> <?><?><?><?><?><?>              |
       +--------------------------+-------------------------------------------+
       |on-double-click           | <?><?><?><?><?> <?><?> <?><?><?>          |
       |                          | <?><?><?><?> <?><?> <?><?><?>             |
       |                          | <?><?><?><?><?><?>                        |
       +--------------------------+-------------------------------------------+
       |on-triple-click           | <?><?><?><?><?> <?><?> <?><?><?>          |
       |                          | <?><?><?><?> <?><?> <?><?><?>             |
       |                          | <?><?><?><?><?><?>                        |
       +--------------------------+-------------------------------------------+
       |on-click-middle           | <?><?><?><?><?> <?><?><?><?> <?><?><?>    |
       |                          | <?><?><?> <?><?><?><?><?><?> <?><?>       |
       |                          | <?><?><?><?><?><?><?> <?><?> <?><?><?>    |
       |                          | <?><?><?><?>                              |
       +--------------------------+-------------------------------------------+
       |on-click-middle-release   | <?><?><?><?><?> <?><?><?> <?><?><?><?>    |
       |                          | <?><?><?><?> <?><?><?> <?><?><?><?>       |
       |                          | <?><?><?> <?><?><?><?><?><?>              |
       +--------------------------+-------------------------------------------+
       |on-double-click-middle    | <?><?><?><?><?> <?><?> <?><?><?>          |
       |                          | <?><?><?><?> <?><?><?> <?><?><?>          |
       |                          | <?><?><?><?><?><?>                        |
       +--------------------------+-------------------------------------------+
       |on-triple-click-middle    | <?><?><?><?><?> <?><?> <?><?><?>          |
       |                          | <?><?><?><?> <?><?><?> <?><?><?>          |
       |                          | <?><?><?><?><?><?>                        |
       +--------------------------+-------------------------------------------+
       |on-click-right            | <?><?><?><?><?>                           |
       |                          | <?><?><?><?><?><?><?><?><?> <?><?><?>     |
       |                          | <?><?><?><?><?><?>                        |
       +--------------------------+-------------------------------------------+
       |on-click-right-release    | <?><?><?><?><?> <?><?><?> <?><?><?><?>    |
       |                          | <?><?><?><?> <?><?><?><?> <?><?><?><?>    |
       |                          | <?><?><?> <?><?><?><?><?><?>              |
       +--------------------------+-------------------------------------------+
       |on-double-click-right     | <?><?><?><?><?> <?><?> <?><?><?>          |
       |                          | <?><?><?><?><?><?><?><?><?> <?><?><?>     |
       |                          | <?><?><?><?><?><?>                        |
       +--------------------------+-------------------------------------------+
       |on-triple-click-right     | <?><?><?><?><?> <?><?> <?><?><?>          |
       |                          | <?><?><?><?><?><?><?><?><?> <?><?><?>     |
       |                          | <?><?><?><?><?><?>                        |
       +--------------------------+-------------------------------------------+
       |on-click-backward         | <?><?><?><?><?> <?><?><?><?> <?><?><?>    |
       |                          | <?><?><?><?><?><?> <?><?> <?><?><?><?>    |
       |                          | <?><?><?> (backward) <?><?><?><?>         |
       +--------------------------+-------------------------------------------+
       |on-click-backward-release | <?><?><?><?><?> <?><?><?> <?><?><?><?>    |
       |                          | <?><?><?><?> <?><?><?> <?><?><?><?>       |
       |                          | <?><?><?> <?><?><?><?><?><?>              |
       +--------------------------+-------------------------------------------+
       |on-double-click-backward  | <?><?><?><?><?> <?><?> <?><?><?>          |
       |                          | <?><?><?><?> <?><?><?> <?><?><?><?><?><?> |
       |                          | <?><?> <?><?><?><?> <?><?><?>             |
       |                          | <?><?><?><?>                              |
       +--------------------------+-------------------------------------------+
       |on-triple-click-backward  | <?><?><?><?><?> <?><?> <?><?><?>          |
       |                          | <?><?><?><?> <?><?><?> <?><?><?><?><?><?> |
       |                          | <?><?> <?><?><?><?> <?><?><?>             |
       |                          | <?><?><?><?>                              |
       +--------------------------+-------------------------------------------+
       |on-click-forward          | <?><?><?><?><?> <?><?><?><?> <?><?><?>    |
       |                          | <?><?><?><?><?><?> <?><?> <?><?><?><?>    |
       |                          | <?><?><?> (forward) <?><?><?><?>          |
       +--------------------------+-------------------------------------------+
       |on-click-forward-release  | <?><?><?><?><?> <?><?><?> <?><?><?><?>    |
       |                          | <?><?><?><?> <?><?><?> <?><?><?><?>       |
       |                          | <?><?><?> <?><?><?><?><?><?>              |
       +--------------------------+-------------------------------------------+
       |on-double-click-forward   | <?><?><?><?><?> <?><?> <?><?><?>          |
       |                          | <?><?><?><?> <?><?><?> <?><?><?><?><?><?> |
       |                          | <?><?> <?><?><?><?> <?><?><?>             |
       |                          | <?><?><?><?>                              |
       +--------------------------+-------------------------------------------+
       |on-triple-click-forward   | <?><?><?><?><?> <?><?> <?><?><?>          |
       |                          | <?><?><?><?> <?><?><?> <?><?><?><?><?><?> |
       |                          | <?><?> <?><?><?><?> <?><?><?>             |
       |                          | <?><?><?><?>                              |
       +--------------------------+-------------------------------------------+
       menu-file:
       <?><?><?>: <?><?><?><?> (string)
       <?><?><?><?> <?><?><?><?> <?><?><?><?><?><?><?><?><?><?><?> <?><?><?>.
       <?><?><?><?> <?><?><?><?><?> <?><?> <?><?><?>
           GtkMenu <?><?> <?><?><?><?><?> menu <?><?><?><?> <?><?><?><?><?>
           <?><?><?><?>.

       menu-actions:
       <?><?><?>: <?><?><?><?><?> (array)
       <?><?><?><?><?><?> <?><?><?><?><?><?> <?><?> <?><?><?><?><?><?><?><?>
       <?><?><?>. <?><?><?><?><?><?><?><?><?> <?><?> <?><?> <?><?> <?><?><?>
           <?><?><?><?><?><?> <?><?><?><?> <?><?> <?><?><?><?><?> <?><?> id
           <?><?> 'menu-file' <?><?><?><?> <?><?><?><?><?> <?><?><?><?><?>
           <?><?> <?><?><?><?><?> <?><?> <?><?><?><?><?> <?><?><?><?><?><?>
           <?><?><?>.

<?><?><?><?> <?><?><?> (MENU-FILE)
       <?><?><?><?> menu-file <?><?> <?><?><?><?> `.xml` <?><?><?> <?><?>
       <?><?> GtkBuilder <?><?> <?><?><?><?><?> <?><?><?><?><?><?>.
       <?><?><?><?><?><?><?> <?><?><?><?><?> <?><?> <?><?> <?><?>
       <?><?><?><?><?><?><?> <?><?> <?><?><?><?><?> <?><?><?><?>:
       https://docs.gtk.org/gtk4/class.Builder.html

       <?><?> <?><?><?><?><?><?> <?><?><?><?> <?><?><?><?><?> <?><?> <?><?><?>
       GtkMenu <?><?> <?><?><?><?><?> "menu" <?><?><?><?> <?><?><?><?><?>
       <?><?><?><?>. <?><?> <?><?> <?><?> <?><?><?><?><?><?> <?><?><?><?><?>
       <?><?> menu-actions <?><?> <?><?><?><?> <?><?><?><?><?> (id)
       <?><?><?><?><?> <?><?> <?><?><?><?><?> <?><?><?><?><?> <?><?>
       <?><?><?><?> menu-file <?><?><?><?> <?><?><?><?><?><?><?>.

<?><?><?><?> (EXAMPLE)
       <?><?><?><?><?><?><?><?> <?><?><?><?><?><?> (Module config):
           "custom/power": {
                "format" : "<?> ",
                "tooltip": false,
                "menu": "on-click",
                "menu-file": "~/.config/waybar/power_menu.xml",
                "menu-actions": {
                     "shutdown": "shutdown",
                     "reboot": "reboot",
                     "suspend": "systemctl suspend",
                     "hibernate": "systemctl hibernate",
                },
           },

       ~/.config/waybar/power_menu.xml :
           <?xml version="1.0" encoding="UTF-8"?>
           <interface>
             <object class="GtkMenu" id="menu">
                     <child>
                          <object class="GtkMenuItem" id="suspend">
                               <property name="label">Suspend</property>
                          </object>
                     </child>
                     <child>
                          <object class="GtkMenuItem" id="hibernate">
                               <property name="label">Hibernate</property>
                          </object>
                     </child>
               <child>
                          <object class="GtkMenuItem" id="shutdown">
                               <property name="label">Shutdown</property>
                          </object>
               </child>
               <child>
                 <object class="GtkSeparatorMenuItem" id="delimiter1"/>
               </child>
               <child>
                          <object class="GtkMenuItem" id="reboot">
                               <property name="label">Reboot</property>
                          </object>
               </child>
             </object>
           </interface>

<?><?><?><?><?><?><?><?><?><?> <?><?> <?><?><?><?><?> (STYLING MENUS)
       o   menu <?><?><?><?><?><?> <?><?><?><?> <?><?><?>

       o   menuitem <?><?><?><?><?><?> <?><?><?><?> <?><?><?><?><?><?><?><?>
           <?><?><?><?> <?><?><?>

<?><?><?><?> (EXAMPLE)
           menu {
                border-radius: 15px;
                background: #161320;
                color: #B5E8E0;
           }
           menuitem {
                border-radius: 15px;
           }

                                  2026-08-31                    waybar-menu(5)