Javelin: Difference between revisions
(Expand the page) |
(Add web tools section and error for connecting to Linux) |
||
Line 34: | Line 34: | ||
=== Layout editor === | === Layout editor === | ||
Javelin has a GUI for editing the layout of your keyboard. It is a very powerful tool, allowing you to customize any aspect of the layout. | Javelin has a GUI for editing the layout of your keyboard. It is a very powerful tool, allowing you to customize any aspect of the layout. | ||
=== Web tools === | |||
Javelin provides a set of web tools for learning aids, and tweaking settings. | |||
==== Cannot connect to device on Linux ==== | |||
If you see <code>Error connecting</code> while trying to connect to your device with the web tools, you need to add a udev rule. Create a file at <code>/etc/udev/rules.d/99-keyboard-javelin.rules</code> with the following content: | |||
<pre>SUBSYSTEM=="hidraw", ATTRS{idVendor}=="9000", ATTRS{idProduct}=="400d", MODE="0666"</pre>After creating the file, reload the rule with the following commands:<pre>sudo udevadm control --reload-rules | |||
sudo udevadm trigger</pre>{{Info|text=If this does not work, try replacing <code>9000</code> with <code>feed</code>.}} |
Revision as of 02:48, 13 July 2024
Javelin is a keyboard firmware that features a steno engine. This allows Javelin compatible devices to translate directly from the keys pressed to textual output. This bypasses the need to install Plover (or anything) on the host machine. All the translations are contained within the keyboard itself ("plug and play stenography"). It is compatible with several commercially available hobbyist writers.
Features
This section covers some noteworthy features of Javelin. If you wish to view all of the available settings and features, have a look through the Javelin firmware builder. You may have to select Show expert options
to find the option you are looking for.
Embedded steno engine
Compatible host devices
Javelin can translate steno strokes to text in exactly the same way that Plover does. However, as Javelin's steno engine is embedded in the keyboard firmware itself, no extra software is required on the host device. Javelin simply sends the translations as if they were coming from a regular keyboard. Therefore, Javelin is compatible with any device that accepts regular USB keyboard input.
Dictionary management
Adding your own arbitrary JSON dictionaries is fully supported. Using the web tools or custom defined outlines, it is possible to temporarily disable dictionaries.
Compared to Plover, however, it is not possible to add your own programmatic dictionaries (such as python dictionaries) using the firmware builder. Some popular python dictionaries have been implemented in Javelin, such as Emily's symbols and Jeff's phrasing. However, there is no officially documented way to write a programmatic dictionary for Javelin (though it is technically possible).
Non-WSI layouts
It is not currently possible to use a non-WSI layout with Javelin (this may change in the future).
Unicode characters
Javelin supports several methods to write Unicode characters, which are all dependent on the host device. Using the settings in the web tools, the Unicode mode can be set to allow writing such characters on Linux, macOS, and Windows. Using the firmware builder, the default Unicode mode can be specified.
Key map customization
Like with Plover, the key map can be set in Javelin to allow for tweaks such as top `S` number key, or changing the placement of the thumber keys on various boards.
Adding translations
Using the web tools or a defined outline, it is possible to add translations to a user dictionary just like in Plover.
First-up and chord repeat
Using the firmware builder, it is trivial to add first-up chord send or chord repeat functionality to your board.
Layout editor
Javelin has a GUI for editing the layout of your keyboard. It is a very powerful tool, allowing you to customize any aspect of the layout.
Web tools
Javelin provides a set of web tools for learning aids, and tweaking settings.
Cannot connect to device on Linux
If you see Error connecting
while trying to connect to your device with the web tools, you need to add a udev rule. Create a file at /etc/udev/rules.d/99-keyboard-javelin.rules
with the following content:
SUBSYSTEM=="hidraw", ATTRS{idVendor}=="9000", ATTRS{idProduct}=="400d", MODE="0666"
After creating the file, reload the rule with the following commands:
sudo udevadm control --reload-rules sudo udevadm trigger
If this does not work, try replacing 9000
with feed
.