New Osage Language Keyman

Hello everyone!
My name is Harris and I am a programmer from the United States of America. Currently I work for the Osage Nation, a tribal nation from Oklahoma to help with their language.
Recently the Osage Nation language department (where I work) decided that we should develop a new keyboard layout which I helped work on. Recent changes to the Osage script’s orthography (such as eliminating letter case and removing a couple letters) necessitated the creation of a new keyboard layout. They want the Keyman keyboard for the Osage language to be adjusted in accordance with the new layout

How should I go about this change? I am unfamiliar with how the bureaucracy / general development of Keyman works, but I have already coded new .kmn and .kvks files to adjust to this new layout which I hope can be adapted into the newest version of Keyman. Does anyone have advice about where to start?

Thanks very much and have a great day.

Welcome @harris

I see the Keyman catalog has two keyboards for Osage:

  • Osage Basic - This is directly based from the Windows 10 keyboard layout
  • Osage Nation - Is this the Keyman keyboard you’re looking to modify?

How should I go about this change?

The open-source for the Keyman keyboards is available at

Assuming you’re modifying “osage_nation”, you’ll be looking at the files in

Here’s a guide for keyboard submissions:

Thank you so much for your quick reply.

The keyboard I am looking to modify is the Osage Nation keyboard rather than the Osage Basic keyboard.

Would it be possible for me to send a pull request on individual files in the Osage_Nation keyboard rather than making a whole new keyboard? Or would it not be accepted? To clarify I already went to keyboards/release/o/osage_nation/source at master · keymanapp/keyboards · GitHub, downloaded it, and just modified a few files on my computer to reflect the new layout.

Hi Harris. I’m the one who helped Mark P get the Osage Nation keyboard into the repository. I’d be happy to help you if you run into problems.

The main thing I would like you to think about is whether we should keep the existing keyboard for any reason…will someone ever want to type in the “old” orthography? If so, we should keep that one and submit a new keyboard called osage_nation_new, osage_nation_revised or osage_nation_nocase. Then we could “deprecate” the osage_nation one, but it would still be available.

If the Osage Nation doesn’t want anyone using the old orthography, then please go ahead and submit your update to the osage_nation keyboard.

1 Like

Hi Lorna, thanks so much for your response. And thanks for helping Mark get this done.

To be honest there is no reason anyone would want to type in the “old” orthography (or any previous iterations of Osage orthographies which existed before this keyboard).

I will soon send a pull request to closely match the virtual keyboard we already made for this new layout: My Keyboard

Would it be okay if I sent the keyman-touch-layout file in a later update? I am having a little trouble understanding this file type.

Thanks very much :slight_smile:

Since there’s already a touch layout, it would be best to update the touch layout at the same time as the desktop keyboard.

The touch layout is mostly visual so I hope it’s not too difficult to understand. It looks to me like if you updated what is on the “o” key, it will automatically update the touch layout. However, if you want something different on the longpress keys, I used this syntax U_104DA which is U_ plus the Unicode codepoint. If you want to change that, you need to replace that codepoint with the changed codepoint.

Also, every time you update anything that goes in the keyboard package you need to “bump” the keyboard version, so making all the changes in one go is much better. When there is a new keyboard package, the people who are already using the keyboard will be notified and ask if they want to update their keyboard. That’s nice to get everyone using the new version, but they will get snarky if you update the keyboard too often :slight_smile:

Hola Lorna, leí sus comentarios y respuestas en algunos post. Me gustaría contar con su ayuda para la creación de un teclado para mi idioma que es el Chalchiteko que se habla en Guatemala.

I have responded to the message regarding the Chalchiteko keyboard via DM.

This topic is scheduled to be closed three weeks from now. Please reply before then if you need further assistance.

This topic was automatically closed after 21 days. New replies are no longer allowed.