Metadata-Version: 2.0
Name: i3menu
Version: 2.1
Summary: a set of menus based on Rofi or dmenu to interact with i3wm
Home-page: https://github.com/giacomos/i3menu
Author: Giacomo Spettoli
Author-email: giacomo.spettoli@gmail.com
License: GPLv3
Keywords: i3 i3wm rofi dmenu
Platform: UNKNOWN
Classifier: Development Status :: 4 - Beta
Classifier: License :: OSI Approved :: GNU General Public License v3 or later (GPLv3+)
Classifier: Operating System :: Unix
Classifier: Topic :: Desktop Environment :: Window Managers
Classifier: Programming Language :: Python
Classifier: Programming Language :: Python :: 2.7
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.3
Classifier: Programming Language :: Python :: 3.4
Classifier: Programming Language :: Python :: 3.5
Requires-Dist: argparse
Requires-Dist: i3ipc
Requires-Dist: setuptools

.. image:: https://travis-ci.org/giacomos/i3menu.svg?branch=master
    :target: https://travis-ci.org/giacomos/i3menu
    :alt: TravisCI - i3menu

.. image:: https://coveralls.io/repos/github/giacomos/i3menu/badge.svg?branch=master
    :target: https://coveralls.io/github/giacomos/i3menu?branch=master


.. image:: https://img.shields.io/pypi/v/i3menu.svg
   :target: https://pypi.python.org/pypi/i3menu

Introduction
============

**i3menu** provides a useful set of menus based on `Rofi
<https://davedavenport.github.io/rofi>`_  and `dmenu
<http://tools.suckless.org/dmenu/>`_ that will help you manage you `i3wm
<http://i3wm.org>`_.

Requirements
============

`i3menu` requires either `Rofi
<https://davedavenport.github.io/rofi>`_  or `dmenu
<http://tools.suckless.org/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
<https://davedavenport.github.io/rofi/p08-INSTALL.html>`_.

Installation
============
`i3menu` can be installed directly from `pypi
<https://pypi.python.org/pypi/i3menu>`_ 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
<https://github.com/giacomos/i3wm-config>`_

Credits
=======

* partially inspired by `quickswitch-i3 <https://pypi.python.org/pypi/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]


