{"id":27734970,"url":"https://github.com/peterjc/kana-chording-ke","last_synced_at":"2025-04-28T13:46:14.530Z","repository":{"id":273959855,"uuid":"921410559","full_name":"peterjc/kana-chording-ke","owner":"peterjc","description":"Japanese Keyboard layouts on macOS using Karabiner Elements: New Stickney, Flick-input like, ...","archived":false,"fork":false,"pushed_at":"2025-04-24T12:04:31.000Z","size":152,"stargazers_count":0,"open_issues_count":7,"forks_count":0,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-04-24T13:23:12.428Z","etag":null,"topics":["chording","japanese-kana","karabiner-elements","keyboard-layout","romaji","romaji-kana"],"latest_commit_sha":null,"homepage":"","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/peterjc.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null}},"created_at":"2025-01-23T22:33:53.000Z","updated_at":"2025-04-24T12:04:34.000Z","dependencies_parsed_at":"2025-01-24T02:21:41.672Z","dependency_job_id":"48e7deeb-3947-4089-a0e5-fa38ccab85e8","html_url":"https://github.com/peterjc/kana-chording-ke","commit_stats":null,"previous_names":["peterjc/kana-chording-ke"],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/peterjc%2Fkana-chording-ke","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/peterjc%2Fkana-chording-ke/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/peterjc%2Fkana-chording-ke/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/peterjc%2Fkana-chording-ke/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/peterjc","download_url":"https://codeload.github.com/peterjc/kana-chording-ke/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":251321789,"owners_count":21570794,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["chording","japanese-kana","karabiner-elements","keyboard-layout","romaji","romaji-kana"],"created_at":"2025-04-28T13:46:13.844Z","updated_at":"2025-04-28T13:46:14.508Z","avatar_url":"https://github.com/peterjc.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"This repository is a holding point for assorted keyboard layout experiments\nfocused on Japanese text entry, and in particular the possibilities offered\nby keyboard chording. Currently this is focused on in-software keyboard\nmodification on macOS using the free open source software [Karabiner\nElements](https://karabiner-elements.pqrs.org/), but many of the ideas could\nequally be done with a programmable keyboard.\n\n# Projects\n\nCurrently there are three main sub-projects:\n\n* [Flick-input like Japanese keyboard chording using cursor\n  keys](cursor-chording-flick-input.md) where for example the `k` or `か`\n  (ka) key alone gives か, but in combination with `←`, `↑`, `↓`, or `→`\n  gives き, く, け, or こ (ki, ku, ke, ko) mimicking the touch-screen iOS\n  12-key flick input.\n\n* [New Stickney Japanese keyboard layout](new-stickney-in-macos.md) where\n  for example Qwerty `q` with the standard JIS layout gives `た`, but is\n  remapped to `f` in order to give `け` as per the New Stickney layout.\n  The standard JIS kana layout uses four rows of keys (including the\n  numberpad; small kana are typed using shift), while New Stickney is more\n  ergonomic using only three rows (small kana are typed using the `゛`\n  post-modifier).\n\n* [Hands Down Promethium layout on Apple Japanese\n  keyboard](hands-down-on-jis-macbook.md) (for typing in English) using\n  the short spacebar and Japanese language keys either side of it as\n  thumb keys.\n\n# Japanese character entry\n\nThere are at least three ways to enter Japanese hiragana or katakana (and\nin some cases kanji) on computers which I have tested on macOS:\n\n1. There are operating system specific keyboard expressions to enter the hex\n   code of an individual unicode symbol which can be used for kana or even kanji.\n   See [hex codes for kana in unicode](http://www.i18nguy.com/unicode/hiragana.html).\n   For macOS, once in \"*Unicode Hex Input*\" mode, to enter け (ke), press-and-hold\n   the option key (aka alt), then type `3`, `0`, `5`, `1`, and release the option\n   key. The top number row or the number pad can be used. The same trick works for\n   emoji too, usually eight digits, and can be done from KE. Unfortunately, using\n   \"Unicode Hex Input\" mode has the significant drawback that you won't get access\n   to the OS IME for kanji support.\n\n2. If instead we use \"*Japanese - Romaji*\" mode, we must map the desired kana to\n   any of the supported romaji aliases, and send that key sequence. Thus for `け`\n   we send `k` then `e`. We can send upper case `K` then `E` which can be\n   configured in the macOS Japanese settings to be treated automatically as\n   the katakana `ケ`. In this mode to enter coffee we would want to simulate\n   pressing `K` `O` `-` `H` `I` `-` giving `コーヒー` as you typed. Here is\n   a great [introduction to typing in romaji\n   mode](https://www.tofugu.com/japanese/how-to-type-in-japanese/) which\n   covers this and more.\n\n3. Alternatively, in \"*Japanese - Kana*\" mode, we must map the desired kana to\n   the physical key on the macOS Japanese keyboard JIS layout, and send that\n   keycode. In the default JIS layout `け` corresponds to the ANSI Qwerty semi-colon\n   key `:` so we send that. For `げ`, we must also send the `◌゙` (ten-ten or\n   dakuten) as the `@` key. Likewise `◌゚ ` (adding maru or handakuten) is on the\n   `[` key. In this mode the shift key gives the small form of the vowels\n   `a`/`i`/`u`/`e`/`o`, `tsu` or `ya`/`yu`/`yo`, and toggles the `わ` key to\n   `を` (key zero).\n\nNote Karabiner Elements rules can be conditional on the current input mode.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fpeterjc%2Fkana-chording-ke","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fpeterjc%2Fkana-chording-ke","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fpeterjc%2Fkana-chording-ke/lists"}