PupMenu-6.0

Recommended OS

Puppy Linux with gtkdialog4 (0.7.21 or greater)

Purpose and Base Features

PupMenu is a comprehensive menu-item editor and program launcher based on standard .desktop files of the Linux file system (usr/share/applications/*.desktop and usr/local/share/applications/*.desktop).

The applications database and icon cache are set automatically on first run of PupMenu, and thereafter on demand after applications are installed or uninstalled on your system. Use the refresh button in the right-upper corner of the graphical interface to update the applications database. Please note, the update is relatively quick on modern computers but requires several seconds on older systems.

The graphical interface of Pupmenu employs a traditional menu hierarchy, and the program categories are familiar to most users of Puppy Linux. Applications are launched quickly from the user interface and the corresponding .desktop files can be edited easily, or simply viewed for more information. The applications are viewable by name and content in a conventional dual-pane interface (full-view), or by name only in the optional single-pane interfaces (mid-view, mini-view and control panel). All views are readily available through the toggle button in the upper-right corner of the user interface. Selecting menu items with the mouse or keyboard in the full-view interface enables serial viewing of all .desktop files in the information window.

A convenient search option (application finder) facilitates prompt access to all applications, particularly the obscure or infrequently used items. The standard search mode parses the names of menu items (.desktop files) alphabetically. The optional enhanced search mode parses all character matches in the names of menu items and evaluates information inside the menu files, which provides both specific and nonspecific (fuzzy) matches. You can select the search mode in Preferences, or use the toggle button of the main user interface.

The search option also features a quick-launch function which emulates Run-dialog programs such as gExec and gRun. Simply enter (part of) the executable name of an application in the search box of PupMenu, and press the Enter key to launch. As you type characters in the search field, the PupMenu application and information windows change dynamically to match the current search parameters. At any time, you can press the Enter key to launch the menu item which is currently first in the list of applications. The keyboard quick-launch option is appropriate for those who are familiar with the names of applications currently installed. Alternatively, you can launch an application by selecting the launch button, or by a double mouse-click of the program name. For all launch modes, the full-view, mid-view and control-panel interfaces provide a checkbox which quickly toggles the 'close after launch' option, or you can set this feature in Preferences when using the mini-view graphical interface.

PupMenu includes an optional 'Favorites' menu category in the main user interface, and automatically adds this category to the standard Puppy XDG menu when you first launch the PupMenuEdit module. For your convenience, quick access to the Favorites management module of PupMenuEdit is provided in both PupMenu and the Puppy XDG menu, or you can simply right-click any menu item displayed in PupMenu. The Favorites option is also available as an independent launcher for the desktop or panel (see below).

Frequently used applications are conveniently retrieved from the launch history (blue-folder icon) and are quickly relaunched by a single mouse-click of the program name, or by keyboard navigation and pressing the Enter key. The launch history is self-sustaining and PupMenu automatically removes duplicate and orphan menu items from the list of available applications.

Quick access to the Linux directory structure is facilitated by the bookmark option (book icon) which opens the selected directory in supported file managers (ROX-Filer, Thunar, PCManFM, SpaceFM or Xfe). This option also supports individual files and browser URLs, and the supplemental bookmark manager provides options to move, reset, delete or append bookmarks. GTK and ROX bookmarks are easily (and optionally) appended to your personal bookmarks, but duplicate bookmarks are not appended. Additionally, this module screens GTK and ROX bookmarks and automatically excludes files that are no longer present on your drive (recently deleted), but are still listed in the corresponding external bookmark source.

The 'recent files' option (file icon) parses recently-used.xbel and provides a launchable list of files recently accessed by GTK applications through the Open/Save menu dialogs. This option also screens the list and automatically excludes files that are no longer present on your drive, but are still listed in recently-used.xbel. Optionally, you can go to the 'Manage' button and select the default application to open the selected file. Typically, this default action is the original program used to open the file, as defined in recently-used.xbel. However, if desired, you can set the xdg-open tool as the default action based on file mime-types. Either way, a simple left-mouse-click (or pressing the keyboard 'Enter' key) will open the selected file with your preferred default action. Alternatively, you can right-mouse-click the selected file to override the default action, and specifically open/launch with the xdg-open tool. Caveat: support for the right-mouse-click action requires gtkdialog4 >= r333.

The 'Favorites', 'Bookmarks' and 'Recent Files' options are integral to the PupMenu interface, but each may be accessed independently as optional launchers for the desktop or panel. For desktop launchers, go to /usr/share/applications and add the corresponding .desktop file(s) to the Puppy desktop (drag-and-drop in Rox-Filer). For panel launchers, simply add the following executables to the panel, and assign the corresponding launcher icons:

  1. Favorites
    Executable: /usr/bin/pfavorites (or) /usr/share/applications/pFavorites.desktop
    Icon: /usr/share/pixmaps/pfavorites.svg
  2. Bookmarks
    Executable: /usr/bin/pbookmarks (or) /usr/share/applications/pBookmarks.desktop
    Icon: /usr/share/pixmaps/pbookmarks.svg
  3. Recent-Files
    Executable: /usr/bin/precent-files (or) /usr/share/applications/pRecent-Files.desktop
    Icon: /usr/share/pixmaps/precent.svg

Common functions that one may use routinely are available in the lower panel tray, including the following (if installed): control panel (PupControl), file manager, file finder, drive mounter, command-line launcher (pRun), task manager, terminal emulator, Wine menu for Windows applications, and shutdown manager (PupShutdown).

PupMenu provides convenient options for creating, editing and deleting menu files. The PupMenuEdit module facilitates changing individual elements of existing menu files, and the companion PupMenuMaker is an equally intuitive utility for the creation of new menu items. PupMenuEdit and PupMenuMaker support standard (legacy) menu categories, but also provide full support for the enhanced menu hierarchy (Puppy-specific categories and subcategories) introduced in the Woof specifications of 30 Nov 2012.

The PupMenuEdit module provides the following options for managing and editing the standard XDG menu of Puppy Linux.

  1. File tab: Menu file manager with options to create (PupMenuMaker), edit, backup and delete menu (.desktop) files
  2. Edit tab: Modify .desktop file options which control the filename, command, icon, menu name, tooltip, mimetype, category and visibility of applications in the standard XDG menu
  3. View tab: Display contents of .desktop files
  4. Undo tab: Restore .desktop files to the original unedited state
  5. Desktop tab: Copy menu applications to the desktop
  6. Favorites tab: Add/Remove menu applications in the Favorites category of the standard XDG menu
  7. Show-Hide tab: Show (enable) or hide (disable) applications in the standard XDG menu
  8. Settings tab: View/Edit default applications in /usr/local/bin and MIME-types in /root/Choices/MIME-types, and control icon size in the menu of modern JWM

The Preferences module provides the following options for enhancing the PupMenu interface.

    Appearance

  1. Show Alphabetical arrangement of menu categories in PupMenu
  2. Show/Hide the Favorites menu category in PupMenu
  3. Open PupMenu in the Favorites menu category, else default to the All category
  4. Show/Hide the History menu category in PupMenu (recently-launched applications)
  5. Show/Hide the Development menu category in PupMenu
  6. Show/Hide the Education menu category in PupMenu
  7. Show/Hide the Fun menu category in PupMenu
  8. Show/Hide the Wine menu category in PupMenu
  9. Show legacy menu categories in PupMenu such as Business, Document and Personal
  10. Show/Hide the border of small buttons
  11. Show/Hide the PupMenu banner text
  12. Show/Hide the splash dialog
  13. Behavior

  14. Open PupMenu at center of screen
  15. Open PupMenu at upper-left corner of screen
  16. Open PupMenu under the mouse cursor
  17. Select optional closing of the main PupMenu interface when launching applications
  18. Enable hover selection of menu categories (first pane of the main GUI). This option does not apply to menu applications in the second pane.
  19. Include hidden menu items in the applications window of PupMenu. This option does not impact items hidden in the standard Puppy menu.
  20. Set optional auto-updating of the recent launch history of PupMenu
  21. Set legacy or enhanced menu categories for PupMenuEdit and PupMenuMaker
  22. Set standard or enhanced search options
  23. Position the menu categories left or right of the applications window
  24. Position the application search box above or below the applications window
  25. Show application descriptions including the selected application's menu name, generic name or comment from the corresponding .desktop file.
  26. History

  27. Adjust the maximum number of items in the launch history
  28. Edit the current launch history
  29. Delete the current launch history and start a new list
  30. Interface

  31. Adjust the font size of the PupMenu interface to match user preference
  32. Adjust the height of the PupMenu interface to match user preference
  33. Adjust the width of the PupMenu interface to accomodate long text strings
  34. Tray

  35. Enable/Disable the accessory utility tray
  36. Select the following default utilities for the PupMenu accessory tray: control center, file manager, file finder, system information utility, run-dialog utility, task manager and terminal emulator

Program access is by Puppy Menu->Utility->PupMenu, or by the default Ctrl+Shift+M keyboard shortcut, which is configured for IceWm, JWM, Openbox, Fluxbox, LXDE and LXPanel. Please go to Preferences and select the Hotkey option.

Availability

The current version of PupMenu is available here.

License

GNU GPLv3, Copyright 2012-2017, Roger D. Grider