a1ip/olli

A library for converting web visualizations into accessible text structures for blind and low-vision screen reader users.

Olli - Screen Reader Accessibility for Data Visualization

Olli is an open-source library for converting data visualizations into accessible text structures for screen reader users. Starting with an existing visualization specification created with a supported toolkit, Olli produces a keyboard-navigable tree view with descriptions at varying levels of detail. Users can explore these structures both to get an initial overview, and to dive into the data in more detail.

Using Olli

For a user tutorial, quickstart guide, and examples, see the Olli website.

Development instructions

• Fork and clone the mitvis/olli repository.
• In the olli directory, run npm install to install dependencies for all packages. We use npm workspaces to manage the two packages in this repo.
• In the core or adapters package directories, run npm run start to start the webpack bundler in development mode with live reloading. Run npm run build to run webpack for production. (Note: olli must be built before olli-adapters the first time you run the build scripts.)
• To run scripts for both packages at the same time, run commands from the olli directory using the -ws flag, e.g. npm run build -ws.

Current Visualization Library Support

• Vega
• Vega-Lite
• ObservablePlot

Related Links

• Making data visualization more accessible for blind and low-vision individuals | MIT News
• Rich Screen Reader Experiences for Accessible Data Visualization | MIT Visualization Group

Reporting an Issue

If you encounter issues when using Olli, please file an issue on GitHub. Please include enough information to reproduce the issue. For example, if the issue is a bug with a chart that Olli should support with one of its adapters, please include the spec and dataset for the chart. For accessibility issues, please share what browser and screen reader you are using.

Contributions, Development, and Support

Interested in contributing to Olli? Please see our contribution and development guidelines, and our code of conduct.

Olli was originally created by Matt Blanco and the library is maintained by the MIT Visualization Group.