Skip to main content

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

Project description

TravisCI - i3menu https://coveralls.io/repos/github/giacomos/i3menu/badge.svg?branch=master https://img.shields.io/pypi/v/i3menu.svg

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

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

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, 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.

Source Distribution

i3menu-3.0.tar.gz (16.1 kB view hashes)

Uploaded Source

Built Distribution

i3menu-3.0-py2.py3-none-any.whl (15.6 kB view hashes)

Uploaded Python 2 Python 3

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page