https://github.com/zhaocai/alfred2-keylue-workflow

Keylue (Key Clue): Alfred 2 Workflow for Menu Bar and Keyboard Maestro Hot Key Search
https://github.com/zhaocai/alfred2-keylue-workflow

Last synced: 3 months ago
JSON representation

Keylue (Key Clue): Alfred 2 Workflow for Menu Bar and Keyboard Maestro Hot Key Search

• Host: GitHub
• URL: https://github.com/zhaocai/alfred2-keylue-workflow
• Owner: zhaocai
• Created: 2013-09-25T04:31:31.000Z (about 11 years ago)
• Default Branch: master
• Last Pushed: 2015-02-25T00:39:46.000Z (over 9 years ago)
• Last Synced: 2024-04-13T07:46:44.085Z (7 months ago)
• Language: Ruby
• Homepage: http://zhaocai.github.io/alfred2-keylue-workflow
• Size: 4.41 MB
• Stars: 48
• Watchers: 2
• Forks: 4
• Open Issues: 5
• Metadata Files:
  • Readme: README.md

Awesome Lists containing this project

README

        
# Keylue (Key Clue): Alfred 2 Workflow for Menu Bar and Keyboard Maestro Hot Key Search

It is like [KeyCue][KeyCue] which helps you memorize or quickly launch hot keys. But it is still too much to pinpoint a shortcut from a 50+ entries with your eyeball. This workflow gives the freedom to search and filter the results and execute them from Alfred.

## Usage

1. keyword `kc`: Show menu items and Keyboard Maestro hot keys. Hit `Enter` to execute.

    The feedback results for each application are cached for speedy response. The cached results are reloaded if it is older than an hour.

2. To refresh cached feedback, begine or end the {query} with `!` like:

    - `kc ! {query}`

    - `kc {query} !`

3. To filter `⌘`, `⌥`, set up a typing expansion using [TextExpander](http://smilesoftware.com/TextExpander/index.html), [Keyboard Maestro](http://www.keyboardmaestro.com/), etc.

4. To show only **Keyboard Maestro** hot keys, type `Keyboard Maestro:` in the {query}. 

![](https://raw.github.com/zhaocai/alfred2-keylue-workflow/master/screenshots/chrome.png)

5. keyword `km`: show Keyboard Maestro macros

It is equal to `kc --all -k {query}`

## Sign

- :black_circle: Menu item

- :blue_circle: Services

- :white_circle: Keyboard Maestro global hotkeys

- :red_circle: Keyboard Maestro local hotkeys

## Installation

Two ways are provided:

1. You can download the [Keylue.alfredworkflow](https://github.com/zhaocai/alfred2-keylue-workflow/blob/master/Keylue.alfredworkflow?raw=true) and import to Alfred 2. This method is suitable for **regular users**.

2. You can `git clone` or `fork` this repository and use `rake install` and `rake uninstall` to install. Check `rake -T` for available tasks.

This method create a symlink to the alfred workflow directory: "~/Library/Application Support/Alfred 2/Alfred.alfredpreferences/workflows". This method is suitable for **developers**.

## FAQs

1. Keyboard Maestro contextual hot keys for current application

Keyboard Maestro contextual hot keys cannot be retrieved from Alfred window because Alfred takes over the focus of current application. A workaround is to temporarily activate the current application, retrieve the contextual hot keys and reactivate Alfred.

## Reference

- [Menu Search](http://www.alfredforum.com/topic/1993-menu-search/)

- [ctwise/menudump](https://github.com/ctwise/menudump)

## Copyright

Copyright (c) 2013 Zhao Cai 

This program is free software: you can redistribute it and/or modify it under

the terms of the GNU General Public License as published by the Free Software

Foundation, either version 3 of the License, or (at your option)

any later version.

This program is distributed in the hope that it will be useful, but WITHOUT

ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS

FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details.

You should have received a copy of the GNU General Public License along with

this program. If not, see .

[KeyCue]: http://www.ergonis.com/products/keycue/