Skip to main content

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.

Release files for dmenu-hotkeys 1.1.0

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for dmenu-hotkeys 1.1.0
File Size Uploaded
dmenu_hotkeys-1.1.0.tar.gz 147.5 kB Details

Built distribution (wheel)

Table of built distributions (wheels) for dmenu-hotkeys 1.1.0
File Interpreter ABI Platform
dmenu_hotkeys-1.1.0-py2.py3-none-any.whl Python 2, Python 3 none any Details

Total release size: 157.4 kB

Release files / dmenu_hotkeys-1.1.0.tar.gz

Download URL dmenu_hotkeys-1.1.0.tar.gz
Size 147.5 kB
Tags Source
SHA-256 checksum
How to use checksums
02b6e7a145efd593b68ee21080992bc02245c7974644b7a48d5ac5cb14f9201d
BLAKE2b-256 checksum
How to use checksums
1e0b07366d07bd6539fb5b17031bae5465b1ba41ddd94124c5b560657238d468
Upload date
Uploaded using Trusted Publishing?
What is 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

Release files / dmenu_hotkeys-1.1.0-py2.py3-none-any.whl

Download URL dmenu_hotkeys-1.1.0-py2.py3-none-any.whl
Size 10.0 kB
Tags Python 2 Python 3
SHA-256 checksum
How to use checksums
411ac36128222587db3ce457f7bbd3fdf7420bb7e1030b6024a7c505ab4b95f5
BLAKE2b-256 checksum
How to use checksums
6bed448c7925b16592e8d564681f71178d159d180f712e2f33c456971e3ef161
Upload date
Uploaded using Trusted Publishing?
What is 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

Release history Release notifications | RSS feed

This release

1.1.0 This release

2 release files

1.0.2

2 release files

1.0.1

2 release files

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page