https://github.com/omar-polo/star-platinum

keybinding manager for x11
https://github.com/omar-polo/star-platinum

Last synced: 8 days ago
JSON representation

keybinding manager for x11

• Host: GitHub
• URL: https://github.com/omar-polo/star-platinum
• Owner: omar-polo
• License: isc
• Created: 2020-09-29T13:17:23.000Z (about 4 years ago)
• Default Branch: master
• Last Pushed: 2020-11-05T08:31:37.000Z (about 4 years ago)
• Last Synced: 2023-03-05T04:42:59.729Z (over 1 year ago)
• Language: C
• Size: 53.7 KB
• Stars: 1
• Watchers: 2
• Forks: 0
• Open Issues: 0
• Metadata Files:
  • Readme: README.md
  • License: LICENSE

Awesome Lists containing this project

README

        
# star platinum

`star-platinum` is a key binding manager for x11.  It acts primarily

as a translator: the canonical example is to Emacs-ify various

programs by customizing how some key are handled.

Check out the [manpage](star-platinum.1) for more information.

## Building

`star-platinum` depends on `xlib` and needs a C compiler, `yacc` and

`lex` to compile.  With that in place, it's as easy as

    make

OpenBSD' `lex` and `yacc` were tested, as well as `bison` 3.3.2, GNU

gcc 4.2.1 and 8.4.0, and clang 10.0.1

Configuration for the build process can be found in `config.mk`, but

you usually don't need to modify it: passing the variables to make

should be enough.  For instance, to build with `gcc`

    make CC=gcc

`bison` can be used instead of `yacc` by changing the `YACC` variable

    make YACC=bison

Unless you are compiling on OpenBSD, you probably want to change the

default `CFLAGS` and `LDFLAGS`.

If `etags` is available, a `TAGS` file is created.  Note however that

`etags` is **not needed** for building: it's only a support tool used

to aid the development.

## FAQ

 - it does not seems to work!

   There’s currently a limitation, star-platinum won’t work with

   reparenting window manager (such as the heavier DE, but also some

   lighter WM like stumpwm or i3).

 - the name is a jojo reference?

   Sort of.  I was listening to 「sono chi kioku」, the fourth opening,

   while I was playing with the idea of translating the key.  Given

   that I'm generally bad at naming things...