Beginner's Guide: Difference between revisions

From Plover Wiki
(Created page with "<markdown> This guide explains how to **get started with Plover**. Plover is free stenography software. All the learning resources listed below are free-of-charge. ## Overview The main steps are: 1. [Download and install the Plover application.](#download-and-install-plover) 1. [Connect a compatible keyboard or stenography (steno) machine.](#connect-a-compatible-keyboard-or-stenography-machine) 1. [Confirm it's working.](#confirm-its-working) 1. [Practice and learn st...")
 
 
(54 intermediate revisions by 7 users not shown)
Line 1: Line 1:
<markdown>
<languages />
This guide explains how to **get started with Plover**. Plover is free stenography software. All the learning resources listed below are free-of-charge.
<translate>
This guide explains how to '''get started with Plover'''. Plover is free stenography software. All the learning resources listed below are free-of-charge.


## Overview
In order to get started, the main steps are:
# Install Plover (the application)
# Acquire and connect a keyboard or steno writer
# Learn stenography, starting with theory


The main steps are:
<!--T:7-->
<span id="download-and-install-plover"></span>
== Download and Install Plover ==


1. [Download and install the Plover application.](#download-and-install-plover)
<!--T:8-->
1. [Connect a compatible keyboard or stenography (steno) machine.](#connect-a-compatible-keyboard-or-stenography-machine)
Plover is an app that translates the strokes you press on your steno machine to entire words. If you do not have a steno machine, Plover can use your regular keyboard as one. It is free to download, and it works on '''Windows, Mac, and Linux'''.
1. [Confirm it's working.](#confirm-its-working)
1. [Practice and learn stenography using Plover.](#practice-and-learn)


## Download and Install Plover
<!--T:9-->
* '''[[Installation_Guide|Download and install Plover with the Installation Guide]]'''
* If you get stuck, see the [[Troubleshooting Issues|troubleshooting guide]].


Plover works on **Windows, Mac, and Linux**.
<!--T:10-->
== Connect a compatible keyboard or stenography machine ==


* [**Download and install Plover with the Installation Guide 🚀**](https://github.com/openstenoproject/plover/wiki/Installation-Guide)
<!--T:12-->
* If you get stuck, see the [troubleshooting guide](https://github.com/openstenoproject/plover/wiki/Troubleshooting:-Common-Issues).
Steno involves pressing down groups of keys (called “strokes” or “chords") all at once. Standard QWERTY keyboards can usually only recognize up to six simultaneous key presses, while a dedicated steno writer has no limit to how many simultaneous key presses it can register.


## Connect a compatible keyboard or stenography machine
===Compatible hardware===
{{See also|Supported hardware}}
Among other hardware, Plover is compatible with:
# '''Standard keyboards''' - Requires no additional investment from the average computer user. It is possible to overcome the six simultaneous key presses limitation using [[Arpeggiating|arpeggiation]]. Recommended for those who are ''unsure whether you want to learn steno''. Read the page on [[using a standard keyboard with Plover]].
# '''Hobbyist writers''' - Pre-built mechanical keyboards specialized for stenography which cost, on average, around $110 USD. Choose from the currently available [[Supported hardware#Commercially available hobbyist writers|commercially available hobbyist writers]] or [[DIY_steno_writers|DIY your own keyboard]].
# '''Professional writers''' - Used by professional stenographers and court reporters, not typically used by the hobbyist community due to their $1000 (used) to $6000 (new) price tags. If you already own one, you can connect it to Plover as long as it uses one of the [[Supported_hardware#Supported_protocols|supported protocols]].


Steno involves pressing down groups of keys (called "strokes" or "chords) all at once. Standard QWERTY keyboards usually only recognize a few keys pressed at once. While some steno strokes may contain as many as as 10 keys, it is still possible to learn the basics of steno with a regular keyboard. While a dedicated steno keyboard will make it significantly easier to reach 120+ WPM, we would not recommend buying one until you are sure you want to dedicate the time to learning steno.
With the help of a plugin, it is also possible to use a [[Video_game_controllers|video game controller]] with Plover.


Feel free to read this entire section, but if you are already familiar with the hardware you have, you can skip to the relevant section:
===Connecting your hardware===
* [Use a standard QWERTY keyboard](#use-a-standard-qwerty-keyboard)
[[File:Plover-connected.jpg|thumb|right|Plover connected to a standard keyboard and with Output enabled.]]
* [Use an N-key rollover (NKRO) QWERTY keyboard](#use-an-n-key-rollover-nkro-qwerty-keyboard)
* [Adapt a keyboard for steno use](#adapt-a-keyboard-for-steno-use)
* [Use a machine designed for use with Plover](#use-a-machine-designed-for-use-with-plover)
* [Use a professional stenography machine](#use-a-professional-stenography-machine)


### Use a standard QWERTY keyboard
<!--T:43-->
To use a '''standard keyboard''': Plover is set up to use your computer’s typing keyboard by default. You can connect your keyboard by selecting "Keyboard" in the Machine dropdown, and the status message underneath should update to "Connected".


If you are on a laptop or are using a generic keyboard, chances are it does not have N-key rollover (NKRO). This refers to keyboards that are capable of recognizing any number of keys pressed simultaneously. Most keyboards can only recognize up to 6 simultaneous key presses (and some combinations may only yield 2 simultaneous key presses). To work around the lack of NKRO, you have two options: arpeggiating, and rolling your strokes.
To use a '''hobbyist''' or '''professional writer''': see the page on [[setting up your writer with Plover]] to connect your hardware to the Plover software. If you're having trouble achieving "Connected" after following the instructions, [[Troubleshooting issues|troubleshoot]].


#### Arpeggiate
When the "Output" is toggled to disabled, your keyboard will operate as normal and your steno machine will not give any output. When "Output" is toggled to enabled, you will be in steno mode! Plover will type to any place you normally use your keyboard to type (browsers, documents, emails, chat apps, etc.)


With the arpeggiate option enabled, you can write a stroke by pressing smaller groups of keys (or even individually) and then the spacebar once you've finished. Plover will not process a chord until after you have pressed the spacebar. This way, you do not necessarily have to press multiple keys at once, thereby working around the lack of NKRO.
<!--T:42-->
== Learn and practice==
{{See also|Learning stenography}}


![Arpeggiate gif](https://media.discordapp.net/attachments/1034561065654161478/1200852241993715863/keyboard-arpeggiate.gif)
<!--T:70-->
'''If you are new to stenography,''' you can now start [[learning stenography]] by [[memorizing the key layout]] and [[choosing a steno theory]].


To enable arpeggiate, open Plover's main window and press `Configure`. Under "Machine" enable `Arpeggiate` and click `Apply` and `OK` when you are done.
[[Theory]] is the set of rules used to learn and write using stenography; a [[dictionary]] is an implementation of those rules which allows Plover to interpret your steno strokes and display them in English. Most theories come with a dictionary for you to plug into stenography software, but as your implementation and interpretation changes, [[Personalizing your dictionary|so will your dictionary]].


![arpeggiate option](https://github.com/openstenoproject/plover/assets/52895314/5467e672-7306-43d8-83fb-6f771a5802ef)
'''If you are new to Plover but not to stenography,''' upload your dictionary to Plover, learn about Plover's [[dictionary format]], and read the [[FAQ]].


#### Rolling your strokes
'''By default,''' [[Plover software|Plover (the software)]] comes with the dictionary for [[Plover theory|Plover (the steno theory)]] already installed.
* To use this dictionary, you can learn Plover theory.
* If you want to learn a different steno theory, you can upload their dictionary into Plover (or, in the case of [[Lapwing theory|Lapwing]], install a plugin).
* If you have already learned theory and are coming to Plover from a different steno software, you can upload your dictionary into Plover using <code>.rtf</code> format.


By default, Plover does not process steno strokes until every single key has been released. You can use this feature to your advantage if you do not have an NKRO keyboard. Instead of pressing the keys in a stroke simultaneously, press only a few. Slowly add one more key in the stroke while releasing another. As long as you keep at least one key pressed down, Plover will not receive your steno stroke, and you can still add in more keys to the stroke.
== Write your first strokes with Plover ==
To confirm Plover is working correctly, follow this tutorial to write “hello, world.” into a text editor with Plover. Open a text editor and write the steno key strokes in the table below, one row at a time.


![](https://cdn.discordapp.com/attachments/136953809409802240/1173317394022801488/keyboard-roll.gif)
<!--T:49-->
{{Info|text=Notepad in Windows 11 is buggy with Plover's fast emulated output. Try a different program such as Microsoft Word or Google Docs in a browser, or [[Configuration#Output Tab|increase the key press delay]].}}


Regardless of if you roll or arpeggiate your strokes, make sure you [confirm it's working](#confirm-its-working).
<!--T:51-->
On a QWERTY keyboard, the steno keys are arranged as follows:
[[File:Steno keys on QWERTY keyboard by Jen.png|center|thumb|583x583px|Steno keys on a QWERTY keyboard as understood by Plover.]]


### Use an N-key rollover (NKRO) QWERTY keyboard
If you are using a QWERTY keyboard, you may find it helpful to follow the column on the right. Unless you are [[arpeggiating]] (rolling) your strokes, make sure to press every single key all at once. Remember to release every key after each stroke.


An N-key rollover (NKRO) keyboard is specially designed to allow pressing many keys at once. Many gaming/mechanical keyboards have NKRO. With an NKRO keyboard and Plover, you can press down every single key in a stroke all at once without needing to use one of the workarounds mentioned above. By default, Plover is set to use your keyboard as a steno machine after you install the app.
<!--T:52-->
{| class="wikitable"
|-
! Output
! Steno Stroke
! QWERTY Keys
|-
| hell
| <code>HEL</code>
| <code>r</code> (left index index) <br> <code>n</code> (right thumb) <br> <code>o</code> (right ring finger)
|-
| o
| <code>HRO</code>
| <code>rf</code> (left index finger pressing in between) <br> <code>v</code> (left thumb)
|-
| ,
| <code>-RBGS</code>
| <code>j</code> (right index finger) <br> <code>k</code> (right middle finger) <br> <code>l</code> (right ring finger) <br> <code>;</code> (right pinkie finger)
|-
| world
| <code>WORLD</code>
| <code>d</code> (left middle finger) <br> <code>v</code> (left thumb) <br> <code>j</code> (right index finger) <br> <code>o</code> (right ring finger) <br> <code>[</code> (right pinkie finger)
|-
| .
| <code>-FPLT</code>
| <code>u</code> (right index finger) <br> <code>i</code> (right middle finger) <br> <code>o</code> (right ring finger) <br> <code>p</code> (right pinkie finger)
|}


Be sure to try the example later in this page to [confirm it's working](#confirm-its-working).
<!--T:53-->
If you see different output, open the paper tape (in Plover’s main window under <code>Tools → Paper Tape</code>) and try the steno strokes again. Verify that the right keys are being registered. If the steno keys shown in the paper tape are not the same as those in the middle column above, first make sure you are pressing the right physical keys. If you are still not getting the right output, have a look at the following:
* If you are using a steno machine and are not getting the right keys/output, make sure you have set it up correctly.
* If you are using a QWERTY keyboard and are not getting the right keys/output, your keyboard may not have NKRO. Try rolling or [[arpeggiating]] your strokes.


#### Which NKRO keyboard should I get?
[[Category:Plover]]
 
</translate>
Full NKRO over USB is possible, and many keyboards do it well. Generally, searching for "NKRO" or "anti-ghosting" keyboards will result in compatible keyboards. Make sure to check reviews before purchasing a keyboard as some have been known to falsely advertise NKRO (although, this is a rare occurrence).
 
* See the [[Supported Hardware]] page for a [list of supported keyboards](https://github.com/openstenoproject/plover/wiki/Supported-Hardware#known-supported-keyboards).
* See also: [Which type of key switch should I choose?](https://github.com/openstenoproject/plover/wiki/Supported-Hardware#which-type-of-key-switch-should-i-choose)
 
### Adapt a keyboard for steno use
 
Most keyboards have the keys in staggered rows, which can make it difficult to press two keys in a column with a single finger. To adapt a keyboard for steno, you can use:
 
* [Keytoppers](https://github.com/openstenoproject/plover/wiki/Supported-Hardware#keytoppers)
* [Keycaps](https://github.com/openstenoproject/plover/wiki/Supported-Hardware#keycaps)
 
You can also use [a keyboard with an ortholinear layout](https://github.com/openstenoproject/plover/wiki/Supported-Hardware#nkro-keyboards-with-an-ortholinear-layout).
 
### Use a machine designed for use with Plover
 
Various steno enthusiasts are making and selling machines designed for use with Plover:
 
* [Ecosteno*](https://nolltronics.com/product/ecosteno/)
* [Multisteno*](https://nolltronics.com/product/multisteno/)
* [Polyglot*](https://stenokeyboards.com/products/polyglot-keyboard)
* [Splitography*](https://softhruf.love/products/soft-hruf-erl)
* [Starboard*](https://www.stenography.store/)
* [TinyMod*](https://stenomod.blogspot.com/2018/11/tinymod2.html)
* [The Uni*](https://stenokeyboards.com/)
 
(* = External link)
 
More information: [Dedicated machines designed for use with Plover](https://github.com/openstenoproject/plover/wiki/Supported-Hardware#dedicated-machines-designed-for-use-with-plover).
 
### Use a professional stenography machine
Some professional stenography machines are compatible with Plover. You can find used steno machines on eBay at reasonable prices.
 
See the [[Supported Hardware]] page for a list of supported professional stenography machines.
 
## Confirm it's working
 
Initially, Plover is set up to use your computer's qwerty keyboard by default. If you have a professional stenography machine, or a hobbyist steno keyboard, you'll need to configure Plover to look for your machine (usually GeminiPR or TX Bolt). See each respective vendor's guides on how to set up your keyboard with Plover. See also [this video tutorial](https://www.youtube.com/watch?v=2tp_hSVCKN8) for how to set up a hobbyist steno keyboard that uses Gemini PR.
 
### Keyboard
 
By default, Plover will use your keyboard as its input device.
 
1. Run Plover.
1. Click the Output: **Enable** radio button.
### Write "Hello World"
 
To confirm Plover is working correctly, you may try to write "Hello, world." into a text editor with Plover. Open Plover's main window and, and select Plover's output to be enabled. Open a text editor and write the steno key strokes in the table below, one row at a time.
 
> NOTE: Notepad in Windows 11 is quite buggy with fast input and does not work well with Plover. Instead of Notepad, try a different program such as Microsoft Word or Google Docs in a browser.
 
If you are using a QWERTY keyboard, follow the QWERTY keys on the right column. Otherwise, follow the middle column. Unless you are arpeggiating or rolling your strokes, make sure to press every single key all at once. Remember to release every key after each row.
| Output | Steno Key Stroke | QWERTY Keys |
| ---- | ---- | ---- |
| hell | `HEL` | `r` (left index index) <br> `n` (right thumb) <br> `o` (right ring finger ) |
| o | `HRO` | `rf` (left index finger pressing in between) <br> `v` (left thumb) |
| , | `-RBGS` | `j` (right index finger) <br> `k` (right middle finger) <br> `l` (right ring finger) <br> `;` (right pinkie finger) |
| world | `WORLD` | `d` (left middle finger) <br> `v` (left thumb) <br> `j` (right index finger) <br> `o` (right ring finger) <br> `[` (right pinkie finger) |
| . | `-FPLT` | `u` (right index finger) <br> `i` (right middle finger) <br> `o` (right ring finger) <br> `p` (right pinkie finger) |
 
If you see different output, open the paper tape (in Plover's main window under `Tools → Paper Tape`) and try the steno strokes again. Verify that the right keys are being registered. If the steno keys shown in the paper tape are not the same as those in the middle column above, first make sure you are pressing the right physical keys. If you are still not getting the right output, have a look at the following:
* If you are using a steno machine and are not getting the right keys/output, ensure you are using the right protocol for your [stenography machine](https://github.com/openstenoproject/plover/wiki/Beginner's-Guide:-Get-Started-with-Plover#stenography-machine)
* If you are using a QWERTY keyboard and are not getting the right keys/output, your keyboard may not have NKRO
 
#### Practice sentences
 
You can practice sentences that (mostly) only need two keys at once, on the [StenoJig](https://joshuagrams.github.io/steno-jig/two-key) website.
 
#### Use the correct body posture and finger placement
 
Your fingers should be curled slightly, so you press the keys using the tips of your fingers.
 
![Steno keys on QWERTY keyboard](https://media.discordapp.net/attachments/136953735426473984/856464615469875200/Keyboard_Mapping.png)
 
On a QWERTY keyboard, you move your hands half an inch up so that your left thumb is resting on the cracks between the `C` and `V` keys and your right thumb is resting between the `N` and `M` keys. The rest should fall into place.
 
| QWERTY layout|Maps to steno layout | 
|:---:|:---:|
|`QWER  TY  UIOP[`|`STPH  **  FPLTD`|
|`ASDF  GH  JKL;`|`SKWR  **  RBGSZ`|
|`CV  NM`|`AO  EU`|
 
See also:
 
* [Basic Hand Posture on the Steno Machine](https://www.youtube.com/watch?v=YfHNPW6EnHo)
* [Basic Body Position for Steno Students and Pros](https://www.youtube.com/watch?v=s_zyxgQvNEU)
 
### Stenography machine
 
Plover supports several protocols that are in use by various professional stenography machines. To configure Plover to the protocol your machine uses:
 
1. Run Plover and click the **Enable** radio button.
1. Click the **Configure** button on the Plover Dialog screen. The Plover configuration screen appears.
1. On the **Machine** tab, select the protocol your machine uses.
1. Click **Save**.
 
See [Supported protocols](https://github.com/openstenoproject/plover/wiki/Supported-Hardware#supported-protocols) for more information.
 
## Practice and learn
 
It's time to start learning stenography theory for free, practicing writing using stenography, and learning how to make the most of Plover's built-in tools. See the [Learning Resources](https://github.com/openstenoproject/plover/wiki/Learning-Stenography).
 
### Which steno theory should you learn?
 
There are many steno theories that encompass the rules you use to convert words to steno strokes.
 
Almost all English language steno theories are derived from the original Stenotype theory devised by Ward Ireland. They all share the same keyboard design and basic method of representing the sounds. Theories mostly differ by how much rote memorization is required. Typically, memorization heavy theories are faster.
 
The default theory that comes with the Plover app (called Plover theory) is Mirabai Knight's own personal theory that she uses for stenocaptioning—it is very fast, as a result. However, there are a lot of odd inconsistencies that may not make it a great choice for beginners. Using it requires a lot of personal changes and additions very early on in the learning process.
 
One alternative to Plover is Lapwing theory. It was created by a community member dissatisfied with the unnecessarily steep learning curve associated with Plover theory. It has a comprehensive wiki that covers a wide range of content along with exercises to practise concepts. Many regard it as easier to learn than Plover theory due to having more consistent rules. For details on how to set up and learn Lapwing theory, see the [Lapwing for Beginners Wiki](https://github.com/aerickt/lapwing-for-beginners/wiki).
 
**We recommend learning either Plover theory or Lapwing theory.**
 
Other theories also exist, but either cost money, or are not supported by Plover. Ultimately, it does not matter which theory you choose when it comes to speed—it is always possible to add more memorization into the theory you've chosen to squeeze out more speed. Furthermore, we do not recommend spending money on a theory until you're certain you like stenography and see a clear reason to switch.
</markdown>

Latest revision as of 16:41, 20 March 2026

This guide explains how to get started with Plover. Plover is free stenography software. All the learning resources listed below are free-of-charge.

In order to get started, the main steps are:

  1. Install Plover (the application)
  2. Acquire and connect a keyboard or steno writer
  3. Learn stenography, starting with theory

Download and Install Plover

Plover is an app that translates the strokes you press on your steno machine to entire words. If you do not have a steno machine, Plover can use your regular keyboard as one. It is free to download, and it works on Windows, Mac, and Linux.

Connect a compatible keyboard or stenography machine

Steno involves pressing down groups of keys (called “strokes” or “chords") all at once. Standard QWERTY keyboards can usually only recognize up to six simultaneous key presses, while a dedicated steno writer has no limit to how many simultaneous key presses it can register.

Compatible hardware

See also: Supported hardware

Among other hardware, Plover is compatible with:

  1. Standard keyboards - Requires no additional investment from the average computer user. It is possible to overcome the six simultaneous key presses limitation using arpeggiation. Recommended for those who are unsure whether you want to learn steno. Read the page on using a standard keyboard with Plover.
  2. Hobbyist writers - Pre-built mechanical keyboards specialized for stenography which cost, on average, around $110 USD. Choose from the currently available commercially available hobbyist writers or DIY your own keyboard.
  3. Professional writers - Used by professional stenographers and court reporters, not typically used by the hobbyist community due to their $1000 (used) to $6000 (new) price tags. If you already own one, you can connect it to Plover as long as it uses one of the supported protocols.

With the help of a plugin, it is also possible to use a video game controller with Plover.

Connecting your hardware

Plover connected to a standard keyboard and with Output enabled.

To use a standard keyboard: Plover is set up to use your computer’s typing keyboard by default. You can connect your keyboard by selecting "Keyboard" in the Machine dropdown, and the status message underneath should update to "Connected".

To use a hobbyist or professional writer: see the page on setting up your writer with Plover to connect your hardware to the Plover software. If you're having trouble achieving "Connected" after following the instructions, troubleshoot.

When the "Output" is toggled to disabled, your keyboard will operate as normal and your steno machine will not give any output. When "Output" is toggled to enabled, you will be in steno mode! Plover will type to any place you normally use your keyboard to type (browsers, documents, emails, chat apps, etc.)

Learn and practice

See also: Learning stenography

If you are new to stenography, you can now start learning stenography by memorizing the key layout and choosing a steno theory.

Theory is the set of rules used to learn and write using stenography; a dictionary is an implementation of those rules which allows Plover to interpret your steno strokes and display them in English. Most theories come with a dictionary for you to plug into stenography software, but as your implementation and interpretation changes, so will your dictionary.

If you are new to Plover but not to stenography, upload your dictionary to Plover, learn about Plover's dictionary format, and read the FAQ.

By default, Plover (the software) comes with the dictionary for Plover (the steno theory) already installed.

  • To use this dictionary, you can learn Plover theory.
  • If you want to learn a different steno theory, you can upload their dictionary into Plover (or, in the case of Lapwing, install a plugin).
  • If you have already learned theory and are coming to Plover from a different steno software, you can upload your dictionary into Plover using .rtf format.

Write your first strokes with Plover

To confirm Plover is working correctly, follow this tutorial to write “hello, world.” into a text editor with Plover. Open a text editor and write the steno key strokes in the table below, one row at a time.

format=frameless
format=frameless

Notepad in Windows 11 is buggy with Plover's fast emulated output. Try a different program such as Microsoft Word or Google Docs in a browser, or increase the key press delay.



On a QWERTY keyboard, the steno keys are arranged as follows:

Steno keys on a QWERTY keyboard as understood by Plover.

If you are using a QWERTY keyboard, you may find it helpful to follow the column on the right. Unless you are arpeggiating (rolling) your strokes, make sure to press every single key all at once. Remember to release every key after each stroke.

Output Steno Stroke QWERTY Keys
hell HEL r (left index index)
n (right thumb)
o (right ring finger)
o HRO rf (left index finger pressing in between)
v (left thumb)
, -RBGS j (right index finger)
k (right middle finger)
l (right ring finger)
; (right pinkie finger)
world WORLD d (left middle finger)
v (left thumb)
j (right index finger)
o (right ring finger)
[ (right pinkie finger)
. -FPLT u (right index finger)
i (right middle finger)
o (right ring finger)
p (right pinkie finger)

If you see different output, open the paper tape (in Plover’s main window under Tools → Paper Tape) and try the steno strokes again. Verify that the right keys are being registered. If the steno keys shown in the paper tape are not the same as those in the middle column above, first make sure you are pressing the right physical keys. If you are still not getting the right output, have a look at the following:

  • If you are using a steno machine and are not getting the right keys/output, make sure you have set it up correctly.
  • If you are using a QWERTY keyboard and are not getting the right keys/output, your keyboard may not have NKRO. Try rolling or arpeggiating your strokes.