https://github.com/xlucn/xdg-xmenu

Minimal app menu with xmenu
https://github.com/xlucn/xdg-xmenu

freedesktop icons menu xdg xdg-xmenu xmenu

Last synced: about 2 months ago
JSON representation

Minimal app menu with xmenu

• Host: GitHub
• URL: https://github.com/xlucn/xdg-xmenu
• Owner: xlucn
• License: mit
• Created: 2020-08-04T09:48:17.000Z (about 4 years ago)
• Default Branch: c_version
• Last Pushed: 2023-11-02T15:16:33.000Z (11 months ago)
• Last Synced: 2024-04-10T10:27:11.317Z (5 months ago)
• Topics: freedesktop, icons, menu, xdg, xdg-xmenu, xmenu
• Language: C
• Homepage:
• Size: 497 KB
• Stars: 33
• Watchers: 5
• Forks: 2
• Open Issues: 0
• Metadata Files:
  • Readme: README.md
  • Changelog: CHANGELOG
  • License: LICENSE

Awesome Lists containing this project

README

        
# xdg-xmenu

![](./xdg-xmenu.png)

It's a small program to show a apps menu with [xmenu](https://github.com/phillbush/xmenu). The current branch is a C rewrite of previous shell and python version of `xdg-xmenu`. This C version can launch xmenu directly, due to a faster execution time.

For the legacy shell and python versions, see corresponding branches of this git repository.

## Requirements

- [libinih](https://github.com/benhoyt/inih), or called 'inih', to parse the desktop entry files.

  [Available](https://repology.org/project/inih/versions) in most major distros.

## Usage

```

xdg-xmenu [-dGhIn] [-b ICON] [-i THEME] [-s SIZE] [-S SCALE] [-t TERMINAL]

          [-x CMD] [-- ]

A simple app menu with xmenu.

Options:

  -h          Show this help message and exit

  -b ICON     Fallback icon name, default is application-x-executable

  -d          Dump generated menu, do not run xmenu

  -G          Do not show generic name of the app

  -i THEME    Icon theme for app icons. Default to gtk3 settings

  -I          Disable icon in xmenu

  -n          Do not run app, output to stdout

  -s SIZE     Icon size for app icons

  -S SCALE    Icon scale factor, useful in HiDPI screens

  -t TERMINAL Terminal emulator to use, default is xterm

  -x CMD      Xmenu command to use, default is xmenu

Note:

  Options after `--' are passed to xmenu (or CMD)

```

## Notes

**Important:** Svg icons are supported since Imlib2 1.8.0. Thus, `xdg-xmenu` assumes that you have installed Imlib2 of at least that version. As a result, unlike the shell version, the svg icons are not converted to png anymore. If you don't have the required version of Imlib2, use the shell version instead.