Skip to main content

Your hotkeys for various apps in 'dmenu' style.

Project description

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

  1. Run the dmenu-hotkeys

    ` dmenu_hotkeys run --menu [dmenu|rofi] --app [i3|openbox] `

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

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

dmenu_hotkeys-1.1.0.tar.gz (147.5 kB view details)

Uploaded Source

Built Distribution

dmenu_hotkeys-1.1.0-py2.py3-none-any.whl (10.0 kB view details)

Uploaded Python 2 Python 3

File details

Details for the file dmenu_hotkeys-1.1.0.tar.gz.

File metadata

  • Download URL: dmenu_hotkeys-1.1.0.tar.gz
  • Upload date:
  • Size: 147.5 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/1.12.1 pkginfo/1.5.0.1 requests/2.21.0 setuptools/40.8.0 requests-toolbelt/0.9.1 tqdm/4.31.1 CPython/3.7.3

File hashes

Hashes for dmenu_hotkeys-1.1.0.tar.gz
Algorithm Hash digest
SHA256 02b6e7a145efd593b68ee21080992bc02245c7974644b7a48d5ac5cb14f9201d
MD5 cf724ebe39d92600d3deff627a80370f
BLAKE2b-256 1e0b07366d07bd6539fb5b17031bae5465b1ba41ddd94124c5b560657238d468

See more details on using hashes here.

File details

Details for the file dmenu_hotkeys-1.1.0-py2.py3-none-any.whl.

File metadata

  • Download URL: dmenu_hotkeys-1.1.0-py2.py3-none-any.whl
  • Upload date:
  • Size: 10.0 kB
  • Tags: Python 2, Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/1.12.1 pkginfo/1.5.0.1 requests/2.21.0 setuptools/40.8.0 requests-toolbelt/0.9.1 tqdm/4.31.1 CPython/3.7.3

File hashes

Hashes for dmenu_hotkeys-1.1.0-py2.py3-none-any.whl
Algorithm Hash digest
SHA256 411ac36128222587db3ce457f7bbd3fdf7420bb7e1030b6024a7c505ab4b95f5
MD5 6fc73fd661195b7d35202a6584063e0d
BLAKE2b-256 6bed448c7925b16592e8d564681f71178d159d180f712e2f33c456971e3ef161

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