…or CKFW for short.LinksThe binariesConfiguration file based on X.org Compose fileOfficial bugtrackerWhy?
Because both FreeCompose and AllChars assume that all sequences are two chars long. I'm used to the X.org compose sequences, so this limitation is a deal breaker.
Another reason is that now foreseeable future
has a precise definition: a month and nine days.What systems does it work on?
work on Windows 2000 and higher. It is supported
on these systems.
Both IA-32 ("32-bit") and AMD64 ("64-bit") Windowses are supported, and native binaries (ckfw32.exe, resp. ckfw64.exe) are provided for these.
It has been tested
on Windows 8, Windows Vista*, Windows XP* and Windows 2000.
It may or may not work
on Windows NT 4.0 and below.
It's highly unlikely to work
on Windows 95, 98 and Me. It'd be a miracle if it ran on Windows 3.11 and below.
It has also been tested on ReactOS, where it's buggy. Very likely to be a bug in the OS, though.
It doesn't work under Wine.
* courtesy of MilyamdWhat about Linux? And BSDs?
Dude, you have X.org, which natively supports compose key.What about Mac OS X?
I don't have nor care about this particular OS.What about other *nixes? And non-*nixes?
See above.How do I install it?
Extract the executable you want (see What systems does it work on?
) to wherever you want.How can I make it start whenever Windows starts?
The same way you do with any other program*. There are various methods with their own upsides and downsides. Refer to your favorite search engine for details.
* except there's no installer to do it automaticallyHow do I turn it off?
It adds an icon to the
notification area. Click on it.
"Compose enabled" controls whether the compose key is active (if it's not, all keypresses are just passed unchanged), making it a good way to temporarily disable it.
"Exit", well… exits.How do I configure it?
By changing the configuration file. By default, it's a file named ckfwrc
in the current directory. If you want a different one, set the environment variable CKFWRC
to the path of the file you want to use.
A quick explanation of the config file syntax:
# everything from a # to the end of line is a commentIt says "Errors in the configuration detected, rerun with logger enabled to identify them", what should I do?
# this is how you set the compose key
# the semicolons are quite important
# DO NOT prefix the numbers with "0x" or anything else!
: 14; # hexadecimal 14, decimal 20; happens to be caps lock
: A3; # right control, takes precedence because it's later in the config file
# see http://msdn.microsoft.com/en-us/library/windows/desktop/dd375731(v=vs.85).aspx for the list of possible codes
# no, the mouse buttons won't work
# a few sequences
# <>-, ""-, and ''-enclosed strings are equivalent
# <x> <y> is equivalent to <xy>
+ <a> <'> : e1; # á
# + "a'" : e1; # would be the same
+ "--" ' ' : ad; # soft hyphen
# the code after the colon is the Unicode code point of the character(s)
# yes, there can be more than one character
+ "ab" : 41 42 43 44 45;
# Unicode code points can be used on the left hand side, too:
+ 65 "e": 256; # Compose, e, e -> schwa
Run it (through the console or a shortcut) with the name of log file (which can be whatever you want) as an argument, like: ckfw32 ckfw.log
contains the execution log, which contains all the error messages CKFW detected when reading the configuration file. So you know what to fix.This way of error reporting sucks, can't you just show a message box with all the errors?
Yeah… no. In some cases there can be enough errors to make the message box not fit on the screen. It'd suck even more.It crashed!
Do you know what you've been doing when it crashed? If so, please rerun with the logger enabled (see It says "Errors in the configuration detected, rerun with logger enabled to identify them", what should I do?
) and try to do the same things again. Crashed again? Great, now you can report the issue by filing a bug report on the official bugtracker
. The report should contain both
the instructions on how to reproduce it and the log. If you don't have one of these, you can still try and report it, but it'll be harder for me to fix.The icon sucks.
I know. I'd appreciate it if someone made a better one.What's the license?
3-clause BSD, except the source is closed. Tough luck.
So, uh, feedback is welcome.