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

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.

Source Distribution

i3menu-2.0.5.tar.gz (10.9 kB view details)

Uploaded Source

File details

Details for the file i3menu-2.0.5.tar.gz.

File metadata

  • Download URL: i3menu-2.0.5.tar.gz
  • Upload date:
  • Size: 10.9 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No

File hashes

Hashes for i3menu-2.0.5.tar.gz
Algorithm Hash digest
SHA256 2577982ee7e1fbd24ee86593b5492f4e854b4164b4912b639ee05904511c0e50
MD5 9165d5c0df5f77eacf7e43dd185e70e5
BLAKE2b-256 85f91c51d595ec13092f0273f81f7856a207e22e4f2192a571cd69ad96868065

See more details on using hashes here.

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