nvda-addon-kit

Scaffold, build, translate and install NVDA add-ons from a single addon.toml.

This is the successor to the SCons-based addonTemplate. Instead of forking a template repository and editing buildVars.py, you install a tool:

pip install nvda-addon-kit
nvaddon init myAddon
cd myAddon
nvaddon build

Commands

Command	Does
`nvaddon init [dir]`	Create a new add-on, interactively or from flags
`nvaddon build`	Produce `<name>-<version>.nvda-addon`
`nvaddon install`	Build, then hand the add-on to NVDA to install
`nvaddon install --link`	Link the working tree into NVDA's add-ons directory for development
`nvaddon pot`	Generate `<name>.pot` from Python sources and `addon.toml`
`nvaddon locale-add <lang>…`	Start a new translation
`nvaddon locale-update`	Merge new messages into every existing translation
`nvaddon locale-compile`	Compile `.po` files and translated manifests
`nvaddon check`	Validate `addon.toml` against add-on store rules
`nvaddon clean`	Remove generated build outputs
`nvaddon migrate`	Modernise a SCons-era add-on: config, build machinery, CI, pyproject
`nvaddon release <version>`	Set version and channel, commit, tag `<version>-<channel>`, and push
`nvaddon crowdin`	Sync translations with Crowdin

Run nvaddon <command> --help for the flags each one accepts.

Releasing

nvaddon release 1.2.0 --channel beta

This writes the version and channel into addon.toml, commits, tags 1.2.0-beta, and pushes the commit and tag with git push --atomic so the remote takes both or neither. If anything fails the working tree is restored to where it started, leaving no half-made release behind. Use --no-push to stop before publishing.

Tags doesn't have prefix by default. If your addon's published tags already have it, You can configure it like below:

[release]
tagPrefix = "v"      # produces v1.2.0-beta instead of 1.2.0-beta

--tag-prefix overrides it for a single release.

addon.toml

[addon]
name = "myAddon"
# Translators: Summary/title for this add-on, shown on install and in the add-on store.
summary = "Add-on user visible name"
# Translators: Long description shown for this add-on in the add-on store.
description = """Description for the add-on.
It can span multiple lines."""
version = "1.0.0"
author = "Name <name@domain.com>"
minimumNVDAVersion = "2024.1"
lastTestedNVDAVersion = "2025.3"

[build]
pythonSources = ["addon/globalPlugins/**/*.py"]

[l10n]
baseLanguage = "en"

The comment above a translatable key becomes that string's translator note in the generated .pot, exactly as # Translators: comments in buildVars.py did:

#. Translators: Summary/title for this add-on, shown on install and in the add-on store.
#: addon.toml:3
msgid "Add-on user visible name"
msgstr ""

Migrating an existing add-on

cd myExistingAddon
pip install nvda-addon-kit
nvaddon migrate
nvaddon check
nvaddon build

migrate --apply removes buildVars.py, sconstruct and site_scons/ for you. It refuses to run on a dirty working tree, so git diff shows exactly what changed.

Licence

GNU General Public License version 2 or later. See COPYING.txt.

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

nvda_addon_kit-0.2.1.tar.gz (58.3 kB view details)

Uploaded Aug 31, 2026 Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

The dropdown lists show the available interpreters, ABIs, and platforms. Enable javascript to be able to filter the list of wheel files.

nvda_addon_kit-0.2.1-py3-none-any.whl (79.1 kB view details)

Uploaded Aug 31, 2026 Python 3

File details

Details for the file nvda_addon_kit-0.2.1.tar.gz.

File metadata

Download URL: nvda_addon_kit-0.2.1.tar.gz
Upload date: Aug 31, 2026
Size: 58.3 kB
Tags: Source
Uploaded using Trusted Publishing? Yes
Uploaded via: twine/7.0.0 CPython/3.13.14

File hashes

Hashes for nvda_addon_kit-0.2.1.tar.gz
Algorithm	Hash digest
SHA256	`3e768d3510864b63470b2a4e1ea578057ce507a02a167391fd1d641f5bd3e3c5`
MD5	`8d9b9b4b85c4a94d7b3ca040bfd1857d`
BLAKE2b-256	`0ff4059f31fab64f5007b5fe6dce19f5ceb188b3cd30a6c85ae7bab7c1dac2d9`

See more details on using hashes here.

Provenance

The following attestation bundles were made for nvda_addon_kit-0.2.1.tar.gz:

Publisher: release.yml on addonFactory/NVDAAddonKit

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

Statement:
- Statement type: https://in-toto.io/Statement/v1
- Predicate type: https://docs.pypi.org/attestations/publish/v1
- Subject name: nvda_addon_kit-0.2.1.tar.gz
- Subject digest: 3e768d3510864b63470b2a4e1ea578057ce507a02a167391fd1d641f5bd3e3c5
- Sigstore transparency entry: 2658714333
- Sigstore integration time: Aug 31, 2026
Source repository:
- Permalink: addonFactory/NVDAAddonKit@9342ea1eb709593b4dc3e505fb40a1f413e27a8d
- Branch / Tag: refs/tags/v0.2.1
- Owner: https://github.com/addonFactory
- Access: public
Publication detail:
- Token Issuer: https://token.actions.githubusercontent.com
- Runner Environment: github-hosted
- Publication workflow: release.yml@9342ea1eb709593b4dc3e505fb40a1f413e27a8d
- Trigger Event: push