1 # star-platinum
2 
3 It's a key binding manager for X11.  It lets you assign keys on other application and bind custom action to them.  You can execute external commands or send fake keys.  I'm using it to "emacs-ify" firefox, but can do more.
4 
5 Let's take a look at a sample configuration file
6 
7 ```
8 match all
9 on "C-<F5>" do exec 'notify-send "hello world"'
10 
11 match class 'Firefox'
12 match class 'Chromium-browser'
13 on "C-w" do "C-x"
14 on "M-w" do "C-c"
15 on "C-y" do "C-v"
16 ```
17 
18 I binded globally control+F5 to that command, and on firefox and chromium I've re-binded control-w to cut, alt-w to copy and control-y to paste.  The key syntax is heavily inspired by emacs.
19 
20 => https://git.omarpolo.com/star-platinum star-platinum git repository
21 
22 You can fetch the sources with
23 ```
24 git clone https://git.omarpolo.com/star-platinum
25 ```
26 or via the github mirror
27 ```
28 git clone https://github.com/omar-polo/star-platinum
29 ```
30 
31 To build you need a C compiler (anything from GCC 4.2 onward should work – that is, anything from the last 15 years), lex/flex, yacc/bison and make.  Check out the README for more information on building.
32 
33 ## Planned work
34 
35 This is a sort of TODO list of things I want to develop.
36 
37 * bind keys directly on the windows
38 I'm currently binding the key globally and send fake copy of the event if the window doesn't match.  But binding the keys globally can interfere with other programs that, by defaults, ignores fake keys (like XTerm).
39 
40 * define state / better keymap
41 I should introduce keymaps.  This should let me allow arbitrary keys, like "C-x C-s", and also introduce the idea of "states" for our vi friends.