Quick Start

Vesper Audit is a desktop application for macOS that crawls websites and generates detailed accessibility reports. This guide walks through installation and your first audit.

1. Install Vesper Audit

  1. Download the latest .dmg file from the Vesper Audit page.
  2. Open the .dmg file and drag Vesper Audit to your Applications folder.
  3. Launch Vesper Audit from your Applications folder. On first launch, macOS may ask you to confirm you want to open it - click Open.

2. Configure your first scan

  1. Launch Vesper Audit.
  2. Enter the URL of the site you want to audit in the URL field. If you enter a bare domain (e.g. example.com), Vesper Audit will automatically prefix it with https://.
  3. Choose a Scan Mode using the toggle above the scan options. Full Site crawls the entire site by following internal links from your starting URL. Single Page audits only the URL you enter - useful for quick spot-checks without waiting for a full crawl.
  4. Set your Output Folder - this is where reports will be saved. The default is ~/Desktop/Vesper-Audits.
Large sites
On large sites, Vesper Audit will display a banner if the crawl exceeds 100 pages. If you see this, consider adding path or query string exclusions to narrow the scope - see Exclusions & Suppressions.

3. Run the audit

  1. Click Run Audit.
  2. Vesper Audit will crawl the site from the URL you entered, following internal links (Full Site mode) or auditing just the one page (Single Page mode).
  3. Progress is shown in real time in the results panel.
  4. When the audit completes, your output folder will contain the generated reports.

4. Review your reports

After the scan completes, Vesper Audit writes a results file (.json) to your output folder, which powers the in-app report viewer. If PDF export is enabled in Scanner Options, a formatted PDF report is also written to the same folder. See Output Formats for a full description of each file.

Next steps