Skip to content

andreabenini/gnome-plugin.custom-menu-panel

Repository files navigation

Gnome Custom Menu Panel

Custom menu on Gnome Top Bar with your favorite program shortcuts.

Screenshot Preview another Preview

Usage:

  • Edit .entries.json to match your needs
  • Copy .entries.json file to $HOME/

If you edit .entries.json while running gnome please ensure to reload Gnome Window Manager (Alt+F2, "r")
Tested with: Arch Linux, X11, Gnome v42.0.0.
Widgets manual below describe available options, in the examples directory you can see some tests you can pick for your setup


Widgets Manual

Here are common widgets and entities you can use with this plugin:

- Launcher

Create a new entry and put it in the menu

    {
      "type": "launcher",
      "title": "Item Name on Menu",
      "command": "/your/command/to/execute --with-parameters"
    },

- Separator

Place a menu separator (<hr>)

    {
      "type": "separator"
    },

- SubMenu

Create a submenu inside current menu, items inside the submenu are placed inside entries and they can be of any type (launcher, separator, submenu, ...)

    {
        "type": "submenu",
        "title": "Menu Name",
        "entries": [
            //... Place your entries here ...//
        ]
    },

- Toggler

Create a toggle item on menu, it has a detector and ON|OFF commands. Command detector can be activated|deactivated by a 0 (success) return error level and later detected with a plain JavaScript eval. See graphical result on above screenshots

    {
      "type": "toggler",
      "title":       "Widget Title",
      "command_on":  "/command/when/turned/on",
      "command_off": "/command/when/turned/off",
      "detector":    "/command/detector > /dev/null && echo yes"
    },

About

Custom menu on Gnome Top Bar with your favorite program shortcuts.

Topics

Resources

License

Code of conduct

Stars

Watchers

Forks

Releases

No releases published

Sponsor this project

Packages

No packages published