Skip to main content
This is a pre-production deployment of Warehouse. Changes made here affect the production instance of PyPI (pypi.python.org).
Help us improve Python packaging - Donate today!

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

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]
Release History

Release History

This version
History Node

3.0

History Node

2.1

History Node

2.0.5

History Node

2.0.4

History Node

2.0.3

History Node

2.0.2

History Node

2.0.1

History Node

2.0

Download Files

Download Files

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

File Name & Checksum SHA256 Checksum Help Version File Type Upload Date
i3menu-3.0-py2.py3-none-any.whl (15.6 kB) Copy SHA256 Checksum SHA256 2.7 Wheel Mar 4, 2016
i3menu-3.0.tar.gz (16.1 kB) Copy SHA256 Checksum SHA256 Source Mar 4, 2016

Supported By

WebFaction WebFaction Technical Writing Elastic Elastic Search Pingdom Pingdom Monitoring Dyn Dyn DNS Sentry Sentry Error Logging CloudAMQP CloudAMQP RabbitMQ Heroku Heroku PaaS Kabu Creative Kabu Creative UX & Design Fastly Fastly CDN DigiCert DigiCert EV Certificate Rackspace Rackspace Cloud Servers DreamHost DreamHost Log Hosting