2026.1 Add-on API changes

84 views
Skip to first unread message

NVDA Add-on API Announcements

unread,
Aug 15, 2025, 1:17:35 AMAug 15
to NVDA Add-on API Announcements
NVDA 2026.1 is an API breaking release.

Reminder, this mailing list is read only, please provide feedback by replying directly to emails, or via GitHub.
This list is intended to notify of changes to the add-on API, for confirmation of the latest state for breakages or deprecations, please refer to the 'changes file' for the NVDA release you are interested in.
To review NVDAs add-on API compatibility process, refer to the latest version of the developer guide.

Add-on API changes have been merged, planned for inclusion in the 2026.1 release:
"Update to Python 3.13 for 2026.1 #18689"

If API breaks or planned future breaks (deprecations) will cause difficulties for the ongoing development of an add-on you maintain, please let NVDA developers know by replying directly to emails, or via GitHub.

Breaking changes:
  • NVDA is now built with Python 3.13 (32bit). Note, we will be switching to 64 bit Python 3.13 during 2026.1.
  • typing_extensions have been removed.
    These should be supported natively in Python 3.13. 

NVDA Add-on API Announcements

unread,
Aug 15, 2025, 2:29:17 AMAug 15
to NVDA Add-on API Announcements, NVDA Add-on API Announcements
Add-on API changes have been merged, planned for inclusion in the 2026.1 release:
"remove glob import from versionInfo #18682"


If API breaks or planned future breaks (deprecations) will cause difficulties for the ongoing development of an add-on you maintain, please let NVDA developers know by replying directly to emails, or via GitHub.

Breaking changes:
  • copyrightYears and url have been moved from versionInfo to buildVersion

NVDA Add-on API Announcements

unread,
Aug 19, 2025, 1:41:45 AMAug 19
to NVDA Add-on API Announcements
Add-on API changes have been merged, planned for inclusion in the 20XY.Z release:
"Fix OffsetTextInfo.collapse() and OffsetTextInfo.move()" #18348.


If API breaks or planned future breaks (deprecations) will cause difficulties for the ongoing development of an add-on you maintain, please let NVDA developers know by replying directly to emails, or via GitHub.

Breaking changes:
  • Fixed behavior of TextInfo.collapse() - previously it was moving TextInfo to the next paragraph in some cases.
  • Fixed behavior of OffsetTextInfo.move() - previously it wouldn't move to the very end of the document unless moving by character.

NVDA Add-on API Announcements

unread,
Aug 25, 2025, 7:43:39 PMAug 25
to NVDA Add-on API Announcements
Add-on API changes have been merged, planned for inclusion in the 2026.1 release:
"Move Windows API bindings out of hwPortUtils"  #18571.


If API breaks or planned future breaks (deprecations) will cause difficulties for the ongoing development of an add-on you maintain, please let NVDA developers know by replying directly to emails, or via GitHub.

Breaking changes:
  • None

Deprecations:
  • The following symbols have been moved from hwPortUtils to winBindings.bthprops: BLUETOOTH_ADDRESS, BLUETOOTH_DEVICE_INFO, BLUETOOTH_MAX_NAME_SIZE, BluetoothGetDeviceInfo. Access to these symbols via hwPortUtils is deprecated.
  • hwPortUtils.BTH_ADDR is deprecated. Use winBindings.bthprops.BLUETOOTH_ADDRESS instead.
  • The following symbols have been moved from hwPortUtils to winBindings.cfgmgr32: CM_Get_Device_ID, CR_SUCCESS, MAX_DEVICE_ID_LEN. Access to these symbols via hwPortUtils is deprecated.
  • The following symbol has been moved from hwPortUtils to winBindings.hid: HIDD_ATTRIBUTES. Access to this symbol via hwPortUtils is deprecated.
  • The following symbols have been moved from hwPortUtils to winBindings.setupapi: DEVPKEY_Device_BusReportedDeviceDesc, DEVPROPKEY, GUID_CLASS_COMPORT, GUID_DEVINTERFACE_USB_DEVICE, HDEVINFO, PSP_DEVICE_INTERFACE_DATA, PSP_DEVICE_INTERFACE_DETAIL_DATA, PSP_DEVINFO_DATA, SP_DEVICE_INTERFACE_DATA, SP_DEVINFO_DATA, SetupDiDestroyDeviceInfoList, SetupDiEnumDeviceInfo, SetupDiEnumDeviceInterfaces, SetupDiGetClassDevs, SetupDiGetDeviceInterfaceDetail, SetupDiGetDeviceProperty, SetupDiGetDeviceRegistryProperty, SetupDiOpenDevRegKey, SIZEOF_SP_DEVICE_INTERFACE_DETAIL_DATA_W. Access to these symbols via hwPortUtils is deprecated.
  • The DIGCF_*, SPDRP_*, DICS_FLAG_*, and DIREG_* constants in hwPortUtils are deprecated. Use their Enum counterparts from winBindings.setupapi instead.
  • hwPortUtils.dummy, hwPortUtils.INVALID_HANDLE_VALUE, and hwPortUtils.ValidHandle are deprecated, with no planned replacement.
  • hwPortUtils.ERROR_INSUFFICIENT_BUFFER and hwPortUtils.ERROR_NO_MORE_ITEMS are deprecated. Use winAPI.SystemErrorCodes.INSUFFICIENT_BUFFER and winAPI.SystemErrorCodes.NO_MORE_ITEMS instead.

NVDA Add-on API Announcements

unread,
Aug 25, 2025, 8:36:11 PMAug 25
to NVDA Add-on API Announcements, NVDA Add-on API Announcements
Add-on API changes have been merged, planned for inclusion in the 2026.1 release:
"Create experimental 64-bit dual builds #18207".

If API breaks or planned future breaks (deprecations) will cause difficulties for the ongoing development of an add-on you maintain, please let NVDA developers know by replying directly to emails, or via GitHub.

Breaking changes:
  • NVDAHelper.localLib is now a module, not a ctypes.CDLL.
    Most API consumers should not be impacted by this change.
    Use NVDAHelper.localLib.dll for access to the ctypes.CDLL if necessary.

Deprecations:
  • NVDAHelper.versionedLibPath is deprecated.
    Use NVDAState.ReadPaths.versionedLibX86Path instead.
  • NVDAHelper.coreArchLibPath is deprecated.
    Use NVDAState.ReadPaths.coreArchLibPath instead.
  • NVDAHelper.LOCAL_WIN10_DLL_PATH is deprecated.
    Use NVDAState.ReadPaths.nvdaHelperLocalWin10Dll instead.
  • NVDAHelper.generateBeep is deprecated.
    Use NVDAHelper.localLib.generateBeep instead.
  • NVDAHelper.VBuf_getTextInRange is deprecated.
    Use NVDAHelper.localLib.VBuf_getTextInRange instead.
  • NVDAHelper.onSsmlMarkReached is deprecated.
    Use NVDAHelper.localLib.nvdaController_onSsmlMarkReached instead.
  • NVDAObjects.window.excel.ExcelCellInfo is deprecated.
    Use NVDAHelper.localLib.EXCEL_CELLINFO instead.
  • nvwave.WAVEFORMATEX is deprecated.
    Use winBindings.mmeapi.WAVEFORMATEX instead.
  • The following symbols have been moved from winuser to winBindings.user32: WNDCLASSEXW, WNDPROC, PAINTSTRUCT.

NVDA Add-on API Announcements

unread,
Aug 25, 2025, 8:53:48 PMAug 25
to NVDA Add-on API Announcements, NVDA Add-on API Announcements
Add-on API changes have been merged, planned for inclusion in the 2026.1 release:
"Enforce Windows 10 requirement for NVDA #18688".

If API breaks or planned future breaks (deprecations) will cause difficulties for the ongoing development of an add-on you maintain, please let NVDA developers know by replying directly to emails, or via GitHub.

Breaking changes:
  • NVDA no longer supports Windows 8.1.
    Windows 10 (Version 1507) is the minimum Windows version supported.
  • UIAHandler.autoSelectDetectionAvailable is removed with no replacement.

Deprecations:
  • winVersion.WIN81 constant has been deprecated from the winVersion module.

On Friday, August 15, 2025 at 3:17:35 PM UTC+10 NVDA Add-on API Announcements wrote:

NVDA Add-on API Announcements

unread,
Sep 5, 2025, 1:22:42 AMSep 5
to NVDA Add-on API Announcements

Add-on API changes have been merged, planned for inclusion in the 2026.1 release:

If API breaks or planned future breaks (deprecations) will cause difficulties for the ongoing development of an add-on you maintain, please let NVDA developers know by replying directly to emails, or via GitHub.

Breaking changes:

  • The bool configuration key [documentFormatting][reportSpellingErrors] has been removed.
    Use the int configuration key [reportSpellingErrors2] instead.

Deprecations:

  • None

NVDA Add-on API Announcements

unread,
Sep 5, 2025, 1:30:44 AMSep 5
to NVDA Add-on API Announcements

Add-on API changes have been merged, planned for inclusion in the 20XY.Z release:
“And more winBindings” #18860.

If API breaks or planned future breaks (deprecations) will cause difficulties for the ongoing development of an add-on you maintain, please let NVDA developers know by replying directly to emails, or via GitHub.

Breaking changes:

  • None

Deprecations:

  • fonts.gdi32, screenBitmap.gdi32 and winGDI.gdi32 are deprecated. Use winBindings.gdi32.dll instead.
  • shellapi.shell32 is deprecated. Use winBindings.shell32.dll instead.
  • The following symbols have been moved from shellapi to winBindings.shell32: SHELLEXECUTEINFO, SHELLEXECUTEINFOW. Access to these symbols via shellapi is deprecated.
  • winGDI.gdiplus is deprecated. Use winBindings.gdiplus.dll instead.
  • The following symbols have been moved from winGDI to winBindings.gdi32: RGBQUAD, BITMAPINFOHEADER, BITMAPINFO. Access to these symbols via winGDI is deprecated.
  • The following symbols have been moved from winGDI to winBindings.gdiplus: GdiplusStartupInput, GdiplusStartupOutput. Access to these symbols via winGDI is deprecated.
  • The following symbols have been moved from winKernel to winBindings.advapi32: PROCESS_INFORMATION, STARTUPINFO, STARTUPINFOW. Access to these symbols via winKernel is deprecated.
  • winKernel.advapi32 is deprecated. Use winBindings.advapi32.dll instead.

NVDA Add-on API Announcements

unread,
Sep 7, 2025, 8:32:34 PMSep 7
to NVDA Add-on API Announcements
Add-on API changes have been merged, planned for inclusion in the 2026.1 release:
"Fix UWP OCR on 64 bit NVDA" #18858.


If API breaks or planned future breaks (deprecations) will cause difficulties for the ongoing development of an add-on you maintain, please let NVDA developers know by replying directly to emails, or via GitHub.

Breaking changes:
  • None

Deprecations:
  • NVDAHelper.bstrReturn is deprecated, with no planned replacement.
  • contentRecog.uwpOcr.uwpOcr_Callback is deprecated. Use NVDAHelper.localWin10.uwpOcr_Callback instead.

NVDA Add-on API Announcements

unread,
Sep 11, 2025, 11:44:49 PMSep 11
to NVDA Add-on API Announcements
Add-on API changes have been merged, planned for inclusion in the 2026.1 release:
"Move user32 ctypes bindings to winBindings" #18883.


If API breaks or planned future breaks (deprecations) will cause difficulties for the ongoing development of an add-on you maintain, please let NVDA developers know by replying directly to emails, or via GitHub.

Breaking changes:
  • NVDAObjects.window.GhostWindowFromHungWindow has been removed with no replacement.
  • winUser.Input_I and winUser.PUL have been removed, with no replacement.
Deprecations:
  • The following symbols have been moved from winuser to winBindings.user32: GUITHREADINFO, HWINEVENTHOOK, WINEVENTPROC.
  • touchHelper.SM_MAXIMUMTOUCHES is deprecated. Use winAPI.winUser.constants.SystemMetrics.MAXIMUM_TOUCHES instead.
  • screenBitmap.user32, winAPI.winUser.functions.user32, winGDI.user32, and winUser.user32 are deprecated. Use winBindings.user32.dll instead.
  • The HardwareInput, Input, KeyBdInput and MouseInput structures from winUser are deprecated. Use HARDWAREINPUT, INPUT, KEYBDINPUT and MOUSEINPUT from winBindings.user32 instead.

NVDA Add-on API Announcements

unread,
Sep 15, 2025, 2:42:54 AMSep 15
to NVDA Add-on API Announcements
Add-on API changes have been merged, planned for inclusion in the 2026.1 release:
"Replace remaining raw ctypes calls to hid.dll with winBindings.hid definitions" #18902


If API breaks or planned future breaks (deprecations) will cause difficulties for the ongoing development of an add-on you maintain, please let NVDA developers know by replying directly to emails, or via GitHub.

Breaking changes:
  • The inputButtonCaps property on hwIo.hid.Hid objects now correctly returns an array of hidpi.HIDP_BUTTON_CAPS structures rather than HIDP_VALUE_CAPS structures.

Deprecations:
  • hwIo.hid.hidDll is deprecated. Use winBindings.hid.dll instead.

NVDA Add-on API Announcements

unread,
Sep 16, 2025, 1:04:22 AMSep 16
to NVDA Add-on API Announcements, NVDA Add-on API Announcements
Add-on API changes have been merged, planned for inclusion in the 2026.1 release:
"Move all remaining kernel32 ctypes calls to winBindings" #18896.


If API breaks or planned future breaks (deprecations) will cause difficulties for the ongoing development of an add-on you maintain, please let NVDA developers know by replying directly to emails, or via GitHub.

Breaking changes:
  • None

Deprecations:
  • FILETIME, SYSTEMTIME and TIME_ZONE_INFORMATION have been moved from winKernal to winBindings.kernel32.
  • COORD, CONSOLE_SCREEN_BUFFER_INFO, CONSOLE_SELECTION_INFO, CHAR_INFO and PHANDLER_ROUTINE have been moved from wincon to winBindings.kernel32.
  • appModuleHandler.processEntry32W has been moved to winBindings.kernel32.PROCESSENTRY32W.
  • winKernel.kernel32 is now winBindings.kernel32.dll.

NVDA Add-on API Announcements

unread,
Sep 16, 2025, 1:07:31 AMSep 16
to NVDA Add-on API Announcements
Add-on API changes have been merged, planned for inclusion in the 2026.1 release:
"Shorten indentation beeps" #18898.


If API breaks or planned future breaks (deprecations) will cause difficulties for the ongoing development of an add-on you maintain, please let NVDA developers know by replying directly to emails, or via GitHub.

Breaking changes:
  • speech.speech.IDT_TONE_DURATION has been removed. Call speech.speech.getIndentToneDuration instead.

Deprecations:
  • None

NVDA Add-on API Announcements

unread,
Sep 17, 2025, 9:38:49 PMSep 17
to NVDA Add-on API Announcements, NVDA Add-on API Announcements
Add-on API changes have been merged, planned for inclusion in the 2026.1 release:

If API breaks or planned future breaks (deprecations) will cause difficulties for the ongoing development of an add-on you maintain, please let NVDA developers know by replying directly to emails, or via GitHub.

Deprecations:
  • The LVS_* constants from NVDAObjects.IAccessible.sysListView32 are deprecated. Use the ListViewWindowStyle enumeration instead.

NVDA Add-on API Announcements

unread,
Sep 23, 2025, 11:16:24 PMSep 23
to NVDA Add-on API Announcements, NVDA Add-on API Announcements
Add-on API changes have been merged, planned for inclusion in the 2026.1 release:

If API breaks or planned future breaks (deprecations) will cause difficulties for the ongoing development of an add-on you maintain, please let NVDA developers know by replying directly to emails, or via GitHub.

Deprecations:
  • addonHandler.BUNDLE_EXTENSION has been moved to config.registry.ADDON_BUNDLE_EXTENSION.
  • addonHandler.NVDA_ADDON_PROG_ID has been moved to config.registry.NVDA_ADDON_PROG_ID.
  • installer.defaultInstallPath has been moved to NVDAState.WritePaths.defaultInstallDir.

NVDA Add-on API Announcements

unread,
Sep 23, 2025, 11:36:48 PMSep 23
to NVDA Add-on API Announcements
Add-on API changes have been merged, planned for inclusion in the 2026.1 release:
"Fix Remote Access as follower" #18947.


If API breaks or planned future breaks (deprecations) will cause difficulties for the ongoing development of an add-on you maintain, please let NVDA developers know by replying directly to emails, or via GitHub.

Breaking changes:
  • None

Deprecations:

  • The INPUT_MOUSE, INPUT_KEYBOARD, KEYEVENTF_KEYUP and KEYEVENTF_UNICODE constants from winUser are deprecated. Use INPUT_TYPE.MOUSE, INPUT_TYPE.KEYBOARD, KEYEVENTF.KEYUP and KEYEVENTF.UNICODE from winBindings.user32 instead.

Michael Curran

unread,
Sep 24, 2025, 12:44:21 AMSep 24
to NVDA Add-on API Announcements
Add-on API changes have been merged, planned for inclusion in the 2026.1
release:
"Add winBindings for crypt32 and replace raw ctypes calls #18956"
<https://github.com/nvaccess/nvda/pull/18956>.

If API breaks or planned future breaks (deprecations) will cause
difficulties for the ongoing development of an add-on you maintain,
please let NVDA developers know by replying directly to emails, or via
GitHub.

Breaking Changes:
* The *rgpszUsageIdentifier* member of the
*updateCheck.CERT_USAGE_MATCH* struct is now of type *POINTER(LPSTR)*
rather than *c_void_p* to correctly align with Microsoft documentation.

Deprecations:
* The following symbols have been moved from *updateCheck* to
*winBindings.crypt32*: *CERT_USAGE_MATCH*, *CERT_CHAIN_PARA*.

On 24/09/2025 1:36 pm, NVDA Add-on API Announcements wrote:
> Add-on API changes have been merged, planned for inclusion in the 2026.1
> release:
> "Fix Remote Access as follower" #18947
> <https://github.com/nvaccess/nvda/pull/18947>.
>
> If API breaks or planned future breaks (deprecations) will cause
> difficulties for the ongoing development of an add-on you maintain,
> please let NVDA developers know by replying directly to emails, or via
> GitHub.
>
> Breaking changes:
>
> * None
>
>
> Deprecations:
>
> * The INPUT_MOUSE, INPUT_KEYBOARD, KEYEVENTF_KEYUP and
> KEYEVENTF_UNICODE constants from winUser are deprecated. Use
> INPUT_TYPE.MOUSE, INPUT_TYPE.KEYBOARD, KEYEVENTF.KEYUP and
> KEYEVENTF.UNICODE from winBindings.user32 instead.
>
> On Wednesday, September 24, 2025 at 1:16:24 PM UTC+10 NVDA Add-on API
> Announcements wrote:
>
> Add-on API changes have been merged, planned for inclusion in the
> 2026.1 release:
> "Modernize installer and reg key usage #18851"
> <https://github.com/nvaccess/nvda/pull/18851>.
>
> If API breaks or planned future breaks (deprecations) will cause
> difficulties for the ongoing development of an add-on you maintain,
> please let NVDA developers know by replying directly to emails, or
> via GitHub.
>
> Deprecations:
>
> * *addonHandler.BUNDLE_EXTENSION* has been moved to
> *config.registry.ADDON_BUNDLE_EXTENSION*.
> * *addonHandler.NVDA_ADDON_PROG_ID *has been moved to
> *config.registry.NVDA_ADDON_PROG_ID.*
> * *installer.defaultInstallPath* has been moved to
> *NVDAState.WritePaths.defaultInstallDir*.
>
>
>
> On Thursday, September 18, 2025 at 11:38:49 AM UTC+10 NVDA Add-on
> API Announcements wrote:
>
> Add-on API changes have been merged, planned for inclusion in
> the 2026.1 release:
> "Treat more syslistview32 controls as multi select #18926"
> <https://github.com/nvaccess/nvda/pull/18926>.
>
> If API breaks or planned future breaks (deprecations) will cause
> difficulties for the ongoing development of an add-on you
> maintain, please let NVDA developers know by replying directly
> to emails, or via GitHub.
>
> Deprecations:
>
> * The *LVS_** constants from
> *NVDAObjects.IAccessible.sysListView32* are deprecated. Use
> the *ListViewWindowStyle* enumeration instead.
>
>
>
> On Tuesday, September 16, 2025 at 3:07:31 PM UTC+10 NVDA Add-on
> API Announcements wrote:
>
> Add-on API changes have been merged, planned for inclusion
> in the 2026.1 release:
> "Shorten indentation beeps" #18898
> <https://github.com/nvaccess/nvda/pull/18898>.
>
> If API breaks or planned future breaks (deprecations) will
> cause difficulties for the ongoing development of an add-on
> you maintain, please let NVDA developers know by replying
> directly to emails, or via GitHub.
>
> Breaking changes:
>
> * speech.speech.IDT_TONE_DURATION has been removed. Call
> speech.speech.getIndentToneDuration instead.
>
>
> Deprecations:
>
> * None
>
>
> On Tuesday, September 16, 2025 at 3:04:22 PM UTC+10 NVDA
> Add-on API Announcements wrote:
>
> Add-on API changes have been merged, planned for
> inclusion in the 2026.1 release:
> "Move all remaining kernel32 ctypes calls to
> winBindings" #18896
> <https://github.com/nvaccess/nvda/pull/18896>.
>
> If API breaks or planned future breaks (deprecations)
> will cause difficulties for the ongoing development of
> an add-on you maintain, please let NVDA developers know
> by replying directly to emails, or via GitHub.
>
> Breaking changes:
>
> * None
>
>
> Deprecations:
>
> * FILETIME, SYSTEMTIME and TIME_ZONE_INFORMATION have
> been moved from winKernal to winBindings.kernel32.
> * COORD, CONSOLE_SCREEN_BUFFER_INFO,
> CONSOLE_SELECTION_INFO, CHAR_INFO and
> PHANDLER_ROUTINE have been moved from wincon to
> winBindings.kernel32.
> * appModuleHandler.processEntry32W has been moved to
> winBindings.kernel32.PROCESSENTRY32W.
> * winKernel.kernel32 is now winBindings.kernel32.dll.
>
> On Monday, September 15, 2025 at 4:42:54 PM UTC+10 NVDA
> Add-on API Announcements wrote:
>
> Add-on API changes have been merged, planned for
> inclusion in the 2026.1 release:
> "Replace remaining raw ctypes calls to hid.dll with
> winBindings.hid definitions" #18902
> <https://github.com/nvaccess/nvda/pull/18902>
>
> If API breaks or planned future breaks
> (deprecations) will cause difficulties for the
> ongoing development of an add-on you maintain,
> please let NVDA developers know by replying directly
> to emails, or via GitHub.
>
> Breaking changes:
>
> * The inputButtonCaps property on
> hwIo.hid.Hid objects now correctly returns an
> array of hidpi.HIDP_BUTTON_CAPS structures
> rather than HIDP_VALUE_CAPS structures.
>
>
> Deprecations:
>
> * hwIo.hid.hidDll is deprecated. Use
> winBindings.hid.dll instead.
>
> On Friday, September 12, 2025 at 1:44:49 PM UTC+10
> NVDA Add-on API Announcements wrote:
>
> Add-on API changes have been merged, planned for
> inclusion in the 2026.1 release:
> "Move user32 ctypes bindings to winBindings"
> #18883
> <https://github.com/nvaccess/nvda/pull/18883>.
>
> If API breaks or planned future breaks
> (deprecations) will cause difficulties for the
> ongoing development of an add-on you maintain,
> please let NVDA developers know by replying
> directly to emails, or via GitHub.
>
> Breaking changes:
>
> * NVDAObjects.window.GhostWindowFromHungWindow has been removed with no replacement.
> * winUser.Input_I and winUser.PUL have been
> removed, with no replacement.
>
> Deprecations:
>
> * The following symbols have been moved from
> winuser to winBindings.user32:
> GUITHREADINFO, HWINEVENTHOOK, WINEVENTPROC.
> * touchHelper.SM_MAXIMUMTOUCHES is deprecated.
> Use
> winAPI.winUser.constants.SystemMetrics.MAXIMUM_TOUCHES instead.
> * screenBitmap.user32,
> winAPI.winUser.functions.user32,
> winGDI.user32, and winUser.user32 are
> deprecated. Use winBindings.user32.dll instead.
> * The HardwareInput, Input, KeyBdInput and
> MouseInput structures from winUser are
> deprecated. Use HARDWAREINPUT, INPUT,
> KEYBDINPUT and MOUSEINPUT from
> winBindings.user32 instead.
>
> On Monday, September 8, 2025 at 10:32:34 AM
> UTC+10 NVDA Add-on API Announcements wrote:
>
> Add-on API changes have been merged, planned
> for inclusion in the 2026.1 release:
> "Fix UWP OCR on 64 bit NVDA" #18858
> <https://github.com/nvaccess/nvda/pull/18858>.
>
> If API breaks or planned future breaks
> (deprecations) will cause difficulties for
> the ongoing development of an add-on you
> maintain, please let NVDA developers know by
> replying directly to emails, or via GitHub.
>
> Breaking changes:
>
> * None
>
>
> Deprecations:
>
> * NVDAHelper.bstrReturn is deprecated,
> with no planned replacement.
> * contentRecog.uwpOcr.uwpOcr_Callback is
> deprecated. Use
> NVDAHelper.localWin10.uwpOcr_Callback instead.
>
>
> On Friday, September 5, 2025 at 3:30:44 PM
> UTC+10 NVDA Add-on API Announcements wrote:
>
> Add-on API changes have been merged,
> planned for inclusion in the 20XY.Z release:
> “And more winBindings” #18860
> <https://github.com/nvaccess/nvda/pull/18860>.
>
> If API breaks or planned future breaks
> (deprecations) will cause difficulties
> for the ongoing development of an add-on
> you maintain, please let NVDA developers
> know by replying directly to emails, or
> via GitHub.
>
> Breaking changes:
>
> * None
>
> Deprecations:
>
> * fonts.gdi32, screenBitmap.gdi32 and
> winGDI.gdi32 are deprecated. Use
> winBindings.gdi32.dll instead.
> * shellapi.shell32 is deprecated. Use
> winBindings.shell32.dll instead.
> * The following symbols have been
> moved from shellapi to
> winBindings.shell32:
> SHELLEXECUTEINFO, SHELLEXECUTEINFOW.
> Access to these symbols via shellapi
> is deprecated.
> * winGDI.gdiplus is deprecated. Use
> winBindings.gdiplus.dll instead.
> * The following symbols have been
> moved from winGDI to
> winBindings.gdi32: RGBQUAD,
> BITMAPINFOHEADER, BITMAPINFO. Access
> to these symbols via winGDI is
> deprecated.
> * The following symbols have been
> moved from winGDI to
> winBindings.gdiplus:
> GdiplusStartupInput,
> GdiplusStartupOutput. Access to
> these symbols via winGDI is deprecated.
> * The following symbols have been
> moved from winKernel to
> winBindings.advapi32:
> PROCESS_INFORMATION, STARTUPINFO,
> STARTUPINFOW. Access to these
> symbols via winKernel is deprecated.
> * winKernel.advapi32 is deprecated.
> Use winBindings.advapi32.dll instead.
>
> ​
> On Friday, September 5, 2025 at
> 3:22:42 PM UTC+10 NVDA Add-on API
> Announcements wrote:
>
> Add-on API changes have been merged,
> planned for inclusion in the 2026.1
> release:
>
> “Report spelling errors with a sound
> while reading” #17997
> <https://github.com/nvaccess/nvda/pull/17997>.
>
> If API breaks or planned future
> breaks (deprecations) will cause
> difficulties for the ongoing
> development of an add-on you
> maintain, please let NVDA developers
> know by replying directly to emails,
> or via GitHub.
>
> Breaking changes:
>
> * The bool configuration key
> [documentFormatting][reportSpellingErrors] has been removed.
> Use the int configuration key
> [reportSpellingErrors2] instead.
>
> Deprecations:
>
> * None
>
> ​
> On Tuesday, August 26, 2025 at
> 10:53:48 AM UTC+10 NVDA Add-on API
> Announcements wrote:
>
> Add-on API changes have been
> merged, planned for inclusion in
> the 2026.1 release:
> "Enforce Windows 10 requirement
> for NVDA #18688"
> <https://github.com/nvaccess/nvda/pull/18688>.
>
> If API breaks or planned future
> breaks (deprecations) will cause
> difficulties for the ongoing
> development of an add-on you
> maintain, please let NVDA
> developers know by replying
> directly to emails, or via GitHub.
>
> Breaking changes:
>
> * NVDA no longer supports
> Windows 8.1.
> Windows 10 (Version 1507) is
> the minimum Windows version
> supported.
> * *UIAHandler.autoSelectDetectionAvailable* is removed with no replacement.
>
>
> Deprecations:
>
> * *winVersion.WIN81* constant
> has been deprecated from the
> *winVersion* module.
>
>
> On Friday, August 15, 2025 at
> 3:17:35 PM UTC+10 NVDA Add-on
> API Announcements wrote:
>
> NVDA 2026.1 is an API
> breaking release.
>
> Reminder, this mailing list
> is read only, please provide
> feedback by replying
> directly to emails, or via
> GitHub.
> This list is intended to
> notify of changes to the
> add-on API, for confirmation
> of the latest state for
> breakages or deprecations,
> please refer to the 'changes
> file' for the NVDA release
> you are interested in.
> To review NVDAs add-on API
> compatibility process, refer
> to the latest version of the
> developer guide
> <https://github.com/nvaccess/nvda/blob/master/projectDocs/dev/developerGuide/developerGuide.md>.
>
> Add-on API changes have been
> merged, planned for
> inclusion in the 2026.1 release:
> "Update to Python 3.13 for
> 2026.1 #18689"
> <https://github.com/nvaccess/nvda/pull/18689>
>
> If API breaks or planned
> future breaks (deprecations)
> will cause difficulties for
> the ongoing development of
> an add-on you maintain,
> please let NVDA developers
> know by replying directly to
> emails, or via GitHub.
>
> Breaking changes:
>
> * NVDA is now built with
> Python 3.13 (32bit).
> Note, we will be
> switching to 64 bit
> Python 3.13 during 2026.1.
> * typing_extensions have
> been removed.
> These should be
> supported natively in
> Python 3.13.
>
> --
> Kind Regards,
> NV Access Software Developers
>
> This mailing list is read only.
> Please provide feedback by replying directly to this email, or via GitHub.
> ---
> You received this message because you are subscribed to the Google
> Groups "NVDA Add-on API Announcements" group.
> To unsubscribe from this group and stop receiving emails from it, send
> an email to nvda-api+u...@nvaccess.org
> <mailto:nvda-api+u...@nvaccess.org>.
> To view this discussion visit
> https://groups.google.com/a/nvaccess.org/d/msgid/nvda-api/4156af34-95a5-4322-9a5e-e29910129bb2n%40nvaccess.org <https://groups.google.com/a/nvaccess.org/d/msgid/nvda-api/4156af34-95a5-4322-9a5e-e29910129bb2n%40nvaccess.org?utm_medium=email&utm_source=footer>.

NVDA Add-on API Announcements

unread,
Sep 24, 2025, 7:19:33 PMSep 24
to NVDA Add-on API Announcements
Add-on API changes have been merged, planned for inclusion in the 2026.1 release:
"Move definitions for magnification.dll to winBindings" #18958.


If API breaks or planned future breaks (deprecations) will cause difficulties for the ongoing development of an add-on you maintain, please let NVDA developers know by replying directly to emails, or via GitHub.

Breaking changes:
  • visionEnhancementProviders.screenCurtain.Magnification has been removed. All public symbols defined on this class are now accessible from winBindings.magnification.

Deprecations:
  • visionEnhancementProviders.screenCurtain.MAGCOLOREFFECT is deprecated. Use winBindings.magnification.MAGCOLOREFFECT instead.
  • visionEnhancementProviders.screenCurtain.isScreenFullyBlack is deprecated. Use NVDAHelper.localLib.isScreenFullyBlack instead.

NVDA Add-on API Announcements

unread,
Oct 2, 2025, 10:13:07 PMOct 2
to NVDA Add-on API Announcements, NVDA Add-on API Announcements
Add-on API changes have been merged, planned for inclusion in the 2026.1 release:
"Only build 64bit NVDA" #18924.

If API breaks or planned future breaks (deprecations) will cause difficulties for the ongoing development of an add-on you maintain, please let NVDA developers know by replying directly to emails, or via GitHub.

Breaking changes:
  • NVDA is now built as a 64-bit application.
  • 32-bit Windows is no longer supported.
    Windows 10 on ARM is also no longer supported.

NVDA Add-on API Announcements

unread,
Oct 9, 2025, 9:36:33 PMOct 9
to NVDA Add-on API Announcements, NVDA Add-on API Announcements
Add-on API changes have been merged, planned for inclusion in the 2026.1 release:
"Use root certificates when using the add-on store and NVDA remote #18528".

If API breaks or planned future breaks (deprecations) will cause difficulties for the ongoing development of an add-on you maintain, please let NVDA developers know by replying directly to emails, or via GitHub.

Breaking changes:
  • NVDA now uses truststore to always use Windows root certificates, which injects to libraries like requests.
    Wrap code with truststore.extract_from_ssl and truststore.inject_into_ssl to disable this behavior where required.

Deprecations:
  • updateCheck.UPDATE_FETCH_TIMEOUT_S is deprecated for removal without replacement.

NVDA Add-on API Announcements

unread,
Oct 14, 2025, 2:01:30 AMOct 14
to NVDA Add-on API Announcements, NVDA Add-on API Announcements
Add-on API changes have been merged, planned for inclusion in the 2026.1 release:
"Update wxPython to 4.2.3 #19080".

If API breaks or planned future breaks (deprecations) will cause difficulties for the ongoing development of an add-on you maintain, please let NVDA developers know by replying directly to emails, or via GitHub.

Breaking changes:
  • wxPython has been updated to 4.2.3. 
  • gui.nvdaControls.TabbableScrolledPanel has been removed. Use wx.lib.scrolledpanel.ScrolledPanel directly instead.

NVDA Add-on API Announcements

unread,
Oct 16, 2025, 10:49:17 PMOct 16
to NVDA Add-on API Announcements
Please be advised that "Use root certificates when using the add-on store and NVDA remote" (#18528) has been reverted by PR #19106. The API changes introduced by #18528 no-longer apply.

NVDA Add-on API Announcements

unread,
Oct 20, 2025, 11:38:57 PMOct 20
to NVDA Add-on API Announcements
Add-on API changes have been merged, planned for inclusion in the 2026.1 release:
"File Explorer app module: remove support for Windows 8.x Start screen workarounds" #19117.


If API breaks or planned future breaks (deprecations) will cause difficulties for the ongoing development of an add-on you maintain, please let NVDA developers know by replying directly to emails, or via GitHub.

Breaking changes:
  • The following Windows 8.x Start screen support symbols have been removed from `appModules.explorer` (File Explorer) app module with no replacement: SuggestionListItem, SearchBoxClient, GridTileElement, GridListTileElement, GridGroup, ImmersiveLauncher.

Deprecations:
  • None

NVDA Add-on API Announcements

unread,
Oct 30, 2025, 8:46:10 PM (7 days ago) Oct 30
to NVDA Add-on API Announcements
Add-on API changes have been merged, planned for inclusion in the 2026.1 release:
"Update the FTDI interface to be 64-bit compatible" #19105.


If API breaks or planned future breaks (deprecations) will cause difficulties for the ongoing development of an add-on you maintain, please let NVDA developers know by replying directly to emails, or via GitHub.

Breaking changes:
  • The ftdi2 module has been significantly refactored:
    • It is now a package.
    • MAX_DESCRIPTION_SIZE has been moved to ftd2xx.MAX_DESCRIPTION_SIZE, and reduced to 64 in accordance with the D2XX Programmer’s Guide.
    • FT_OK has been removed. Use ftd2xx.FT_MESSAGE.OK instead.
    • The FT_LIST_* constants have been removed. Use the ftd2xx.FT_LIST enum instead.
    • The FT_OPEN_BY_SERIAL_NUMBER constant has been removed. Use ftd2xx.FT_OPEN_BY.SERIAL_NUMBER instead.
    • The FT_PURGE_RX and FT_PURGE_TX constants have been removed. Use ftd2xx.FT_PURGE.RX and ftd2xx.FT_PURGE.TX instead.
    • FtdiBitModes has been moved to ftd2xx.FT_BITMODE.
    • The ft_messages list has been replaced with the ftd2xx.FT_MESSAGE enum.
    • ft has been removed. Use ftd2xx.dll instead.
    • FTDeviceError has been moved to ftd2xx.FTDeviceError.
    • DeviceListInfoNode has been moved to ftd2xx.FT_DEVICE_LIST_INFO_NODE. Additionally, in accordance with the D2XX Programmer's Guide:
      • The LocID field has been renamed to LocId.
      • The none field has been renamed to ftHandle.
    • The ftExceptionDecorator function has been removed, with no public replacement.
    • The _PY_* functions have been replaced with ftd2xx.FT_* direct FFI bindings. These bindings have type declarations, so are potentially incompatible with existing code.
    • The following functions have been renamed:
      • list_devices to listDevices;
      • create_device_info_list to createDeviceInfoList;
      • get_device_info_detail to getDeviceInfoDetail;
      • get_device_info_list to getDeviceInfoList; and
      • open_ex to openEx.
    • The following methods on the FTD2XX class have been   renamed:
      • set_baud_rate to setBaudRate;
      • set_timeouts to setTimeouts;
      • set_latency_timer to setLatencyTimer;
      • set_bit_mode to setBitMode;
      • set_usb_parameters to setUsbParameters;    * get_queue_status to getQueueStatus; and
      • reset_device to resetDevice.
    • The FTD2XX.purge method now raises ValueError If the toPurge argument is not one of "TX", "RX" or "TXRX".

Deprecations:
  • None
Reply all
Reply to author
Forward
0 new messages