Javelin started out as primarily an embedded stenography engine, but has evolved over time to have a wealth of features as a keyboard firmware.

A quick summary of it's capabilities:

• Stenography support -- write at 200+ wpm
  • Embedded stenography engine, with customized host layouts, stenography systems and personal dictionaries.
  • Supports steno writer protocols: Gemini PR, TX Bolt, ProCAT, Plover HID.
• Online web tools to customize and control the keyboard. This includes a visual layout editor.
• Supports input via direct gpio switches, matrix switches, capacitive touch, encoders & touchpad.
• Supports displays, rgb lighting, audio output.
• Fully scriptable configuration, without requiring firmware recompilation. Can act as a keyboard, pointer device, security key, infrared controller, midi device. Examples:
  • Taipo implementation
  • Mouse control layer
• Support for unibody and split keyboards.

This repository contains the raw steno engine, without any bindings.

For pico-sdk bindings and build instructions, see https://github.com/jthlim/javelin-steno-pico.

For the online firmware builder tool, go to http://lim.au/#/software/javelin-steno

Transforms the prior n translations using format.

Format has the following special keys:

• %s or %o: Stroke list
• %l or %d: Lookup results
• %t: Text results
• %%: A single %

Example usage: With SPHRA*EUPB defined as:

  =retro_transform:2:%s: "%l" -> "%t"

Assuming default main.json, then:

T/T/T/T/SPHRA*EUPB: it it `T/T`: "it it" -> "it it"
T/PHRAOES/-S/SPHRA*EUPB: `T/PHRAOES/-S`: "it please {^s}" -> "it pleases"

Sets template value to the last n lookup translations. The value adopted is removed from input to indicate what was set.

Example usage:

  =set_value:0:2

This sets template value 0 to the last 2 lookups.

Suggested bindings:

  "SR*FR": "=set_value:0:1",
  "SR*FR/SR*FR": "=set_value:0:2",
  "SR*FR/SR*FR/SR*FR": "=set_value:0:3",
  "SR*FR/SR*FR/SR*FR/SR*FR": "=set_value:0:4",
  "SR*PB": "=set_value:1:1",
  "SR*PB/SR*PB": "=set_value:1:2",
  "SR*PB/SR*PB/SR*PB": "=set_value:1:3",
  "SR*PB/SR*PB/SR*PB/SR*PB": "=set_value:1:4",
  "SR*LG": "=set_value:2:1",
  "SR*LG/SR*LG": "=set_value:2:2",
  "SR*LG/SR*LG/SR*LG": "=set_value:2:3",
  "SR*LG/SR*LG/SR*LG/SR*LG": "=set_value:2:4",
  "SR*TS": "=set_value:3:1",
  "SR*TS/SR*TS": "=set_value:3:2",
  "SR*TS/SR*TS/SR*TS": "=set_value:3:3",
  "SR*TS/SR*TS/SR*TS/SR*TS": "=set_value:3:4",
  "SR*DZ": "=set_value:4:1",
  "SR*DZ/SR*DZ": "=set_value:4:2",
  "SR*DZ/SR*DZ/SR*DZ": "=set_value:4:3",
  "SR*DZ/SR*DZ/SR*DZ/SR*DZ": "=set_value:4:4",

Transforms the string, substituting template values in format

• %0 - %63: Template value
• %%: '%' character

Example usage:

  =transform:Hello %0

Modifiers supported:

• %u: Upper case, e.g. "FIRST SECOND"
• %l: Lower case, e.g. "first second"
• %t: Title case, e.g. "First Second"
• %c: Capitalize, e.g. "First second"

Example usage:

  =transform:Hello %u0

Interactive prompt to add translation.

Example usage:

  {:add_translation}

Providing a parameter will cause only the strokes to be prompted. This can be useful in combination with =transform and template values.

  =transform:{:add_translation:\n\nHello %0}

Starts interactive console mode.

Example usage:

  Console>{^ ^}{:console}

Runs a console command. The list of commands can be found using help in the console tool

Example usage:

  {:console:set_space_position after}

Disables all dictionaries. This is a quick way to show raw steno.

Example usage:

  {:disable_all_dictionaries}{:enable_dictionary:dictionary_with_enable_all.json}

Disables a dictionary.

Example usage:

  {:disable_dictionary:main.json}

Enables all dictionaries.

Example usage:

  {:enable_all_dictionaries}

Enables a dictionary.

Example usage:

  {:enable_dictionary:main.json}

Sets the layout of the host computer.

Supported values are determined at firmware build time.

  {:host_layout:us_windows_alt}

Repeats the last character_count characters.

Repeats the last fragment_count fragments. Fragments are delineated by whitespace characters.

Repeats the last word_count words. Words are consecutive alphanumeric or consecutive non-alphanumeric characters.

Resets the state of the steno engine.

This removes all stroke history, and sets the next stroke to output without a leading space, and in default (lower) case.

Example usage:

  {:reset_state}

Converts the prior nth_word word to capital.

Example usage: Text: This is a test

  {:retro_capitalise:3}

Output: This Is a test

Surrounds the prior n_words with double quotes.

Example usage: Text: This is a test

  {:retro_double_quotes:2}

Output: This is "a test"

Lower cases the prior n_words.

Example usage: Text: THIS IS A TEST

  {:retro_lower:2}

Output: THIS IS a test

Replaces the prior n spaces with <replacement>.

Example usage: Text: This is a test

  {:retro_replace_space:2:_}

Output: This is_a_test

Surrounds the prior n_words with single quotes.

Example usage: Text: This is a test

  {:retro_single_quotes:2}

Output: This is 'a test'

Surrounds the prior n_words with prefix and suffix.

Example usage: Text: This is a test

  {:retro_surround:2:[:]}

Output: This is [a test]

Converts the prior n_words to title case.

Example usage: Text: This is a test

  {:retro_title:3}

Output: This Is A Test

Converts the prior n_words to upper case.

Example usage: Text: This is a test

  {:retro_upper:3}

Output: This IS A TEST

Sets the case for output.

Supported values:

• normal -- "first second third"
• lower -- "first second third"
• upper -- "FIRST SECOND THIRD"
• title -- "First Second Third"
• camel -- "first Second Third". Generally used with {:set_space:} to give "firstSecondThird"

Example usage:

  {:set_case:title}

Use separator between words.

Example usage:

The following will give "snake case" words:

  {:set_space:_}

Use delimiter between text, if the previous text was also a stitch.

Example usage:

• Stitched capital letter alphabet:

  {:stitch:A}{:stitch:B} → A-B

• Joining repeated words

  {:stitch:ha:} → ha

  {:stitch:ha:}{:stitch:ha:}{:stitch:ha:} → hahaha

• Custom delimiter

  {:stitch:lol:o} → lol

  {:stitch:lol:o}{:stitch:lol:o}{:stitch:lol:o} → lololololol

Use delimiter between the last n words.

Example usage: Text: This is a test

  {:stitch:3:-}

Output: This i-s a t-e-s-t

Toggles a dictionary between enabled and disabled.

Example usage:

  {:toggle_dictionary:main.json}

A reference for Javelin Script is available here.

This project is a snapshot of internal repositories and is not accepting any pull requests.

This code is distributed under PolyForm Noncommercial license. For commercial use, please contact me.