ANDI

Skip to Content

Installation

This page describes how to install ANDI, the accessibility and Section 508 test tool.

Meet ANDI.

ANDI (Accessible Name & Description Inspector) is a free tool to test web content for accessibility.

ANDI accessibility test tool automated scanner for 508 compliance, ADA, WCAG

ANDI is a "favelet" or "bookmarklet" that will:

  • Provide automated detection of accessibility issues
  • Reveal what a screen reader should say for interactive elements
  • Give practical suggestions to improve accessibility and check 508 compliance

Installation Instructions

Drag and Drop this link: ANDI into your browser's favorites/bookmark bar. runs on Chrome runs on Firefox runs on Internet Explorer runs on Edge runs on Safari


Chrome Chrome logo
  1. Ensure that Chrome's Bookmarks Bar is visible (Ctrl + Shift + B)
  2. Now drag and drop this link: ANDI to the Bookmarks Bar
  3. ANDI is now installed to Chrome and ready to be launched

Unfortunately, Chrome does not offer a simple keyboard accessible alternative to save a link as a bookmark.


Firefox Firefox logo
  1. Ensure that Firefox's Bookmarks Toolbar is visible
  2. Right click this link: ANDI and select "Bookmark This Link". Add it to the Bookmarks Toolbar. Alternatively, keyboard users running Windows can tab to this link: ANDI, press ctrl+shift+F10 (which brings up a context menu) and select "Bookmark This Link". Add it to the Bookmarks Toolbar
  3. ANDI is now installed to Firefox and ready to be launched

Internet Explorer IE logo
  1. Ensure that IE's Favorites Bar is visible
  2. Right click this link: ANDI and select "Add to favorites bar". Alternatively, keyboard users running Windows can tab to this link: ANDI, press ctrl+shift+F10 (which brings up a context menu) and select "Add to favorites bar"
  3. ANDI is now installed to IE and ready to be launched

Edge Edge logo

The version of Edge you have may not allow the direct installation of favelets (such as ANDI). As a workaround...

  1. Install ANDI to Chrome or Firefox
  2. Use Edge to import favorites from Chrome or Firefox
  3. Once imported, ANDI can be moved into Edge's Favorites Bar for quick launching

Safari Safari logo
  1. Ensure that Safari's Favorites Bar is visible (Command + Shift + B)
  2. Drag and drop this link: ANDI to the Favorites Bar
  3. ANDI is now installed to Safari and ready to be launched

Unfortunately, Safari does not offer a simple keyboard accessible alternative to save a link as a favorite.

Launch ANDI

Launch ANDI by clicking on the favorite/bookmark labelled "ANDI" that was added to the Favorites/Bookmarks Bar in the browser's toolbar. ANDI will analyze the test page and appear on the page.

For thorough documentation of all features, visit: ANDI's User Guide.

Benefits Of ANDI

ANDI is like having an accessibility expert at your side, helping you make your web pages more accessible. Use it during development or testing. Whether your knowledge of accessibility is vast or you're just getting started, you, your product, your end users will benefit from the guidance ANDI provides.

Updates / Release Notes

ANDI updates itself automatically; There is no need to reinstall or upgrade.

View the ANDI Release Notes / Version History: ANDI Release Notes. To download: Right Click, "Save As".

How To Uninstall

To uninstall ANDI simply delete the favorite/bookmark that was created in installation.

Open Source on github

ANDI is an open source project created by the Accessible Solutions Branch of the Social Security Administration. The source code is available for contribution on github.

If your agency or development team wishes to host a clone or fork of ANDI's code, refer to this:


Customize ANDI

The favelet launch script injects some javascript and css files into the test page. To point to your own host for the andi.js file, the favelet's launch script must be modified.

Copy the script above and replace [ALTERNATE_HOST] with the alternate url location where your custom files are hosted. Create a new favorite named whatever you want ("ANDI alternate", "my organization's ANDI") and paste the modified launch script text as the as the url of the favelet.

It is important to host the file using https protocol or there may be issues running ANDI on secure sites depending on the browser being used.