***NOTE WELL: For successful installation it is essential that you do not
miss out any of the following installation steps:

1. Prior to installing this latest fokSyf Eye R system you should
uninstall any previous version.
[***IMPORTANT: NOTE that I accidentally left in /usr/lib/libespeak.a in
an earlier dotpet upload. It is not required.
You SHOULD delete it manually if it remains after this new installation,
since it is from a prior version of espeak.
However, uninstalling the previous version using PETget
probably removes it anyway...]

2. Install the new dotpet in the usual way. Ignore the three or four
warnings concerning missing dependencies. The next steps sorts that out.

3. Once you have installed this new version,
you need to open a console and execute the following to set up foksy:

foksy setup

[***NOTE WELL: the space between foksy and setup]

4. Then you should reboot your system before using foksy for the first time.

Running fokSyf Eye R:

1. After rebooting, you should then open a commandline window such as
an xterm or an rxvt console,
or you can simply press ctrl alt f2 to leave X windows for a virtual terminal.
In the case of the latter,
you will be asked for a login username and password.
By default the username is root, and there is no password,
so in that case simply press enter when asked for the password.
Note that you can return to the X G U I at any time,
from the virtual console, by simply pressing ctrl alt f3.

2. Once you are ready, to start the speech system simply enter the command:

ifoksy

If you wish, you can then start a fokSyf Eye R User Interface menu program,
by entering the command:

foksy

[*NOTE WELL that you can normally only initialise the
speech system once with the command ifoksy.
If you open a different commandline console later,
and want speech activated in that too,
you will need to enter the command yasr in that new console
before running foksy in there.
However, should speech fail to initialise at any stage,
simply enter the command, foksy --kill, and then you can try ifoksy again].

A help system is provided in foksy.

You can also use one of foksy's options.
For a list of foksy's options enter: foksy -? or foksy --help

Should speech fail to initialise at any stage,
simply enter the command, foksy --kill, and then try ifoksy again.

Yasr does the job of reading whatever data is output by the user
programs being run (e.g. edbrowse), and sending that data via a
speech system management programme called "speech-dispatcher" to the
software synthesiser "espeak" that does the actual "speaking". In
practice, speech-dispatcher allows the speech synthesiser to be
replaced by alternative software or hardware synthesisers and/or
braille capable interfaces (using, for example, the program Brltty).
I haven't yet provided a dotpet for Brltty, since I don't have any
hardware to test it on; however, it is easy enough to compile and it
is likely to be included shortly in foksyf eye r CORE.

The currently provided user applications currently include:

2. Edbrowse

This program is created by Karl Dahlke, who is himself blind from a
very early age. Karl has consequently written edbrowse in such a way
that it is specially tailored for the needs of the visually impaired.
It combines the functions of a text editor, web browser (with secure
certificates ssl support and limited javascript), email (both smtp
send and pop3 receive), ftp, and file management. Edbrowse has a
steep learning curve, but it a great program to use once you have
mastered it. Note that, whilst browsing, edbrowse (version >= 3.3.3)
is now able to read and view many pdf files directly by automatically
converting them to html with the installed pdftohtml converter
utility.

2. Lynx.

This is a more conventional, albeit limited, screen-oriented web
browser. It also includes ssl support, but no javascript. Lynx is
easy to learn though, and it is well-known and respected in the
visually impaired community. Some users may prefer this to edbrowse,
despite its limitations.

3. The vi text editor

This is the classic ex/vi text editor. Unlike edbrowse, which is a
single-line oriented editor partly based on the classic UNIX text
editor ed, vi is a very powerful full-screen editor. However, its
"mode-oriented" nature, makes it difficult for some users to learn.
Nevertheless, there are many good reasons to learn the use of vi: not
only is it available by default on most UNIX/Linux systems, and
extremely flexible, many other applications can also be configured to
use vi keybindings.

4. The sc spreadsheet

This text-console spreadsheet uses vi keybindings for many of its
tasks. Though it is screen-based, the method it uses to write data to
the screen appears to be reasonably compatible with the "speaking
interface" provided by yasr, speech-dispatcher and espeak. It uses
much the same syntax as Excel for its functions, and appears to be
quite fully functioned.

5. krecspk

Krecspk is a hotkey-driven, console-oriented, audio recording program
for producing audio clips or podcasts in a variety of audio formats
such as Ogg Vorbis, mp3, and wav. It relies on the underlying "sox"
commandline utility for its audio recording and playback
functionality. Krecspk has also been specially written with the
visually impaired in mind, and to make it work seamlessly with the
yasr/speech-dispatcher/espeak combination. A "speaking" GUI frontend
for krecspk (called wrecspk) is also available.

6. foksy

This is a simple console-oriented menu system, which can be used to
provide convenient access to the foksyf eye r applications and help files. It
is not particularly sophisticated in its present form, but is
nevertheless quite functional. It also provides a simple help system,
allowing the user immediate access, both spoken and in text form, to
all the help files, tutorials, and readme files associated with the
above applications.

This utility allows foksy to almost seamlessly paste from text
highlighted selections in X, and from the X clipboard. fokSyf Eye R can thus
provide a truly hybrid screen reader experience when used alongside
X applications such as Opera, Seamonkey or Firefox, and X screen magnifiers.

Summary:

One of the major advantages of the fokSyfy Eye R, Screen Environment Reader
is that it is easy to install on various Linux distributions. For
example, it has been tested as working well on Puppy Linux
2.14R, 2.15.1, 3.01and 4.3.1 distributions. It is also extremely resource
efficient and small, being only a few Mbytes in download size.

Once foksyf eye r CORE has been installed, the system is immediately
available from any commandline window on execution of the startup
command: initsp

The user can then either simply use applications directly from the
commandline, or start up the menu/help system environment by
executing: menusp

[Note that the help system files are far from perfect in their
current form, since much of their content is simply rehashed forum
posts].

In summary, I wish to state my appreciation of the help I have been
receiving from Karl Dahlke, with regard to edbrowse usage and
functionality. Karl is in regular email touch with me and has gone
out of his way to patch edbrowse in such a way that it is more
functional for the Puppy Linux community in general.

mcewanwLast edited by mcewanw on Mon 20 Mar 2017, 06:21; edited 114 times in total

Note on yasr documentation:If you install yasr, from the dotpet I've created, you will find a man page, readable in a text editor at this location:

/usr/local/share/man/man1/yasr.1

I imagine the same can be found on the SpeakPup iso (http://www.murga-linux.com/puppy/viewtopic.php?t=24571).

The thing of most interest are the commands available in yasr, and the default keybindings.

However, it's probably easier to read the readme file that came originally in the yasr source files. I've attached a copy with this post. The forum doesn't allow no extension or dottxt extension files so I compressed it as a tar.gz which you'll have to decompress somewhere to read it. It shows commands such as alt-r for toggle review mode, and alt-w for read whole screen, and alt-l (alt-ell) for read line.

***A very powerful pre-configured for murga forum dotpet of edbrowse now uploaded***

Sorry, to the large numbers who downloaded the previous dotpet, since you will need to now download this new one if you wish to experience the new murga forum macro functions. Add your name to this thread once you have managed to send your first post to murga forum using edbrowse You'll need to consult the supplied READMEs and also the edbrowse documentation which the dotpet installs at /usr/local/share/doc/edbrowse/edbdoc.html

edbrowse is a commandline combined line-oriented text editor, email, and web browser program with javascript and ssl support.

I've uploaded a new dotpet which is more fully configured for use with Puppy linux. It comes with specially written macro functions scripts for easy web-browsing of murga puppy linux forum (including making reply posts).

I've temporarily attached the new dotpets and associated readme files to the top post of this thread until such time as they find their permanent home.

Compiled on Puppy version 2.17.1 but tested on both 2.17.1 and 3.01.

This works well with yasr/speech-dispatcher and espeak.
Refer to this thread for more details about edbrowse:

http://www.murga-linux.com/puppy/viewtopic.php?p=174227#174227

Once you have installed it, you will find documentation (usage/commands etc) in /usr/local/share/doc/edbrowse/edbdoc.html

Something went wrong on my upload of speechdispatcher-0.6.5.pet and its md5sum turned out to be wrong. I'm in process of re-uploading and have asked Eric (Caneri) to refetch the file. My slow dialup is slowing my checking/re-uploading down though, so please be patient and come back to re-download that one file later (I'll post a message once it is ready).

Downloaded all the pets this evening, and all seems to be running well on a Dell 610 laptop running 2.14R (phoenix remaster version). Now its a case of flagellating myself with the birch twig that is edbrowse!! No Pain, No Gain!!!
Actually I have got on to the internet with it, mainly with the help of your examples, but have to confess I'm on Seamonkey at the moment.
I'm fully sighted, but work in the VI field, so I've been following your work (and the others, Trobin etc) with interest. Only wish I had the skills to help out.....

Thanks for that feedback Keef, and I hope you are not feeling too much pain from the birch.

You may be happy to know that I have at last found how to update the ssl certificate file in edbrowse and have modified its config script to work well with my change accordingly. I am thus at this second in the process of uploading a new dotpet of edbrowse which contains the config changes (to Caneri's ScreenReaderEnviro repository). I am uploading the ssl certificate file itself as a separate dotpet because certificates do need to be updated from time to time. I'll post another message to let everyone know when the upload is complete with its md5sums tested.

If you have been following the Speaking Pup for the Blind thread today at all you may already have noticed that I have provided some instructions there for logging into the likes of Yahoo and Google email.

Thanks again for your post and I hope some of the work proves useful to the visually impaired, since that would make it all the more worthwhile. Of course, the real thanks has to go to Karl Dahlke who wrote the wonderful edbrowse program. All I am doing is some configuration that hopefully works in Puppy Linux.

On its author's advice I have recompiled edbrowse from its cvs sources and uploaded a new dotpet accordingly. I've also uploaded a new version of krecspk, specially crafted for use with edbrowse and now fully compatible with yasr and speech-dispatcher out of the box.

Sorry, I had no sooner upload krecspk and was using it, when I discovered I had overlooked something I could easily fix. So I "fixed it" and have re-uploaded the dotpet. Same version number. It is a small file. If in doubt, reinstall it!

The screen reader environment now also includes the lynx webbrowser and vi. The menusp dotpet and sreREADMEmain.txt has been modified to reflect these additions. The ssl certificates file has now been moved to the standard openssl location, allowing the same cacert file to be shared by edbrowse and lynx. The edbrowse dotpet has thus been modified to point to the new ssl cert location.

Visit top post of this thread for any further details and download instructions:

I noticed that Lynx didn't store cookies persistently by default, so I have now set it to store them. I also reduced some of the preset delays associated with message text - makes it a little faster to use and doesn't ask quite so many questions about cookies. I've re-uploaded the tuned up version to Caneri's site as before.

You cannot post new topics in this forumYou cannot reply to topics in this forumYou cannot edit your posts in this forumYou cannot delete your posts in this forumYou cannot vote in polls in this forumYou cannot attach files in this forumYou can download files in this forum