Oh Caption Reader Documentation

The Oh Caption, My Caption browser plugin is intended to enhance the user-experience of reading social-media websites with screen-reading assistance. The Oh Caption plugin adds more text to social-media pages to describe images.

Oh Caption supports one-line captions and longer descriptions. Any given image may have a caption, a description, both, or neither.

The additional text is written by other Oh Caption users. As such, we cannot guarantee that every image will be described or that the descriptions will be entirely accurate or spam-free. What we can guarantee is that any such additional text will be written by human beings who had the image directly in front of them when they wrote it.

This document describes how to install and use the Oh Caption plugin to enhance your browsing experience.

Installation

In this section, we will describe the platforms on which the Oh Caption browser was tested and describe how to install the browser plugin in Firefox or Chrome.

Supported platforms

This section describes the various platforms on which the Oh Caption plugin has been tested and any bugs or workarounds which are specific to that platform. You can jump ahead to Windows, Mac OS X, Linux, Android, or iPhone

Windows
JAWS

Testing with Chrome is planned but not yet started.

Testing with Firefox is planned but not yet started.

Window-Eyes

Testing with Chrome is planned but not yet started.

Testing with Firefox is planned but not yet started.

NVDA

Testing with Chrome is planned but not yet started.

Testing with Firefox is planned but not yet started.

ChromeVox

Testing with Chrome is planned but not yet started.

Without Screen Reading Assistance (for sighted users)

Testing with Chrome is planned but not yet started.

Testing with Firefox is planned but not yet started.

Mac OS X
VoiceOver

The plugin works well with Chrome and VoiceOver. The video on the main page shows it in action.

The recent builds of Firefox do not fully support accessibility. There are ways around this which have not yet been tested with the Oh Caption browser plugin.

ChromeVox

The plugin works well with Chrome and ChromeVox on Mac OS X.

Without Screen Reading Assistance (for sighted users)

The plugin works well with Chrome when not using screen reading software.

The plugin works well with Firefox when are not using screen reading software.

Ubuntu Linux
Orca

Neither Chrome nor Firefox work on Ubuntu 14.04 with Orca whether or not the Oh Caption web browser is installed. If you have gotten this to work on some other version of Linux, please send email to reader-support@ohcaption.com.

ChromeVox

Some testing has been done with ChromeVox on Chrome in Ubuntu 14.04. The plugin appears to function.

Without Screen Reading Assistance (for sighted users)

The plugin works well with Chrome when not using screen reading software.

The plugin works well with Firefox when are not using screen reading software.

Android

Oh Caption still needs to investigate whether browser extensions are supported in Chrome for Android.

Firefox for Android does allow browser extensions, but it does not easily allow the Oh Caption browser plugin to install. We are just starting to investigate why Firefox for Android will not load this browser plugin. It seems to work well for reading captions once installed, but there is more work required to sort out how exactly one can consistently install it.

iPhone

Chrome on iPhone does not support browser extensions.

Firefox on iPhone does not support this type of browser extension.

Installing with Chrome

There is an accessibility issue with browser extensions and plugins in Chrome before version 59.0. We at Oh Caption discovered this Chrome bug and patched it. That patch made it into Chrome for version 59.0 which was marked as the stable release starting in June 2017. You can check your version of Chrome by navigating to chrome://version. If you do not have version 59.0 or higher, you will not be able to modify the preferences and hot keys for any Chrome plugins with a screen reader.

To install the Oh Caption browser plugin on Chrome, go to the Oh Caption page on the Chrome Store. From there, click the Add to Chrome button.

Add to Chrome button

Chrome will download and check the Oh Caption plugin. Then, it will ask you if you are sure that you want to install the plugin. It will give you options to Cancel or Add extension.

Add extension button

Select Add extension.

Once the plugin is installed, you will have a small icon on your toolbar with a drop-down menu for the Oh Caption, My Caption plugin.

By default, Oh Caption uses the key-combinatrion Ctrl+Shift+H to toggle Oh Caption on and off. If Chrome feels that combination is available on your computer, it will use it. Otherwise, you will have to set a combination manually.

Either navigate to chrome://extensions or select Manage Extensions from the drop-down menu for Oh Caption, My Caption in your browser toolbar.

Oh Caption toolbar drop-down menu

This will open up a page listing all of the extensions that you have installed. Down at the bottom of the page, there is a link labeled Keyboard shortcuts.

Oh Caption keyboard shortcuts link

Clicking this link will bring up a dialog box which will allow you to set the key-combination used to toggle Oh Caption on and off while on a page. The suggested combination is Ctrl+Shift+H, but you can use any combination that is available on your computer.

Oh Caption key-combination popup

The web browser, operating system, and screen reader all have many key-combinations in use. Chrome will let you override some, but not all, of them. Take care not to override a combination that you use to navigate with your screen reader.

Installing with Firefox

To install the Oh Caption browser plugin on Firefox, first download the plugin.

Next, open the Add-ons tool. You can do this by selecting Add-ons from the Tools menu or with the shortcut key Alt+Shift+A (Command+Shift+A on a Mac).

Add-ons entry in the Tools menu

Your toolbar will also have an Add-ons icon at the right end of the toolbar. (This icon may be in a drop-down menu at the right end of the toolbar.)

Add-on icon from toolbar

Once on the Add-ons page is loaded, you will probably be on the right tab on the page. There are several tabs one can choose from: Get Add-ons, Extensions, Appearance, Plugins, and Services. Click to the Extensions tab.

Sidebar showing extensions tab selected

This tab contains a drop-down menu from a gear icon titled Tools for All Add-ons. Select Install Add-on From File... from the dropdown menu.

Install from file in tools dropdown

This will open a file dialog box. Use the box to load the oh_caption_my_caption... file from your Downloads folder. After you select the file, Firefox will ask you whether you want to Cancel or Install.

Install button

Select Install.

Preferences

There are three subsections here about preferences. The first subsection describes how to navigate to your Oh Caption preferences on Chrome. The second subsection describes how to navigate to your Oh Caption preferences on Firefox. The third subsection describes the preferences you can edit.

Navigating to the Oh Caption preferences in Chrome

Once the plugin is installed, you will have a small icon on your toolbar with a drop-down menu for the Oh Caption, My Caption plugin.

Select Options from that drop-down menu.

Options selected in drop-down menu

This will open a popup window that will let you set the Oh Caption preferences.

Navigating to the Oh Caption preferences in Firefox

To change the preferences for the Oh Caption browser plugin on Firefox, open the Add-ons tool. You can do this by selecting Add-ons from the Tools menu.

Add-ons entry in the Tools menu

Your toolbar will also have an Add-ons icon at the near the right end of the toolbar. (This icon may be in a drop-down menu at the right end of the toolbar.)

Add-on icon from toolbar

Once on the Add-ons page is loaded, you will see that the Oh Caption plugin is installed. There will be a Preferences button next to Oh Caption in the list of installed Add-ons.

Preferences button

At the top of the preferences page, Firefox lets you adjust whether or not Firefox will automatically search for updates to the Oh Caption plugin.

Automatic updates: default, on, or off

It is probably best to set Oh Caption to update automatically.

Oh Caption Preferences

By default, Oh Caption begins looking for crowd-sourced image descriptions as soon as a new page is opened. You can toggle this with the Enable by default checkbox on the Oh Caption preferences page.

Enable by default checkbox

Also, if you would like Oh Caption captions and descriptions to stick out more from the way that your screen reader presents other elements of the page, you can set a prefix and suffix for captions and a prefix and suffix for descriptions.

Prefix and suffix entry

For example, if you wanted a particularly verbose experience, you could set the caption prefix to Start of Oh Caption caption. and the suffix to . End of Oh Caption caption.. Then, if the Oh Caption caption were Obama parasailing, it would be read as Start of Oh Caption caption. Obama parasailing. End of Oh Caption caption.

Be sure to select Save if you have changed the options.

Reading

In this section, we will describe how captions and descriptions will be presented while you are reading, and how to toggle Oh Caption on and off while browsing.

One-line Captions

When Oh Caption is enabled, each time your browser loads a new image, the plugin checks to see if there is an Oh Caption caption for that image. If there is, that caption is used for the ALT attribute of the image on the page you are viewing.

Your screen reader (or other assistive technology) will present the caption as it does any other ALT attribute on an image.

If the image had an ALT attribute already, the Oh Caption caption is added to the beginning of the existing ALT caption.

For example, here is an image without an ALT attribute.

If that image had an Oh Caption caption of Some Platonic Solids, then it would be rendered with that caption as the ALT attribute.

Some Platonic Solids

Here is that same image again with an existing ALT attribute which says raytraced image.

raytraced image

In that case, the Oh Caption caption will be added to the beginning of the existing ALT attribute.

Some Platonic Solids [raytraced image]

Longer Descriptions

When Oh Caption is enabled, each time your browser loads a new image, the plugin checks to see if there is an Oh Caption description for that image. If there is, the image is turned into a FIGURE with a DETAILS section. The DETAILS section initially says Oh Caption description. When you select it, it opens to reveal the description.

Your screen reader (or other assistive technology) will present the description as it does any other text on the page.

For example, here is an image with a long Oh Caption description (sighted-users: click on the square icon in the lower-left corner of the image):

Ray-traced image of three platonic solids. The solids have pink vertices, gray edges, and transparent faces. They are floating just above a mirrored surface against a blue backdrop. There is a yellow cube on the left, a green icosahedron in the center, and a red dodecahedron on the right.

Toggling Oh Caption On and Off

While browsing a web page, you may wish to temporarily disable Oh Caption. You can toggle Oh Caption with the keyboard shortcut Ctrl+Shift+H.

Oh Caption will announce when it has been enabled or disabled.

F.A.Q.

Does Oh Caption track my browsing?

When you are browsing with Oh Caption, the plugin sends a list of every image on the pages you browse. That information is not recorded anywhere in the Oh Caption databases. While some web server logs might show the number of requests made from your internet connection to the Oh Caption server, none of the information from those logs says anything about what page or images you were viewing.

The Oh Caption website does not use cookies, and all communication with the Oh Caption website is encrypted using a secure HTTP connection.

The first time you create a caption or description (or modifiy an existing caption or description), the Oh Caption plugin creates a unique identifier on your computer. This unique identifier is sent only when creating or modifying captions and descriptions. Oh Caption only uses that identifier to block accounts that use Oh Caption to spam readers.

How Is Oh Caption Funded?

Oh Caption does not sell advertising nor charge for the use of its plugin. Oh Caption was created voluntarily. If you would like to donate funds for its on-going support and future development, you are welcome to donate here.

Why Don't I See Descriptions For This Picture?

There are three answers to this question: either there is no caption or description available yet, the social media site has moved the image around, or there is a bug in Oh Caption.

Oh Caption depends on fellow users to write captions and descriptions for images. If no one has written a caption for an image, then Oh Caption is out of luck. You might wish to read the FAQ section about How to encourage friends, family, page owners, and news sites to write Oh Caption captions and descriptions.

If you know there are captions for particular images, you may have to reload the page to receive any new captions. The captions and descriptions are stored on the Oh Caption website so they are available to all.

The Oh Caption captions and descriptions are stored based on the URL (the address) of the image. Social media sites use a variety of techniques for storing images so that they can provide you images in the appropriate size for your web browser and from a data center close to you. This means that what you think of as an image might, in reality, be dozens of images spread around the globe. The Oh Caption software attempts to tie the caption to the image-specific part of its URL, but it does not always succeed in doing so.

If you know there are captions for particular images and you've tried to account for the above, please let us know about the bug you've encountered. See the Support section below for information about where to send bugs.

How Can I Convince Friends And Media Sources to Use Oh Caption

Oh Caption is crowd-sourced. The more people use it to write captions, the more likely there will be captions on the images you are viewing.

If you know people whose social-media habits are similar to yours, they would be ideal candidates to help caption the images you will likely see.

We would recommend referring them to the Purpose section of the Oh Caption website to show them the problem with browsing uncaptioned images with a screen reader.

For news sites and other media sources, it will also be helpful to point out that when their posts get shared on Facebook or Instagram or other such sites, very often the hard work they put into describing their images in captions or ALT attributes are not carried along with the images.

Many sites and page owners already work hard to provide information in an accessible way. It is sad when that work goes out the window as soon as their post is shared on social media. Because Oh Caption captions and descriptions are stored and retrieved based on the URL of the image, the Oh Caption information is much more able to remain intact as the image is shared.

If there is a particular media site to whom you wish we would pitch Oh Caption, please send email to promoting@ohcaption.com.

Support

If you find bugs, please report them using the nklein bug database or email them to bugs@ohcaption.com. When submitting a bug, please include details about what Web Browser, Operating System, Screen Reader, and Website you are using. If it wouldn't be an invasion of your privacy to do so, please save the web page with Save Page As with the Web Page, complete format and attach it to your bug report.

If you need help using Oh Caption for reading, please email reader-support@ohcaption.com

In addition to this documentation, there is separate documentation for creating and modifying captions and descriptions. If you need help creating or modifying captions or descriptions, please refer to the Writer Documentation For Oh Caption.