Lapwing with Javelin

Javelin is a keyboard firmware that features an embedded steno engine. Embedded steno allows a keyboard to act as a steno machine without requiring any software installed on the host device. This is useful for using steno with locked down computers (i.e., school/work machines) or devices that do not support Plover (such as Chromebooks, iOS devices, Linux distros running Wayland, etc).

As this book is aimed towards Plover users, instructions specific to the Plover app will be found throughout the chapters. This page contains the afferent instructions for Javelin users in each chapter.

Chapter 3

Chapter 3 provides instructions on using the Plover lookup tool. The Javelin lookup tool can also be used; follow the same tips for affix strokes.

There is also a Javelin lookup tool for the onboard dictionaries in your steno keyboard. Although this requires connecting your steno keyboard, any translations you have added will show up here too.

Chapter 4

Chapter 4 covers using Steno Jig to learn the layout. To use the Steno Jig layout drills with Javelin, go to the active dictionaries and uncheck all the boxes:

dictionaries all unchecked with Javelin

NOTE: it does not matter if the dictionaries for your device are different than those in the image above. Simply uncheck every single one.

This will make the steno keyboard output the raw keys (rather than any translations), which is necessary for these exercises. Once you have completed chapter 4, make sure to enable the dictionaries again.

Chapter 5

Chapter 5 goes over setting up Lapwing with the Plover app. To set up Lapwing with Javelin, first go to the Javelin Firmware Builder.

javelin firmware builder

First select your hardware in the dropdown menu, and then press the Default Lapwing button. Scroll down to the very bottom of the page for specific instructions on flashing the firmware to your keyboard.

Chapter 26

Chapter 26 discusses editing text, and brings up modal dictionaries. These are unfortunately not supported by Javelin. If you follow the set up instructions below, you will by default use the lapwing-semi-modal-movement.json dictionary. You can also experiment with first-up chord send or creating movement key layers.

Creating your own Lapwing firmware

Instead of using the default Lapwing firmware, it is also possible to manually configure your own Javelin firmware for Lapwing. This may be helpful if you wish to tweak your layout or add your own personal dictionaries. As such, this guide is aimed towards advanced users. If you are new to steno and just want Lapwing on your board, follow the instructions for chapter 5 above.

Download the dictionaries

Download the following dictionaries by right clicking the links and pressing Save link as (or whatever the equivalent is for your browser):

Configure and build firmware

Go to the Javelin Firmware Builder.

Select your hardware (1), enable expert options (2), and change the unicode mode (3) to whichever is applicable to your use case.

Javelin

Scroll down to options, and select Enable Repeat(4).

Javelin

In dictionaries, uncheck Jeff’s modifiers dictionary (6), and enable Jeff’s phrasing dictionary (7) as well as Emily’s symbols dictionary (8).

Javelin

In the dictionary list, add all the json dictionaries you downloaded earlier. Arrange them like shown below by dragging on the dictionary names.

Javelin

NOTE: make sure to uncheck the box next to lapwing-semi-modal-movement.json. This ensures the dictionary is disabled by default as it should only be enabled for movement commands.

In the key map settings, check Use S1 as a #key (8).

Javelin

Finally, click on Create Standalone and follow the Update Firmware instructions in the section below. Note the instructions differ depending on the hardware you are using.

Javelin

Settings summary

NumberSetting
1Select the keyboard you want to use with Javelin
2Enable Show expert options
3Change the default unicode mode (depends on the OS you use most often)
4Check Enable repeat
5Uncheck Jeff’s modifiers dictionary
6Check Jeff’s modifiers dictionary
7Check Emily’s symbols dictionary
8Check Use S1 as a #key

Tweaking settings after the fact

Javelin has several useful steno tools you can use to change various settings even after flashing the firmware. There is also a lookup tool and add translation tool just like with Plover.