Beginner's guide: Difference between revisions

From Plover Wiki
(First pass at creating page based on markdown to mediawiki wtih pandoc. Still needs images and captions into mediawiki format.)
 
(Remove converted page and redirect to correct page)
 
Line 1: Line 1:
This guide explains how to '''get started with Plover'''. Plover is free stenography software. All the learning resources listed below are free-of-charge.
#REDIRECT [[Beginner's_Guide]]
 
== Overview ==
 
The main steps are:
 
# [[#download-and-install-plover|Download and install the Plover application.]]
# [[#connect-a-compatible-keyboard-or-stenography-machine|Connect a compatible keyboard or stenography (steno) machine.]]
# [[#confirm-its-working|Confirm it's working.]]
# [[#practice-and-learn|Practice and learn stenography using Plover.]]
 
== Download and Install Plover ==
 
Plover works on '''Windows, Mac, and Linux'''.
 
* [https://github.com/openstenoproject/plover/wiki/Installation-Guide '''Download and install Plover with the Installation Guide 🚀''']
* If you get stuck, see the [https://github.com/openstenoproject/plover/wiki/Troubleshooting:-Common-Issues troubleshooting guide].
 
== Connect a compatible keyboard or stenography machine ==
 
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.
 
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: * [[#use-a-standard-qwerty-keyboard|Use a standard QWERTY keyboard]] * [[#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 ===
 
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.
 
==== Arpeggiate ====
 
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.
 
Arpeggiate gif:
 
https://media.discordapp.net/attachments/1034561065654161478/1200852241993715863/keyboard-arpeggiate.gif
 
To enable arpeggiate, open Plover's main window and press <code>Configure</code>. Under "Machine" enable <code>Arpeggiate</code> and click <code>Apply</code> and <code>OK</code> when you are done.
 
arpeggiate option:
 
https://github.com/openstenoproject/plover/assets/52895314/5467e672-7306-43d8-83fb-6f771a5802ef
 
==== Rolling your strokes ====
 
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.
 
https://cdn.discordapp.com/attachments/136953809409802240/1173317394022801488/keyboard-roll.gif
 
Regardless of if you roll or arpeggiate your strokes, make sure you [[#confirm-its-working|confirm it's working]].
 
=== Use an N-key rollover (NKRO) QWERTY keyboard ===
 
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.
 
Be sure to try the example later in this page to [[#confirm-its-working|confirm it's working]].
 
==== Which NKRO keyboard should I get? ====
 
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 [https://github.com/openstenoproject/plover/wiki/Supported-Hardware#known-supported-keyboards list of supported keyboards].
* See also: [https://github.com/openstenoproject/plover/wiki/Supported-Hardware#which-type-of-key-switch-should-i-choose 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:
 
* [https://github.com/openstenoproject/plover/wiki/Supported-Hardware#keytoppers Keytoppers]
* [https://github.com/openstenoproject/plover/wiki/Supported-Hardware#keycaps Keycaps]
 
You can also use [https://github.com/openstenoproject/plover/wiki/Supported-Hardware#nkro-keyboards-with-an-ortholinear-layout a keyboard 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:
 
* [https://nolltronics.com/product/ecosteno/ Ecosteno*]
* [https://nolltronics.com/product/multisteno/ Multisteno*]
* [https://stenokeyboards.com/products/polyglot-keyboard Polyglot*]
* [https://softhruf.love/products/soft-hruf-erl Splitography*]
* [https://www.stenography.store/ Starboard*]
* [https://stenomod.blogspot.com/2018/11/tinymod2.html TinyMod*]
* [https://stenokeyboards.com/ The Uni*]
 
(* = External link)
 
More information: [https://github.com/openstenoproject/plover/wiki/Supported-Hardware#dedicated-machines-designed-for-use-with-plover 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 [https://www.youtube.com/watch?v=2tp_hSVCKN8 this video tutorial] 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.
 
# Run Plover.
# 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.
 
<blockquote>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.
</blockquote>
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.
 
{|
!width="6%"| Output
!width="6%"| Steno Key Stroke
!width="6%"| 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)
|}
 
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, ensure you are using the right protocol for your [https://github.com/openstenoproject/plover/wiki/Beginner's-Guide:-Get-Started-with-Plover#stenography-machine 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 [https://joshuagrams.github.io/steno-jig/two-key StenoJig] 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 <code>C</code> and <code>V</code> keys and your right thumb is resting between the <code>N</code> and <code>M</code> keys. The rest should fall into place.
 
{|
!align="center"| QWERTY layout
!align="center"| Maps to steno layout
|-
|align="center"| <code>QWER  TY  UIOP[</code>
|align="center"| <code>STPH  **  FPLTD</code>
|-
|align="center"| <code>ASDF  GH  JKL;</code>
|align="center"| <code>SKWR  **  RBGSZ</code>
|-
|align="center"| <code>CV  NM</code>
|align="center"| <code>AO  EU</code>
|}
 
See also:
 
* [https://www.youtube.com/watch?v=YfHNPW6EnHo Basic Hand Posture on the Steno Machine]
* [https://www.youtube.com/watch?v=s_zyxgQvNEU Basic Body Position for Steno Students and Pros]
 
=== Stenography machine ===
 
Plover supports several protocols that are in use by various professional stenography machines. To configure Plover to the protocol your machine uses:
 
# Run Plover and click the '''Enable''' radio button.
# Click the '''Configure''' button on the Plover Dialog screen. The Plover configuration screen appears.
# On the '''Machine''' tab, select the protocol your machine uses.
# Click '''Save'''.
 
See [https://github.com/openstenoproject/plover/wiki/Supported-Hardware#supported-protocols 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 [https://github.com/openstenoproject/plover/wiki/Learning-Stenography Learning Resources].
 
=== 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 [https://lapwing.aerick.ca Lapwing for Beginners].
 
'''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.

Latest revision as of 15:12, 29 August 2024

Redirect to: