Screen reader users: Most keyboard commands can be easily found under level three headings. Please note that we strongly recommend that you do not update F123Light until a new version is announced on [our e-mail lists](https://guide.f123.org/).

F123Light User Guide

October 30, 2019

1 Initial F123Light Configuration

The very first time you start-up your computer with the MicroSD card containing F123Light, the start-up or boot process will take longer than usual, as the system is uncompressing and preparing the file system for use. The larger the capacity in your MicroSD card (i.e. the more memory it has), the longer this process will take. In any case, it will generally be two or three minutes at the most.

If you are blind and you are reading this document with a screen reader, you will find that it is very easy to navigate it by using headings. In addition to the usual hierarchical organization where level one headings are chapters and the other levels sections of those chapters, you can also generally find tables containing keyboard shortcuts under level three headings.

1.1 Basic Commands for the F123Light Version of the Orca and Fenrir Screen Readers

Most users will be very happy to know that for maybe the first time in history, using a new screen reader will not necessarily require you to learn new keyboard commands. This is because, if you already use the NVDA screen reader, you will probably feel right at home with the key combinations used by Orca and Fenrir, the two screen readers used on F123Light.

1.1.1 Controls for Speech Volume, Rate, and Pitch

Just like in NVDA, you can use Insert, Control, and the arrow keys to modify speech parameters like volume, rate, and pitch. Insert, also called the Orca key or the NVDA key, depending on which manual you are reading, can also be the CapsLock key, if you are using the screen reader in laptop mode.

Since F123Light has two screen readers, instead of calling the Insert and Caps Lock keys Orca or Fenrir or NVDA key, we will simply call it reader, as in screen reader key. So holding down Caps Lock or Insert and pressing F12 to hear the time, will be reader+F12.

To change speech volume, rate, or pitch, hold down reader+Ctrl and use the left and right arrow keys to select if you want to change volume, rate, or pitch. Once you are on the parameter you wish to change, use the up and down arrow keys to increase or decrease that parameter.

Once the speech volume, rate, or pitch is at the level you desire, simply release the reader and the Control keys, and continue using your computer normally.

1.1.2 Using Tutorial, Help, or Learn Mode

Pressing reader+1, your screen reader will activate its “Tutorial Mode”, which allows you to press just about any key, and hear its name and function, if it has a special screen reader function. When you are in “Tutorial Mode”, you can press keys and, other than telling you what they normally do, the system will not do anything else. It is an excellent way to learn your way around the screen reader and your keyboard.

To deactivate “Tutorial Mode”, simply press ‘Escape’, also often labeled as ‘ESC’. The ‘Escape’ key is found usually at the top left of most keyboards.

1.1.3 Reviewing the Screen

Just like with most screen readers, both Orca and Fenrir use the numeric keypad on the full desktop keyboard for many of its commands. This is especially true for those which involve movement, such as reading previous or next line, word, or character.

Assuming that you are using a full-size desktop keyboard, which has a numeric keypad to its right, you can use: numbers 7, 8, and 9, to read previous, current, and next line; numbers 4, 5, and 6, to read previous, current, and next word; and numbers 1, 2, and 3, to read previous, current, and next character.

If you are using F123Light in laptop mode, in other words, assuming you do not have a numeric keypad on your keyboard, then you must hold down the CapsLock key and press letters U, I, and O, for previous, current, and next line; letters J, K, and L, for previous, current, and next word; and M, comma, and period, for previous, current, and next character.

To easily toggle between desktop and laptop keyboard mode on the screen reader, just use reader+Left-Shift.

Of course, if you used our fast language switching command to change language, the keyboard layout as well as the instant spell checker, will also change. However, the location remains the same. You will still use your right hand in its standard positioning on the keyboard, to read around the screen when holding down the CapsLock key.

1.2 Selecting the Operating System Language

The very first version of F123Light is available in English and Brazilian Portuguese, and will shortly be available in Spanish and Arabic. Please join the e-mail list corresponding to the language you are interested in, and you will be notified when it becomes available.

The first time F123Light loads, it gives you a chance to select the language you will use the system in. Press ‘Enter’ for English, or use the up and down arrow keys to select another option and press ‘Enter’. Once you do this, the system will make a sound and restart in the language you selected.

If you selected a language which is still not officially supported, the interface might still not be entirely translated.

1.3 Change System Passwords

Another question that comes-up when you boot your computer for the first time, relates to changing system passwords. If you are just testing the system and have no plans to use it for more than a few minutes, then there is no nee for you to change system passwords. However, if you will use the system for more than just a few minutes, we recommend that you change the default passwords.

If you press “Enter” for “Yes”, you will have a chance to change both the password for the normal user, and the administrator’s password. Here is some information which might come-in handy:

The name of the default user in F123Light is: f123

Please note that this name is with a lowercase “f”.

The default password for the normal user is exactly the same: f123

The default name of the root or administrator, is: root

Here also, the name is entirely in lowercase.

The default password for the administrator or root user is exactly the same, also in lowercase: root

1.4 Configuring WiFi

The quickest way to get internet access is usually to just plug-in an Ethernet cable connected to a router providing that access. However, most often people end-up using wireless access through WiFi.

The configuration process which helps you setup your system when you turn it on for the first time, will also help you configure WiFi, since this access will be required when it is time to select the region where you live.

Setting-up WiFi is easy, just use the up and down arrow keys to select the name of your WiFi network from the provided list and press ‘Enter’.

Next, enter the password for that WiFi network or access point.

1.5 Selecting Your Region

The F123Light operating system sometimes needs to know where in the world you are located. This is helpful so it can find out what day and time it is, and it can then figure-out if, for example, a new update to the software is actually new.

First you must use the up and down arrow keys to select the region where you are and then press ‘Enter’.

Then you need to select the city where you live from a list and again press ‘Enter’. Since the list only contains the largest cities, your own city might not be on the list. If this happens, please select another city which is near-by, or at least in the same timezone.

You can quickly jump to city names by pressing the first letter of the name, and then continuing to search with the up and down arrow keys.

1.6 Configuring Bluetooth

Connecting bluetooth devices such as headsets and keyboards is fairly straightforward in F123Light.

1.6.1 Getting Started with Bluetooth Connections

1.6.1.1 Pairing Headsets and Speakers

1.6.1.2 Pairing a keyboard

1.6.2 All Devices Are Paired and Connected

1.7 Fast Language Switching

If you know more than one language, you can quickly switch between them with the Orca screen reader. You can use the same key combination you used to change speech volume, rate, and pitch. Instead of moving to the right, you move with the left arrow once to the left, and use the up and down arrow keys to choose between the languages you know.

How does F123Light know which languages you can speak, you might ask. Well, it doesn’t, but there is an easy way for you to tell it. To add or remove a language, simply open “Configure fast language switching” located under the “Settings” menu.

2 Introduction to the Basics

In this section we will describe the commands and shortcuts you can use for routine operations with F123Light. Since the system is undergoing rapid development, there may be times in which the documentation does not perfectly match the latest version of the software. If you encounter difficulties, please let us know through one of our e-mail lists.

2.1 Opening Key Applications

The following are key combinations which can be used to open some applications in F123Light. Please note that when more than one key must be pressed together, they will be shown with a plus symbol between them. You can assume that it is best to press and hold the first key, then the second with it, and in some cases, a third key afterwards. So Ctrl+Alt+O, should not be pressed starting with the letter “o”. In addition, a comma will be used when the keys must be released and new ones pressed, as in this example:
Alt+Escape, Shift+O

2.1.1 General Keyboard Shortcuts to Open Applications

Keys Action Comment
Ctrl+Alt+W Opens web browser Browser can be changed in ‘Settings’
Ctrl+Alt+F Opens file manager -
Ctrl+Alt+M Opens e-mail client usually Mozilla Thunderbird
Ctrl+Alt+T Opens text editor The default text editor is Pluma
Ctrl+Alt+N Activates screen reader Ctrl+Alt+O also works
reader+Alt+S Resets screen reader Resets to factory defaults
Ctrl+Alt+I Opens instant messenger Compatible with Telegram and other networks
Ctrl+Alt+H Opens user guide Not yet implemented

2.1.2 General Keyboard Shortcuts for F123Light

Keys Action Comment
Alt+F2 Run dialog Enter a command to open an application which is not on the menus
Alt+F4 Closes current window Ctrl+Q also closes application
Alt+Tab Switch active window Switches to another open application
Ctrl+F12 Toggles microphone Toggles microphone on Mumble on and off, if Mumble is running
Ctrl+Escape Opens main menu Pressing ‘Super’ or ‘windows’ key has same effect
Alt+F1 Opens main menu Pressing the ‘Super’ or ‘windows’ key has the same effect
Alt+Escape and F1 Call for help Allows someone on our team to remotely access your computer when you need help
Shift+F10 Right click Simulates a right click with the mouse (context key, to the left of right Control key does the same)
reader+Left-Shift Toggles reader layout Toggles between laptop and desktop mode
Alt+Left-Shift Keyboard switch Toggles between non-US and US keyboard layout
Alt+Escape and C Open command line Recommended for experienced users

2.2 An Introduction to the Text Editor

The default text editor in the F123Light system is called Pluma. This editor is small in size, fast, easy to use, and feature rich. You can open it from the ‘Office’ menu or by pressing Ctrl+Alt+T.

The keyboard shortcuts or key bindings used in the F123Light version of Pluma are set so that anybody who has used an editor under Windows or other graphical user interfaces (GUIS), will have a very easy time using it. Just like with other systems, you can easily get to the menu by pressing F10, or if you know which submenu you want and its shortcut key, you can go directly with something like Alt+F for the ‘File’ menu.

2.2.1 Keyboard Shortcuts for Menus in the Pluma Text Editor

Keys Action Comment
F10 Opens menu bar Move left and right with arrows to choose a submenu and up and down to choose from within menu
Alt+F File menu Includes new, save, save as, etc.
Alt+E Edit menu Includes insert date and time, preferences, etc.
Alt+V View menu -
Alt+S Search menu Includes find, replace, go to, etc.
Alt+T Tools menu Includes spellchecker, set language, document statistics, etc.
Alt+D Documents menu -
Alt+H Help menu -

You will also notice that for some functions, more than one shortcut is available. This is because depending on what editor you use the most, you might for example, close a document with Ctrl+W or maybe with Ctrl+Q. Since both combinations work on F123Light’s version of Pluma, you will probably be able to just keep using what you are used-to.

2.2.2 Keyboard Shortcuts for Frequent Operations in the Pluma Text Editor

Keys Action Comment
Ctrl+O Open file Does not close any previous files you have open
Ctrl+S Save current file.
Ctrl+Shift+S Save as Save current file with a new name
Ctrl+w Close document Will prompt you to save the document if recent changes have not been saved
Ctrl+q Quit Pluma Will prompt you if one or more documents have not been saved after recent changes
Alt+F4 Quit Pluma Will prompt you if one or more documents have not been saved after recent changes
Shift+F7 Activates spellchecker -
Shift+arrow-keys Highlight text Once highlighted the text can be cut, copied, and pasted with Ctrl+X, Ctrl+C, and Ctrl+V
Ctrl+left or Right arrow Moves one word A quicker way to move within sentences
Ctrl+Backspace Erase one word A quicker way to erase an entire word
Ctrl+Home Move to top of document -
Ctrl+End Move to bottom of document -
End Move to end of line -
Home Move to beginning of line -
Alt+number Switch to another document/tab Same as in Firefox and file manager
Ctrl+f Find text -
Ctrl+h Find and replace [

2.3 Introduction to the File Manager

The file manager in F123Light is called PCmanFM, and using it is much easier than remembering its name. In fact, if you are used to windows Explorer or nautilus, you will feel right at home.

You can open the file manager by pressing Ctrl+Alt+F, or by navigating down with the arrow keys on the main menu.

Once the file manager is opened, you can always press F10, and then use the left and right arrow keys to select a submenu and up and down arrow keys to select a menu option. howevr, with the key combinations listed below, you will get things done much faster.

Advanced users who are using the console or text-based version of F123Light, will have access to DragonFM, which follows most of the key combination conventions listed here, but not all. As soon as that file manager is ready, we will create a table with its commands.

Please note that we will use the words directory and folder, interchangeably, to mean an area of the disk or memory card which can contain multiple files and folders.

2.3.1 Keyboard Shortcuts for Menus in the File manager

Keys Action Comment
Enter Open file or folder -
Del or Delete Deletes file or folder -
F2 Rename file or folder -
F4 Opens command line Type ‘exit’ to return to file manager
F10 Activates menus -
Ctrl+Shift+N New folder -
Ctrl+Alt+N New file Creates a new text file
Alt+Home Go to home folder -
Backspace Previous folder -
Typing Jumps to file Easy way to find a file with those beginning letters
Ctrl+T Open new tab -
Alt+number Switch to another tab -
Ctrl+Tab Switch to next tab Ctrl+Shift+Tab goes in opposite direction
Home Jumps to top file or folder -
End Jumps to last file or folder -
Shift+F10 Properties of file or folder -

2.4 Introduction to the Web Browser on F123Light

If you have used Mozilla Firefox or Google Chrome on windows, you will feel right at home with those same browsers on F123Light. At time of writing, the default browser is Firefox, but you can change that by going to ‘Settings’ on the main menu.

You can open the browser by going to the ‘Internet’ menu or by pressing Ctrl+Alt+W. The main menu containing the ‘Internet’ submenu can be activated by pressing Ctrl+Escape or Alt+F1.

2.4.1 Keyboard Shortcuts for Actions in the Browser

Keys Action Comment
Ctrl+L Open web page Enter the address or search key words
Tab and Shift+Tab Next and previous link -
Ctrl+Tab Switch to another tab Ctrl+Shift+Tab goes in opposite direction
Alt+number Switch to another tab Useful when many tabs are opened
H and Shift+H Next and previous header Jumps to header
Numbers 1-6 Jump to specific header level Shift+number will jump backwards
K and Shift+K Next and previous link -
L and Shift+L Next and previous list -
B and Shift+B Next and previous button -
E and Shift+E Next and previous edit field -
R and Shift+R Next and previous radio button -
T and Shift+T Next and previous table -
X and Shift+X Next and previous checkbox -
C and Shift+C Next and previous combo box -
P and Shift+P Next and previous paragraph -
Spacebar Check and uncheck useful in checkboxes

2.5 Getting Remote Assistance

If you are ever stuck, or have broken something and cannot figure out how to fix it, one of our team members may be able to help you. If you go to the help menu and select “Request remote assistance with my computer”, a request for help will be issued to the F123 team.

To get help simply write a brief description of the problem you have. To send the request, type . on a line by itself.

Please note that this service is experimental at this point and is not yet available 24 hours a day, and for now, it is only available in English. In the near future we will share more details on time and language options in our lists and blog.

2.5.1 Important Notice on Remote Assistance

Requesting remote assistance allows a team member full access to your computer. Anything the root user can do is available to the support staff who answers your request for assistance. You can request a log of everything done in the help session.

3 Finding or Offering Help

3.1 Contributing Time, Talent, Contacts, Etc

If you value the work we do, please help us out. You can help in many ways. here are some ideas:

3.2 Our E-mail Lists

To join any of the following e-mail lists, you can send a blank e-mail message to the indicated address. You will then receive an e-mail message from the list, requesting confirmation. Just responding to that confirmation e-mail, i.e. pressing “reply” on your e-mail software, and sending the message without writing anything wil confirm and subscribe you to the list.

3.2.1 Announcements List

If all you want is to get an occasional e-mail from us, sharing the latest news, join our announcement list. The plan is to send just one message per month, maybe even less.

3.2.2 Technical List in English

Technically inclined users who can communicate in English should subscribe e-mailing F123e+subscribe@groups.io

3.2.3 General-Purpose List in English

English speakers who are not developers or technically inclined, but are interested in the project for day-to-day use in note-taking, office work, project management, and other activities, subscribe by sending an e-mail to F123-Visual-English+subscribe@groups.io

3.2.4 General-Purpose List in Spanish

Non-technical users who speak Spanish can join our group by sending an e-mail message to F123-Visual-espanol+subscribe@groups.io

3.2.5 General-Purpose List in Portuguese

Non-technical users who speak Portuguese can join by sending an e-mail message to F123-Visual-portugues+subscribe@groups.io

3.2.6 Social Networks

Those who want to keep in touch with the project through social networks, should know that we rarely respond to posts on social networks. Ideally, please get in touch with us via the above lists or via direct e-mail. If you wish to share a link about our project with others, please share this one:
https://guide.F123.org/

3.3 Contacting Our Team Directly

Some messages are best sent directly to our team. E-mail messages in English can be sent to this address, in Spanish to this address, and in Portuguese to this address.

Screen reader users: Most keyboard commands can be easily found under level three headings.

Please note that we strongly recommend that you do not update F123Light until a new version is announced on our e-mail lists.


This document is version number: 19.10.30