Skip to main content

A dmenu wrapper script

Project description

[![Latest Version](]( [![Downloads](]( [![Supported Python versions](]( [![Development Status](]( [![License](](


A [dmenu]( wrapper script that:

  1. Lets you define menu items as key: value pairs in a [YAML]( file, like:

    Firefox: firefox Terminal: gnome-terminal Nautilus: nautilus –no-desktop –new-window

    The keys are what will be shown in dmenu. The values are the commands that will be run when you select the keys from dmenu. Unlike the usual way of using dmenu, the items shown in the menu don’t have to be the same as the commands executed when they’re selected.

  2. Sorts the items in dmenu most-recently-used first (not yet implemented!)


First install dmenu, then:

pip install itemizer



It accepts all the same command-line arguments as dmenu:

itemizer_run -f -i -nb “#222222” -nf “#bbbbbb” -sb “#005577” -sf “#eeeeee” -fn “--terminus-medium-r---16-------

To customize the menu copy the [default itemizer.yaml file](itemizer/itemizer.yaml) to ~/.itemizer.yaml and edit it.

Itemizer is composed of two subcommands:

  1. itemizer list prints a newline-separated list of all the keys from your items file to stdout, suitable for piping into dmenu.
  2. itemizer show reads a key from stdin, looks up its value in your items file, and prints it to stdout. Pipe the output from dmenu into itemizer show, then pipe the ouput from itemizer show to sh.

Run itemizer -h for complete documentation of the options and subcommands.

[itemizer_run](bin/itemizer_run) is a shell script that ties itemizer list, dmenu, itemizer show and sh together, and that passes any command-line arguments that you pass it on to dmenu.

Project details

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

itemizer-1.1.2.tar.gz (4.4 kB view hashes)

Uploaded source

Supported by

AWS AWS Cloud computing Datadog Datadog Monitoring Facebook / Instagram Facebook / Instagram PSF Sponsor Fastly Fastly CDN Google Google Object Storage and Download Analytics Huawei Huawei PSF Sponsor Microsoft Microsoft PSF Sponsor NVIDIA NVIDIA PSF Sponsor Pingdom Pingdom Monitoring Salesforce Salesforce PSF Sponsor Sentry Sentry Error logging StatusPage StatusPage Status page