<commit_before>## Brief Description

[*Kwm*](https://koekeishiya.github.io/kwm) started as a simple project to get true focus-follows-mouse support on OSX through event tapping.
It is now a tiling window manager that represents windows as the leaves of a binary tree.
*Kwm* supports binary space partitioned, monocle and floating spaces.

*Kwm* uses the event taps API (Quartz Event Services) to observe, filter and alter user input events prior
to their delivery to a foreground application. This allows for functionality such as focus-follows-mouse,
and different types of hotkeys.

*Kwm* runs a local daemon to read messages and trigger functions.
*Kwmc* is used to write to *Kwm*'s socket, and must be used when interacting with and configuring how *Kwm* works.
For a list of various commands that can be issued, check the readme located within the *kwmc* folder.
The *Kwmc* tool also has a built-in help system that can be accessed from the terminal using `kwmc help`.

*Kwm* requires access to the OSX accessibility API.
Tested on El Capitan (10.11.1 - 10.11.3).

![img](https://cloud.githubusercontent.com/assets/6175959/12651784/55c7debe-c5e8-11e5-836f-97f99f2b4529.png)
For more screenshots, [click here.](https://github.com/koekeishiya/kwm/issues/2)

[herrbischoff](https://github.com/herrbischoff) has re-created my bar from the screenshots as a widget
for [Übersicht](http://tracesof.net/uebersicht/) for those that would like to have a decent bar with their setup.
This widget can be found here: https://github.com/herrbischoff/nerdbar.widget

## Extended Information:

The different features; binary space partitioning, focus-follows-mouse and the hotkey-system can all be enabled
independently. This allows the user to choose which functionality to enable depending on their workflow.

*Binary Space Partitioning:*
Kwm tiles windows using a binary-tree structure. For information, check the usage section.

*Focus-Follows-Mouse:*
Both autofocus and autoraise is available, however autofocus only redirects key input to the window below the cursor,
the menubar is not accessible. Autoraise gives a window focus and raises it to the front.  By default *Kwm* is set to
use autoraise as it is meant to be used alongside the tiling functionality, and so windows should not overlap unless
a window is specifically made floating.

*System-Wide Hotkeys:*<commit_msg>add link to wiki<commit_after>## Brief Description

[*Kwm*](https://koekeishiya.github.io/kwm) started as a simple project to get true focus-follows-mouse support on OSX through event tapping.
It is now a tiling window manager that represents windows as the leaves of a binary tree.
*Kwm* supports binary space partitioned, monocle and floating spaces.

*Kwm* uses the event taps API (Quartz Event Services) to observe, filter and alter user input events prior
to their delivery to a foreground application. This allows for functionality such as focus-follows-mouse,
and different types of hotkeys.

*Kwm* runs a local daemon to read messages and trigger functions.
*Kwmc* is used to write to *Kwm*'s socket, and must be used when interacting with and configuring how *Kwm* works.
For a list of various commands that can be issued, check the readme located within the *kwmc* folder.
The *Kwmc* tool also has a built-in help system that can be accessed from the terminal using `kwmc help`.

For in depth information, sample configurations, and useful scripts to implement new features by combining
kwmc commands, check out the [wiki](https://github.com/koekeishiya/kwm/wiki)

*Kwm* requires access to the OSX accessibility API.
Tested on El Capitan (10.11.1 - 10.11.3).

![img](https://cloud.githubusercontent.com/assets/6175959/12651784/55c7debe-c5e8-11e5-836f-97f99f2b4529.png)
For more screenshots, [click here.](https://github.com/koekeishiya/kwm/issues/2)

[herrbischoff](https://github.com/herrbischoff) has re-created my bar from the screenshots as a widget
for [Übersicht](http://tracesof.net/uebersicht/) for those that would like to have a decent bar with their setup.
This widget can be found here: https://github.com/herrbischoff/nerdbar.widget

## Extended Information:

The different features; binary space partitioning, focus-follows-mouse and the hotkey-system can all be enabled
independently. This allows the user to choose which functionality to enable depending on their workflow.

*Binary Space Partitioning:*
Kwm tiles windows using a binary-tree structure. For information, check the usage section.

*Focus-Follows-Mouse:*
Both autofocus and autoraise is available, however autofocus only redirects key input to the window below the cursor,
the menubar is not accessible. Autoraise gives a window focus and raises it to the front.  By default *Kwm* is set to
use autoraise as it is meant to be used alongside the tiling functionality, and so windows should not overlap unless
a window is specifically made floating.

*System-Wide Hotkeys:*
{'fraction_non_alphanumeric': 0.06931495743818403, 'fraction_numerical': 0.018646128901499796, 'mean_word_length': 4.792253521126761, 'pattern_counts': {'":': 0, '<': 3, '<?xml version=': 0, '>': 3, 'https://': 11, 'lorem ipsum': 0, 'www.': 0, 'xml': 0}, 'pii_count': 0, 'substrings_counts': 0, 'word_list_counts': {'cursed_substrings.json': 0, 'profanity_word_list.json': 0, 'sexual_word_list.json': 0, 'zh_pornsignals.json': 0}}
{'dir': 'git-commits-cleaned', 'id': '4906998', 'n_tokens_mistral': 1444, 'n_tokens_neox': 1378, 'n_words': 661}