skip to navigation
skip to content

i3menu 3.0

a set of menus based on Rofi or dmenu to interact with i3wm


i3menu provides a useful set of menus based on Rofi and dmenu that will help you manage you i3wm.


i3menu requires either Rofi or dmenu to work.

dmenu is pretty easy to install:

sudo apt-get install suckless-tools

But Rofi is way much nicer. To install it follow its installation guide.


i3menu can be installed directly from pypi like this:

$ pip install i3menu

Or from source code like this:

$ git clone
$ cd i3menu
$ make install

Whatever installation method you choosed, you will end up having a script in your local bin path, ~/.local/bin. If your $PATH is set up correctly, now you should be able to run i3menu:

$ i3menu -h

If the command is not found, please check your $PATH to be sure to have your local bin path:

$ PATH=$PATH:~/.local/bin

To make this change permanent, you can add to your .profile file this:

if [ -d "$HOME/.local/bin" ] ; then

This change will be permanent at your next login.


For a complete list of the command line parameters you can check the help:

$ i3menu --help

Any available menu can be run like this:

$ i3menu window_actions

I3WM config

You can add i3menu to your i3 config. For example:

bindsym $mod+w exec --no-startup-id i3menu goto_workspace


bindsym $mod+w exec --no-startup-id i3menu -m go_to_workspace

For a more complete set of examples, please take a look at my i3wm config



Disclaimer: i3menu is a third party script and in no way affiliated with the i3 project, the dmenu project or the rofi project.


3.0 (2016-03-02)

  • reboot, better code, better tests, better coverage [giacomos]

2.1 (2016-03-02)

  • fix targets in windows and workspace actions [giacomos]
  • fix menu ordering and add the entries’ numbers [giacomos]
  • add tests and tests coverage [giacomos]

2.0.5 (2016-02-27)

  • move script to bin dir and source code under lib [giacomos]

2.0.4 (2016-02-27)

  • move from console_scripts to script, -> i3menu, improve README [giacomos]

2.0.3 (2016-02-26)

  • fix a typo that prevented to use the package without rofi installed [giacomos]

2.0.2 (2016-02-26)

  • fix an error with missing history by adding a [giacomos]

2.0.1 (2016-02-26)

  • nothis to see here [giacomos]

2.0 (2016-02-26)

  • major code restyle
  • add all the i3-msg commands
  • major improvement of the command line interface
  • use both rofi and dmenu as menu providers
  • name changed: i3-rofi -> i3menu [giacomos]

1.0 (2016-02-18)

  • Initial release
  • included menus are: go_to_workspace, move_window_to_workspace, move_window_to_this_workspace, move_workspace_to_output, rename_workspace, window_actions, workspace_actions [giacomos]
File Type Py Version Uploaded on Size
i3menu-3.0-py2.py3-none-any.whl (md5) Python Wheel 2.7 2016-03-04 15KB
i3menu-3.0.tar.gz (md5) Source 2016-03-04 15KB