Metadata-Version: 2.1
Name: dmenu-hotkeys
Version: 1.1.0
Summary: Your hotkeys for various apps in 'dmenu' style.
Home-page: https://github.com/maledorak/dmenu_hotkeys
Author: Mariusz Korzekwa
Author-email: maledorak@gmail.com
License: MIT license
Keywords: dmenu_hotkeys
Platform: UNKNOWN
Classifier: Development Status :: 2 - Pre-Alpha
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: MIT License
Classifier: Natural Language :: English
Classifier: Programming Language :: Python :: 2
Classifier: Programming Language :: Python :: 2.7
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.4
Classifier: Programming Language :: Python :: 3.5
Classifier: Programming Language :: Python :: 3.6
Classifier: Programming Language :: Python :: 3.7
Requires-Python: >=2.7,!=3.0.*,!=3.1.*,!=3.2.*,!=3.3.*
Requires-Dist: Click (>=7.0)
Requires-Dist: importlib-resources (>=1.0.0)
Requires-Dist: pathlib2

dmenu-hotkeys
=============
[![pypi](https://img.shields.io/pypi/v/dmenu_hotkeys.svg)](https://pypi.python.org/pypi/dmenu_hotkeys)
[![travis](https://img.shields.io/travis/maledorak/dmenu-hotkeys.svg)](https://travis-ci.org/maledorak/dmenu-hotkeys)
[![codecov](https://codecov.io/gh/maledorak/dmenu-hotkeys/branch/master/graph/badge.svg)](https://codecov.io/gh/maledorak/dmenu-hotkeys)
[![docs](https://readthedocs.org/projects/dmenu-hotkeys/badge/?version=latest)](https://dmenu-hotkeys.readthedocs.io/en/latest/?badge=latest)

Your hotkeys for various apps in 'dmenu' style.

Features
--------
This app allows you to prepare cheat sheet of hotkeys from your apps in simple menu with search.

![screenshot](docs/shot.png)

Supported
---------

### Menus
* [dmenu](https://tools.suckless.org/dmenu/)
* [rofi](https://github.com/davatorium/rofi)

### Apps
* [i3](https://i3wm.org/)
* [openbox](http://openbox.org/wiki/Main_Page)


Requirements
------------
This app needs below apps as a GUI, so install one of these first.
* dmenu
* rofi

Install
-------

### From pip
This app works on Python 2.7, 3.4, 3.5, 3.6, 3.7, so the best choice is installation using pip

```
pip install --user dmenu-hotkeys
```

then you could run it by typing in console

```
dmenu_hotkeys
```

### From git repo
Clone repository
```
git clone git@github.com:maledorak/dmenu-hotkeys.git .
```

and run script in bin dir like this
```
./dmenu-hotkeys/bin/dmenu_hotkeys
```



How to use
----------

### Run menu with hotkeys
1. Add the following comment line before hotkey line which you want to use in your app config file.

    eg:

    * i3: `# %%hotkey: Some description of the following hotkey %%`
    * openbox: `<-- %%hotkey: Some description of the following hotkey %% -->`

    Notice: For full configuration file examples check [test/fixtures](./tests/fixtures) directory

2. Run the dmenu-hotkeys
    ```
    dmenu_hotkeys run --menu [dmenu|rofi] --app [i3|openbox]
    ```

3. Check help if you want to know more
    ```
    dmenu_hotkeys run --help
    ```

### Override dmenu-hotkeys configuration file
If you want to change default configuration paths for apps (i3, openbox, etc) 
you should override dmenu-hotkeys config file.

```
dmenu_hotkeys copy-config
```

The default path for the overridden configuration file is
```
$HOME/.config/dmenu_hotkeys/config.cfg
```

You could change it
```
dmenu_hotkeys copy-config --dest some/path/config.cfg
```


But since then you always should run dmenu-hotkeys with this new path

```
dmenu_hotkeys run --menu [dmenu|rofi] --app [i3|openbox] --config-path some/path/config.cfg
```


History
=======

Unreleased
----------
* Added dots enabling in config.cfg
* Added coverage
* Added config as a singleton.
* Added conf path passing from console argument.
* Added testing conf and application fixtures.
* Added copy-config command to copying config files to the user home dir.
* Added menu and apps installation validation.

1.0.0 (2019-03-09)
------------------

* First release on PyPI.


