Skip to content

goldentree1/gnome-command-menu-2

Repository files navigation

GNOME Command Menu 2 Extension

A GNOME Shell extension to create highly-customizable menus in the top bar. Quickly access your apps, scripts, files and more.

Install on GNOME Shell Extensions

Start with one of our templates - or build your own menu!

Command Menu Screenshot

This project is forked from Command Menu by arunk140 and includes changes I made to keep it working in recent GNOME versions. It also includes a BUNCH of new features:

  • Menu editor GUI
  • Menu templates
  • Multiple menus - create as many as you like!
  • Labels
  • Change menu position (left, center, or right)
  • Change menu index (e.g., place a menu on left or right of Activities button)
  • Submenu icons
  • Icons can be loaded from a filepath

Installation

Install from GNOME Extensions website (recommended):

  1. Install with GNOME Shell Extensions
  2. Use Extension Manager to enable it and create your menus!

Manual install

  1. Install the extension:

    git clone https://github.com/goldentree1/gnome-command-menu-2
    cd gnome-command-menu-2
    bash install.sh 

    You will need to logout and login again so the extension is recognised!

  2. Enable it:

    gnome-extensions enable command-menu2@goldentree1.github.com

    Or alternatively, use Extension Manager to enable it and access preferences.

Usage & Configuration

This extension reads the configuration stored in ~/.commands.json to generate your menus. You can use the preferences app to create and customize your menus - or manually edit the configuration yourself.

Step-by-step configuration guide:

  1. Open preferences for this extension, and click 'Edit' on the menu you want to configure: Command Menu Screenshot

  2. Click 'Add Item' to add an item to the menu. You can also click the arrow button for more options (e.g., to add a label or a separator): Command Menu Screenshot

  3. Click the arrow on the right side of the new menu item to see configuration options: Command Menu Screenshot

    • Title

      Give your menu item a custom title
    • Icon

      Icons can either be a system-icon name (e.g., "folder"), or a filepath to an icon (e.g., "~/Downloads/my-icon.jpg"). We have since added a basic 'Icons...' button to help you out, but also check out this list of system icon names you can use!
    • Command

      The command that is run when the menu item is clicked on (e.g., the command 'firefox' will start the Firefox application). You should be able to find common commands like this on Google if you are inexperienced. Our templates also have some examples. You can learn more about commands and scripting here.
  4. Click 'Apply Changes' to see your changes! Command Menu Screenshot

Contributions

I would love to hear about any bugs, suggested changes or feature ideas you may have! Please leave an issue or pull request on Github.

About

A GNOME Shell Extension to manage shortcuts in the top bar (forked from Command Menu by arunk140).

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Contributors 2

  •  
  •