{"id":19787171,"url":"https://github.com/guidepup/setup","last_synced_at":"2026-01-25T22:54:35.377Z","repository":{"id":57114490,"uuid":"453082088","full_name":"guidepup/setup","owner":"guidepup","description":"Setup your environment for screen reader test automation.","archived":false,"fork":false,"pushed_at":"2025-11-15T18:26:07.000Z","size":42514,"stargazers_count":7,"open_issues_count":5,"forks_count":7,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-11-15T19:26:16.564Z","etag":null,"topics":["a11y","a11y-automation","a11y-testing","accessibility","accessibility-automation","accessibility-testing","nvda","screen-reader","voiceover"],"latest_commit_sha":null,"homepage":"https://guidepup.dev","language":"TypeScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/guidepup.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":".github/CONTRIBUTING.md","funding":".github/FUNDING.yml","license":"LICENSE","code_of_conduct":"CODE_OF_CONDUCT.md","threat_model":null,"audit":null,"citation":null,"codeowners":".github/CODEOWNERS.md","security":"SECURITY.md","support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null},"funding":{"github":["cmorten"]}},"created_at":"2022-01-28T13:42:15.000Z","updated_at":"2025-11-15T17:50:29.000Z","dependencies_parsed_at":"2023-12-01T00:24:39.676Z","dependency_job_id":"5aaa6be2-93a3-46fc-beb8-98d560a123b1","html_url":"https://github.com/guidepup/setup","commit_stats":{"total_commits":48,"total_committers":4,"mean_commits":12.0,"dds":0.375,"last_synced_commit":"941143c24d28b638c41a31af29faaca549432c30"},"previous_names":[],"tags_count":37,"template":false,"template_full_name":null,"purl":"pkg:github/guidepup/setup","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/guidepup%2Fsetup","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/guidepup%2Fsetup/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/guidepup%2Fsetup/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/guidepup%2Fsetup/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/guidepup","download_url":"https://codeload.github.com/guidepup/setup/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/guidepup%2Fsetup/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":28761256,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-01-25T20:56:06.009Z","status":"ssl_error","status_checked_at":"2026-01-25T20:54:48.203Z","response_time":113,"last_error":"SSL_read: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["a11y","a11y-automation","a11y-testing","accessibility","accessibility-automation","accessibility-testing","nvda","screen-reader","voiceover"],"created_at":"2024-11-12T06:21:27.864Z","updated_at":"2026-01-25T22:54:35.370Z","avatar_url":"https://github.com/guidepup.png","language":"TypeScript","readme":"# Guidepup Setup\n\n\u003ca href=\"https://www.npmjs.com/package/@guidepup/setup\"\u003e\u003cimg alt=\"Guidepup Setup available on NPM\" src=\"https://img.shields.io/npm/v/@guidepup/setup\" /\u003e\u003c/a\u003e\n\u003ca href=\"https://github.com/guidepup/setup/actions/workflows/test.yml\"\u003e\u003cimg alt=\"Guidepup Setup test workflows\" src=\"https://github.com/guidepup/setup/workflows/Test/badge.svg\" /\u003e\u003c/a\u003e\n\u003ca href=\"https://github.com/guidepup/setup/blob/main/LICENSE\"\u003e\u003cimg alt=\"Guidepup Setup uses the MIT license\" src=\"https://img.shields.io/github/license/guidepup/setup\" /\u003e\u003c/a\u003e\n\n## [Documentation](https://www.guidepup.dev/docs/guides/automated-environment-setup)\n\n[![MacOS Monetary Support](https://img.shields.io/badge/macos-Monetary-blue.svg?logo=apple)](https://apps.apple.com/us/app/macos-monterey/id1576738294)\n[![MacOS Ventura Support](https://img.shields.io/badge/macos-Ventura-blue.svg?logo=apple)](https://apps.apple.com/us/app/macos-ventura/id1638787999)\n[![MacOS Sonoma Support](https://img.shields.io/badge/macos-Somona-blue.svg?logo=apple)](https://apps.apple.com/us/app/macos-sonoma/id6450717509)\n[![MacOS Sequoia Not Supported](https://img.shields.io/badge/macos-Somona-red.svg?logo=apple)](https://github.com/guidepup/setup/issues/40)\n[![MacOS Tahoe Not Supported](https://img.shields.io/badge/macos-Tahoe-red.svg?logo=apple)](https://github.com/guidepup/setup/issues/48)\n[![Windows 10 Support](https://img.shields.io/badge/windows-10-blue.svg?logo=windows10)](https://www.microsoft.com/en-gb/software-download/windows10ISO)\n[![Windows Server 2019 Support](https://img.shields.io/badge/windows_server-2019-blue.svg?logo=windows)](https://www.microsoft.com/en-us/evalcenter/evaluate-windows-server-2019)\n[![Windows Server 2022 Support](https://img.shields.io/badge/windows_server-2022-blue.svg?logo=windows)](https://www.microsoft.com/en-us/evalcenter/evaluate-windows-server-2022)\n[![Windows Server 2025 Support](https://img.shields.io/badge/windows_server-2025-blue.svg?logo=windows)](https://www.microsoft.com/en-us/evalcenter/evaluate-windows-server-2025)\n\nThis package sets up your environment for screen reader automation.\n\nIt enables automation for \u003ca href=\"https://www.guidepup.dev/docs/api/class-voiceover\"\u003e\u003cb\u003eVoiceOver on MacOS\u003c/b\u003e\u003c/a\u003e and \u003ca href=\"https://www.guidepup.dev/docs/api/class-nvda\"\u003e\u003cb\u003eNVDA on Windows\u003c/b\u003e\u003c/a\u003e.\n\n## Getting Started\n\nRun this command:\n\n```console\nnpx @guidepup/setup\n```\n\nAnd get cracking with your screen reader automation code!\n\n## Usage\n\n### GitHub Actions\n\nIf you are using GitHub Actions, check out the dedicated [`guidepup/setup-action`](https://github.com/marketplace/actions/guidepup-setup):\n\n```yaml\n- name: Setup Environment\n  uses: guidepup/setup-action\n```\n\n### MacOS\n\nIf you are running this command locally you may need to take some manual steps to complete setup by following the [manual VoiceOver setup documentation](https://www.guidepup.dev/docs/guides/manual-voiceover-setup).\n\n#### CI\n\nIf you are running this command in CI/CD, it is recommended to add the `--ci` flag to prevent interactive prompts:\n\n```console\nnpx @guidepup/setup --ci\n```\n\n#### Ignore TCC.db Updates\n\nIf updating the TCC.db is not possible (due to SIP) or required you can skip the database update step by using the `--ignore-tcc-db` flag:\n\n```console\nnpx @guidepup/setup --ignore-tcc-db\n```\n\n\u003e [!NOTE]\n\u003e If the necessary permissions have not been granted by other means, using this flag may result in your environment not being set up for reliable screen reader automation.\n\n#### Recording\n\nIf you are encountering errors in CI for MacOS you can pass a `--record` flag to the command which will output a screen-recording of the setup to a `./recordings/` directory:\n\n```console\nnpx @guidepup/setup --ci --record\n```\n\n### Windows\n\n#### NVDA Installation\n\nWhen running on windows a portable NVDA instance compatible with Guidepup will be installed to a temporary directory by default. The location of this installation directory is stored in the Windows registry under the key `HKCU\\Software\\Guidepup\\Nvda`.\n\nIf you want to specify the directory that NVDA is installed to you can pass a `--nvda-install-dir` flag to the command:\n\n```console\nnpx @guidepup/setup --nvda-install-dir \u003cNVDA_INSTALLATION_DIRECTORY\u003e\n```\n\n##### Using HTTP / HTTPS Proxy for Installation\n\nIf you are using a proxy connection, you must define the proxy URL in an env variable. You can use any of the following variables:\n\n- `HTTPS_PROXY`\n- `https_proxy`\n- `HTTP_PROXY`\n- `http_proxy`\n\n#### Foreground Timeout Lock\n\nModern versions of Windows have a setting which prevents new application instances launching in front of other applications in quick succession, requiring over 3 minutes between activations before it will actually show the window - in the interim it launches the window minimized.\n\nMany test automation frameworks will completely close down a browser after a test has finished and then launch a new instance for the next test - on Windows this suffers from the timeout lock on foreground windows. This impacts on screen reader automation which need the window to activate and focus to be able to drive the screen reader on the application.\n\nTo mitigate this the setup script updates two keys in the Windows registry under `HKCU\\Control Panel\\Desktop`:\n\n- `ForegroundLockTimeout` - Specifies the time in milliseconds, following user input, during which the system will not allow applications to force themselves into the foreground. Defaults to `200000`.\n- `ForegroundFlashCount` - Determines the number of times the taskbar button will flash to notify the user that a background window has been activated by the system. If the time elapsed since the last user input exceeds the value of ForegroundLockTimeout, the window will automatically be brought to the foreground. Defaults to `3`.\n\nBoth of these are set to `0` by the setup script.\n\n## Powerful Tooling\n\nCheck out some of the other Guidepup modules:\n\n- [`@guidepup/guidepup`](https://github.com/guidepup/guidepup/) - Reliable automation for your screen reader a11y workflows through JavaScript supporting VoiceOver and NVDA.\n- [`@guidepup/playwright`](https://github.com/guidepup/guidepup-playwright/) - Seamless integration of Guidepup with Playwright.\n- [`@guidepup/virtual-screen-reader`](https://github.com/guidepup/virtual-screen-reader/) - Reliable unit testing for your screen reader a11y workflows.\n- [`@guidepup/jest`](https://github.com/guidepup/jest/) - Jest matchers for reliable unit testing of your screen reader a11y workflows.\n\n## Resources\n\n- [Documentation](https://www.guidepup.dev/docs/guides/automated-environment-setup)\n- [Contributing](.github/CONTRIBUTING.md)\n- [Changelog](https://github.com/guidepup/setup/releases)\n- [MIT License](https://github.com/guidepup/setup/blob/main/LICENSE)\n","funding_links":["https://github.com/sponsors/cmorten"],"categories":[],"sub_categories":[],"project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fguidepup%2Fsetup","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fguidepup%2Fsetup","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fguidepup%2Fsetup/lists"}