Skip to content

Latest commit

 

History

History
146 lines (107 loc) · 7.21 KB

INSTALLATION.md

File metadata and controls

146 lines (107 loc) · 7.21 KB
Raw

Installation Guide

Oobee (CLI) is provided as a portable distribution which minimises installation steps required for Windows and Mac.

About Oobee (CLI)

Oobee is a customisable, automated accessibility testing tool that allows software development teams to find and fix accessibility problems to improve persons with disabilities (PWDs) access to digital services.

Oobee (CLI) allows software engineers to run Oobee as part of their software development environment as the command line, as well as integrate it into their CI/CD pipleline.

System Requirements

  • Oobee (CLI) can run on MacOS version 12 Monterey or above, and a supported version of Windows 10 (64-bit) or Windows 11.
  • Google Chrome browser is installed.
  • One-time Internet access is needed to download and install Oobee (CLI).
  • You are recommended to be logged on to an admin user to run Oobee (CLI).

Windows

Click here for Windows setup instructions

Download Portable Copy

  • Download and extract latest oobee-portable-windows.zip.
  • Tip: To extract files, right-click the Compressed zip file and click "Extract All…" in the context menu.

Run Oobee (CLI)

  • Navigate to the folder containing Oobee (CLI)-portable-windows.

  • Double-click Oobee (CLI)_shell.cmd (Windows Command Script file). Screenshot of Windows Explorer with oobee_shell.cmd selected

  • A Windows Command Prompt window should open with contents as illustrated below. oobee_shell will automatically prepare your system to run Oobee (CLI).

oobee Shell - Created By younglim - NO WARRANTY PROVIDED
================================================================

INFO: Stored current working directory at C:\Users\oobee\Downloads\oobee-portable-windows
INFO: Set path to node for this session
INFO: Set path to node_modules for this session
INFO: Set path to npm-global for this session
INFO: Set path to Playwright cache for this session
INFO: Set path to ImageMagick for this session
INFO: Set path to oobee for this session


PS C:\Users\username\Downloads\oobee-portable-windows>
  • Type in the following commands into the window. The following commands will navigate your Command Prompt window to the oobee sub-directory and initiate a scan
cd oobee
npm start

  • If a Windows Firewall prompt appears, if you have administrator rights, click "Allow" or "Allow access". Click "Cancel" if you do not have administrator rights. Newer Windows Firewall prompt for Allow Windows Firewall prompt for Allow access

  • You should then see your Windows Command Prompt window updated with the following contents

PS C:\Users\username\Downloads\oobee-portable-windows> cd oobee
PS C:\Users\username\Downloads\oobee-portable-windows\oobee> npm start
┌────────────────────────────────────────────────────────────┐
│ Welcome to A11y Accessibility Testing Tool!                │
│ We recommend using Chrome browser for the best experience. │
│                                                            │
│ Version: ░░░░░░                                            │
└────────────────────────────────────────────────────────────┘
? What would you like to scan today? (Use arrow keys)
> sitemap
  website
  custom flow

  • Follow the steps at Features for more information on how to run a scan.

MacOS

Click here for MacOS setup instructions

Download Portable Copy

  • Download and extract oobee-portable-mac.zip version.
  • Tip: To extract files in Mac, double-click on oobee-portable-mac.zip file, usually located at your Downloads folder. A new folder with the name oobee-portable-mac will appear in Finder.

Run Oobee (CLI)

  • Navigate to the folder oobee-portable-mac, usually located at your Downloads folder.

  • Right-click oobee_shell.command. Then click Open in the context menu. Screenshot of right-click oobee_shell.command and Open

  • A prompt as follows will appear like below. Click Open. MacOS prompt for unidentified developer

  • A Terminal window should open with contents as illustrated below. oobee_shell will automatically prepare your system to run Oobee (CLI).

Last login: Thu Mar 16 10:48:05 on ttys002
/Users/username/Downloads/oobee-portable-mac/oobee_shell.command ; exit;
username@hostname ~ % /Users/username/Downloads/oobee-portable-mac/oobee_shell.command ; exit;
oobee Shell - Created By younglim - NO WARRANTY PROVIDED
================================================================

INFO: Setting path to node for this session
INFO: Set path to node_modules for this session
INFO: Set path to Playwright cache for this session
INFO: Set symbolic link to ImageMagick
INFO: Set path to ImageMagick binaries
INFO: Removing com.apple.quarantine attributes for required binaries to run
username@hostname oobee-portable-mac %
  • Type in the following commands into the window. The following commands will navigate your Terminal window to the oobee sub-directory and initiate a scan
cd oobee
npm start
  • You should then see your Terminal window updated with the following contents
username@hostname oobee-portable-mac % cd oobee
username@hostname oobee % npm start
┌────────────────────────────────────────────────────────────┐
│ Welcome to A11y Accessibility Testing Tool!                │
│ We recommend using Chrome browser for the best experience. │
│                                                            │
│ Version: ░░░░░░                                            │
└────────────────────────────────────────────────────────────┘
? What would you like to scan today? (Use arrow keys)
❯ sitemap
  website
  custom flow