{"id":37732705,"url":"https://github.com/oivron/screen-reader-mode","last_synced_at":"2026-01-16T13:53:13.956Z","repository":{"id":127490002,"uuid":"368444403","full_name":"oivron/screen-reader-mode","owner":"oivron","description":"An extension for Visual Studio Code designed for those who rely on Screen Readers.","archived":false,"fork":false,"pushed_at":"2025-11-20T13:21:08.000Z","size":614,"stargazers_count":1,"open_issues_count":0,"forks_count":1,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-11-20T15:18:45.510Z","etag":null,"topics":["accessibility","jaws","nvda","screen-reader","settings","voiceover","vscode","vscode-extension"],"latest_commit_sha":null,"homepage":"","language":"TypeScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"gpl-3.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/oivron.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2021-05-18T07:47:09.000Z","updated_at":"2025-11-20T13:25:18.000Z","dependencies_parsed_at":null,"dependency_job_id":"9c10e493-f433-4116-9ed4-c989304b3b62","html_url":"https://github.com/oivron/screen-reader-mode","commit_stats":null,"previous_names":["oivron/screen-reader-mode"],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/oivron/screen-reader-mode","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/oivron%2Fscreen-reader-mode","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/oivron%2Fscreen-reader-mode/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/oivron%2Fscreen-reader-mode/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/oivron%2Fscreen-reader-mode/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/oivron","download_url":"https://codeload.github.com/oivron/screen-reader-mode/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/oivron%2Fscreen-reader-mode/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":28479034,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-01-16T11:59:17.896Z","status":"ssl_error","status_checked_at":"2026-01-16T11:55:55.838Z","response_time":107,"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":["accessibility","jaws","nvda","screen-reader","settings","voiceover","vscode","vscode-extension"],"created_at":"2026-01-16T13:53:13.234Z","updated_at":"2026-01-16T13:53:13.945Z","avatar_url":"https://github.com/oivron.png","language":"TypeScript","readme":"# Screen Reader Mode README\n\n![Version](https://img.shields.io/visual-studio-marketplace/v/Statped.recommendedsettings)\n![Latest](https://img.shields.io/github/last-commit/oivron/settings-extension-vscode)\n![Downloads](https://img.shields.io/visual-studio-marketplace/d/Statped.recommendedsettings)\n![Repo size](https://img.shields.io/github/license/oivron/settings-extension-vscode)\n\n**An extension for Visual Studio Code designed for those who rely on screen readers such as [NVDA](https://www.nvaccess.org/), [JAWS](https://www.freedomscientific.com/products/software/jaws/), and [VoiceOver](https://support.apple.com/en-us/guide/voiceover/welcome/mac).**\nIt offers enhanced user experience for blind programmers, making it especially valuable for students learning to code.\nThe extension offers easy tweaking of user settings and simplifies the output of Python scripts. It may be used with any programming languages.\n\n## Table of Contents\n- [Features](#features)\n- [Installation](#installation)\n- [Usage](#usage)\n- [License](#license)\n- [Visual Studio Code Accessibility Features](#visual-studio-code-accessibility-features)\n- [Release Notes](#release-notes)\n\n## Features\n### 1. Screen Reader Mode: Tweak User Settings\n![Screenshot showing checkboxes for tweaking user settings](./img/tweak.png)\n\n**Use this to enhance the user experience for blind programmers**.\n\nChoose from the below options. They will affect the user interface and certain notifications:\n\n- **Hide minimap**: Hide the code outline. The minimap can obscure parts of the code when collaborating with a teacher or other sighted person.\n- **Start without editor**: Visual Studio Code will launch without opening an editor window.\n- **Hide hint in empty editor**: Hints will not appear in an empty editor.\n- **Disable workspace trust**: Trust confirmation isn’t needed when working on your own files.\n- **Ignore missing Git warning**: If you don’t use Git, this will prevent VSCode from displaying warnings about Git not being installed.\n- **Ignore recommendations from Extensions**: Extension recommendations will not be shown.\n- **Disable automatic hover**: Hover will be disabled but can still be triggered manually.\n\n### 2. Screen Reader Mode: Toggle Accessibility Verbosity\n\n**Use this feature to prevent screen readers from announcing accessibility information**.\n\nWhile such information can be helpful, it may become repetitive or distracting over time. For example, each time you access the terminal, the screen reader will announce:\n“*Use Alt+F1/Option+F1 for terminal accessibility help*.”\n\n```\n// Excerpt from user settings:\n// Provide information about how to access the terminal accessibility help menu when the terminal is focused.\n\"accessibility.verbosity.terminal\": false\n```\n\n### 3. Screen Reader Mode: Toggle Accessibility Signals\n\n**Use this feature to prevent screen readers from announcing accessibility signals**.\n\nAccessibility signals include sounds and announcements that indicate markers in your code, such as errors, warnings, and breakpoints.\nWhile these signals can be helpful, but they may become repetitive or distracting over time—similar to accessibility verbosity.\nFor example, when you navigate to a line with an error, an error message will be announced and a sound will play simultaneously.\n\n```\n// Excerpt from user settings:\n// Plays a signal - sound (audio cue) and/or announcement (alert) - when the active line has an error.\n\"accessibility.signals.lineHasError\": {\n\t\"sound\": \"off\",\n\t\"announcement\": \"off\"\n}\n```\n\n### 4. Screen Reader Mode: Toggle Automatic Quick Suggestions\n![Screenshot showing code completion suggestions](./img/completion.png)\n\n**Use this to prevent automatic quick suggestions and parameter hints from appearing while typing**.\n\nAutomatic suggestions and hints can be challenging to use with a screen reader. For a better experience, consider disabling them. Instead, trigger suggestions and hints manually when needed. This setting also affects suggestions in the terminal.\n\n### 5. Screen Reader Mode: Run current Python script\n\n**Use this to run the active Python script in a terminal named \"Python\" with minimal output**.\n\nOther methods of running Python files may produce excessive output, which can be challenging for screen reader users.\nUnnecessary text takes up valuable space on a braille display and can cause text-to-speech to become cluttered or distracting.\n\n```\n# Terminal output when executing Python script from Run \u003e Run Without Debugging:\nprompt\u003e \u0026 'c:\\Users\\\u003cuserID\u003e\\AppData\\Local\\Programs\\Python\\Python312\\python.exe' 'c:\\Users\\\u003cuserID\u003e\\.vscode\\extensions\\ms-python.debugpy-2024.10.0-win32-x64\\bundled\\libs\\debugpy\\adapter/../..\\debugpy\\launcher' '64457' '--' 'c:\\Users\\\u003cuserID\u003e\\Documents\\Coding\\hello.py' \nHello world!\n\n# Terminal output when executing Python script from Run Python File:\nprompt\u003e \u0026 C:/Users/\u003cuserID\u003e/AppData/Local/Programs/Python/Python312/python.exe c:/Users/\u003cuserID\u003e/Documents/Coding/hello.py\nHello world!\n\n# Terminal output when executing Python script with the feature Run current Python script included in this extension:\nprompt\u003e python hello.py\nHello world!\n```\n\n## Installation\n1. From Extensions view, search for and install the extension, or\n1. Install the extension from [https://marketplace.visualstudio.com/items?itemName=Statped.screen-reader-mode](https://marketplace.visualstudio.com/items?itemName=Statped.screen-reader-mode)\n2. Restart Visual Studio Code\n\n## Usage\n\n### Available Commands and keyboard shortcuts\nCommands are available from the Command Palette. Some commands also have assigned keyboard shortcuts.\n\n| Screen Reader Mode Commands   | Windows   | macOS|Description |\n| -----------| -----------    | ---------- | -----------                                                   |\n| __Screen Reader Mode: Tweak User Settings__   | N/A | N/A | Disable various settings to enhance user experience.   |\n| __Screen Reader Mode: Toggle Accessibility Verbosity__    | N/A | N/A | Toggle Accessibility Verbosity on or off. |\n| __Screen Reader Mode: Toggle Accessibility Signals__  | N/A | N/A | Toggle Accessibility Signals on or off. |\n| __Screen Reader Mode: Toggle Automatic Quick Suggestions__    | N/A | N/A | Toggle automatic quick suggestions and parameter hints on or off. |\n| __Screen Reader Mode: Run current Python script__ | __Ctrl+Alt+F5__   | __Control+Option+F5__ | Run the current Python script in a terminal named Python with minimal output. |\n\nBelow you'll find some standard VSCode commands that may also be useful.\n\n| VSCode Commands   | Windows   | macOS|Description |\n| -----------| -----------    | ---------- | -----------                                                   |\n| __Trigger Suggest__ | __Ctrl+Space__ | __Control+Space__ | Show suggestions. |\n| __Show or focus hover__ | __Ctrl+K Ctrl+I__| __Command+K Command+I__ | Manually trigger hover. |\n| __Trigger Parameter Hints__ | __Ctrl+Shift+Space__ | __Shift+Command+Space__ | Show parameter hints. |\n| __Show Notifications__ | __Ctrl+Shift+Alt+N__ | __Command+K Shift+Command+N__ | Show notifications. |\n| __Open Accessibility Help__ (editor or terminal) | __Alt+F1__ | __Option+F1__ | Show accessibility help for the editor or terminal. |\n\n## License\nGPL-3.0.\n\n## Visual Studio Code Accessibility Features\nA description of all accessibility features in Visual Studio Code can be found at [code.visualstudio.com/docs/editor/accessibility](https://code.visualstudio.com/docs/editor/accessibility).\n\n## Release Notes\n\n### [2.0.18] - 2025-11-20\nSee [CHANGELOG](CHANGELOG.md).","funding_links":[],"categories":[],"sub_categories":[],"project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Foivron%2Fscreen-reader-mode","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Foivron%2Fscreen-reader-mode","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Foivron%2Fscreen-reader-mode/lists"}