a set of menus based on Rofi or dmenu to interact with i3wm
Project description
Introduction
i3menu provides a useful set of menus based on Rofi and dmenu that will help you manage you i3wm.
Requirements
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.
Installation
i3menu can be installed directly from pypi like this:
$ pip install i3menu
Or from source code like this:
$ git clone https://github.com/giacomos/i3menu.git $ 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 PATH="$PATH:$HOME/.local/bin" fi
This change will be permanent at your next login.
Usage
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
or:
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
Credits
partially inspired by quickswitch-i3
License
Disclaimer: i3menu is a third party script and in no way affiliated with the i3 project, the dmenu project or the rofi project.
Changelog
2.0.6 (unreleased)
fix targets in windows and workspace actions [giacomos]
fix menu ordering and add the entries’ numbers [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, cli.py -> 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 MANIFEST.in [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]
Project details
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.