Thank you for your interest in F123 (pronounced F 1 2 3). This document is organized in sections so that you may easily jump to specific topics that interest you. Screen reader users can quickly find section titles and subtitles using the various header levels from 1 to 6.

1 Latest Release

1.1 Download

This release is still Alpha code, which means that it is under development and it has important problems and limitations.

We have a single installation file for all available languages, but not all translations are equally complete. Some work remains to be done and any help is most welcome.

You can find the compressed image file here: https://public.f123.org/F123Light-19.09.12.img.xz

We are also including the sha1sum signature for the image file, so you can verify file integrity after download. Please note that the image is compressed with the xz format, which is more efficient than the zip format. You may find information on how to uncompress xz files here.

1.1.1 The First Time You Turn-On the Computer

During the first time you start or boot the computer, the software will auto-expand the partition and file system to match the size of the Micro-SD card, so it can take a minute and a half or more for the Raspberry Pi 3B+ computer to be ready. Subsequent boots will be faster, i.e. around 30 seconds.

1.1.2 Default Username and Passwords

the default username is: f123

The default user and admin password is lowercase: f123

The hostname is (lowercase): f123light

Advanced users can easily build images with WiFi and other passwords already set to personalized values. Information on custom images can be found here.

1.2 Burning/Flashing the F123Light Image File to the Micro-SD Card

Once you download and verify the integrity of the compressed version of the image file, you must uncompress this file and flash or burn it to the micro-SD card which you will use on the Raspberry Pi computer. We recommend that you use a micro-SD card of at least 16Gb in size, but an 8Gb card should also work, even though little disk space will be available for your own files.

The expressions “flash” or “burn the image” is used because this is not the same as a copy and paste file transfer. While there are many ways to “flash” the image to the card, we have heard good things about both Etcher and Rufus software. Etcher apparently works well in Windows, Mac, and Linux, whereas Rufus works well on Windows.

It is also worth mentioning that burning an image will not prevent you from reformatting or burning other images on the SD card in the future. In other words, even though people use the word “burn”, the process is not permanent. It is just another method for temporarily saving a file.

1.3 Updating the F123Light Operating System

In the “Main Menu” there is a sub-menu called “Settings”, which has an option that makes it easy to update the system, called: “Check for system updates”

Thanks to this option, it is usually not necessary to flash a new image or use complicated commands whenever a new version of F123Light is available. However, we do recommend that you stay in touch with our team, as at this stage in the project, new versions are sometimes experimental, and are not recommended for all users.

If you are a technically-oriented or advanced computer user, you might want to explore the more advanced options described in our technical guide.

To make sure you hear of changes and improvements to F123Light, join one of our e-mail lists.

2 Developers and Other Advanced Users

2.1 Updating F123Light on the Command Line

Advanced users can perform an update from the command line with the command: “update-f123light”

If such a user is helping us test recent changes to the code, he or she can use a special parameter to update from the development branch. To specify the development branch, the correct command would be: “update-f123light -b dev

2.2 Building Your Own F123Light Image

Experienced users also have the option of generating or building their own image. Every copy of F123Light includes the command “build-f123light”, which automatically generates the image file, which can then be burned or flashed to a MicroSD card for use. Please make sure your working SD card has at least 16Gb of free space to perform this procedure. You may lern more about building your own image in our resources for advanced users page.

2.3 Acknowledgements

Our work is only possible thanks to a wide variety of persons and organizations, from volunteers and our own users, to developers, translators, journalists, teachers, funders, and many more. Thank you all!

3 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.

3.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.

3.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.

3.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.

3.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.

3.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.

3.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

3.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.

3.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.

4 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.

4.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

4.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

4.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

4.2 Configuring Bluetooth

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

4.2.1 Getting Started with Bluetooth Connections

4.2.1.1 Pairing Headsets and Speakers

4.2.1.2 Pairing a keyboard

4.2.2 All Devices Are Paired and Connected

4.3 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.

4.3.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.

4.3.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 [

4.4 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.

4.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.

4.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.

5 Finding or Offering Help

5.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:

5.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.

5.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.

5.2.2 Technical List in English

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

5.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

5.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

5.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

5.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/

5.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.


This document is version number: 19.10.17


This work by F123 Consulting is licensed under a Creative Commons Attribution-NonCommercial-ShareAlike 4.0 International License. We also have another way for you to freely use our content, if this license does not meet your needs. Contact us for alternative licensing options.