Screen reader for individuals who are blind or visually impaired

Joanmarie Diggs 35b663978b Handle yet another object going defunct on us 17 hours ago
docs 87ad4a2ea1 Fix typo in docs (pytaspi -> pyatspi). 2 years ago
help 0279b0b22d Update Hungarian translation 1 month ago
icons 67179fbff2 Distribute symbolic icon 3 years ago
m4 05a9c58205 Add pkg.m4 and yelp.m4 to .gitignore 2 years ago
po 0ec98293a6 Updated Czech translation 19 hours ago
src 35b663978b Handle yet another object going defunct on us 17 hours ago
test 89fb65336a Python 3.6 invalid escape sequence deprecation fixes 1 year ago
.cvsignore fdf01ce7b1 Add orca.desktop. 12 years ago
.gitignore d5c72bb358 Add /help/*/*.stamp to .gitignore 5 years ago
AUTHORS fa133df521 Update AUTHORS and MAINTAINERS 8 years ago
COPYING ef3057da93 Upgrade from LGPLv2 to LGPLv2.1. 8 years ago
ChangeLog d461ff3c1e Autogenerate ChangeLog 9 years ago
ChangeLog-pre-2.27.1 d461ff3c1e Autogenerate ChangeLog 9 years ago
HACKING c96465d284 Administrivia 13 years ago
MAINTAINERS ef7c01b7d7 Updating the maintainers 6 years ago 500d4ca4a9 Remove .desktop file 2 years ago
NEWS aeab0d2713 Prep for Orca v3.30.0 release 1 month ago
QUICKSTART c1b2095940 doap: update URLs 4 years ago
README 2d9c29fe98 Post-release version bump 1 month ago
RELEASE-HOWTO c1b2095940 doap: update URLs 4 years ago
TODO 8123f82da4 Prep for Orca v1.0.0. 12 years ago
acinclude.m4 0c0be16f1a Avoid incorrectly detecting python modules which are in fact not installed 6 years ago 5431054194 Support non-srcdir builds in 2 years ago 40860bd844 Add initial support for Smuxi (gnome frontend) 2 weeks ago efa3af6624 Tweak for the fix for bug 736237 - Enable autostart on additional DEs 4 years ago
orca.doap 7c21c1edaa doap: add <programming-language> 4 years ago
pylintrc 0ad23286db Spelling fixes 1 year ago 3abf4d6c19 Updated to work with git. 9 years ago


Orca v3.30.1pre


Orca is a free, open source, flexible, and extensible screen reader
that provides access to the graphical desktop via user-customizable
combinations of speech and/or braille.

Orca works with applications and toolkits that support the assistive
technology service provider interface (AT-SPI), which is the primary
assistive technology infrastructure for the Solaris and Linux
operating environments. Applications and toolkits supporting the
AT-SPI include the GNOME GTK+ toolkit, the Java platform's Swing
toolkit, OpenOffice/LibreOffice, Gecko, and WebKitGtk. AT-SPI support
for the KDE Qt toolkit is currently being pursued.

See also for detailed English and Spanish
information on Orca, including how to run Orca, how to communicate
with the Orca user community, and where to log bugs and feature


Orca v3.30.x is supported on GNOME 3.30.x only. We highly suggest you
use the latest releases of GNOME because they contain accessibility
infrastructure and application bug fixes that help Orca work better.

Orca also has the following dependencies:

* Python - Python platform (minimum version 3.3)
* pygobject-3.0 - Python bindings for the GObject library
* gtk+-3.0 - GTK+ toolkit
* json-py - a JSON ( reader and writer in Python
* python-speechd - Python bindings for Speech Dispatcher (optional)
* BrlTTY - BrlTTY support for braille (optional)
* BrlAPI - BrlAPI support for braille (optional)
* py-setproctitle - Python library to set the process title (optional)
* gstreamer-1.0 - GStreamer - Streaming media framework (optional)


NOTE: If you have multiple versions of the Python interpreter installed
on your machine, you should set the PYTHON environment variable when
configuring Orca. For example:

PYTHON=/usr/bin/python3.3 ./


PYTHON=/usr/bin/python3.3 ./configure


Orca depends upon the Python bindings for BrlAPI available in BrlTTY v4.5
or better. You can determine if the Python bindings for BrlAPI are
installed by running the following command:

python -c "import brlapi"

If you get an error, the Python bindings for BrlAPI are not installed.

See also for more information on
BrlTTY and also using liblouis for contracted braille.

Running Orca

If you wish to modify your Orca preferences, you can press "Insert+space"
while Orca is running.

To get help while running Orca, press "Insert+H". This will enable
"learn mode", which provides a spoken and brailled description of what
various keyboard and braille input device actions will do. To exit
learn mode, press "Escape." Finally, the preferences dialog contains
a "Key Bindings" tab that lists the keyboard binding for Orca.

For more information, see the Orca documentation which is available
within Orca as well as at:

Scripting Orca

So, you want to write a script for Orca? The best thing to do is
start by looking at other scripts under the src/orca/scripts/ hierarchy
of the source tree. Also, the docs/doc-set/internals.html file contains
detailed information about the internal workings of Orca.