ovos-utterance-plugin-cancel

This is an OpenVoiceOS utterance transformer plugin. It cancels an utterance when the user says a cancel or "nevermind" phrase at the end.

Example: for the phrase "Hey Mycroft, can you tell me the weather in… ugh, nevermind that", the plugin drops the utterance, and no skill fires.

Installation

pip install ovos-utterance-plugin-cancel

How it works

The plugin runs before skill matching. It checks whether the end of the utterance matches any phrase from locale/<lang>/cancel.intent. On a match, it returns an empty utterance list with context {"canceled": True, "cancel_word": "<phrase>"}.

The plugin selects the language automatically with langcodes.closest_match. Phrases support bracket-expansion syntax, for example cancel (it|that).

Supported languages

ca-ES · da-DK · de-DE · en-US · es-ES · fr-FR · gl-ES · it-IT · nl-NL · pt-BR · pt-PT

To add a language, create ovos_utterance_plugin_cancel/locale/<lang>/cancel.intent with one phrase per line.

Configuration

This plugin is enabled by default in ovos-config alongside the other standard utterance transformers:

"utterance_transformers": {
    "ovos-utterance-normalizer": {},
    "ovos-utterance-plugin-cancel": {},
    "ovos-utterance-corrections-plugin": {}
}

To disable it, add "enable": false to your config:

"utterance_transformers": {
    "ovos-utterance-plugin-cancel": {"enable": false}
}

Development

git clone https://github.com/OpenVoiceOS/ovos-utterance-plugin-cancel
cd ovos-utterance-plugin-cancel
uv pip install -e ".[dev]"
uv run pytest test/ -v --cov=ovos_utterance_plugin_cancel

OpenVoiceOS/ovos-utterance-normalizer: normalizes utterances before this plugin runs
OpenVoiceOS/ovos-utterance-corrections-plugin: corrects utterances after this plugin runs

Credits

@penrods: original Mycroft PR
NeonGecko: original plugin

Metadata

Release files for ovos-utterance-plugin-cancel 0.3.4a1

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for ovos-utterance-plugin-cancel 0.3.4a1
File	Size	Uploaded
ovos_utterance_plugin_cancel-0.3.4a1.tar.gz	16.3 kB	Sep 14, 2026	Details

Built distribution (wheel)

Table of built distributions (wheels) for ovos-utterance-plugin-cancel 0.3.4a1
File	Interpreter	ABI	Platform	Reset
ovos_utterance_plugin_cancel-0.3.4a1-py3-none-any.whl 27.4 kB Sep 14, 2026	Python 3	none	any	Details

Total release size: 43.7 kB

Release files / ovos_utterance_plugin_cancel-0.3.4a1.tar.gz

Download URL	ovos_utterance_plugin_cancel-0.3.4a1.tar.gz
Size	16.3 kB
Tags	Source
SHA-256 checksum How to use checksums	`2f2e318844a82f9cfd1c0aaf10a204f19d6d2b9f440df2b09e731f31489a59f3`
BLAKE2b-256 checksum How to use checksums	`78469f95159f78e650bda00788dd78d6ee843cda9373cc271870333bb3e8d056`
Upload date	Sep 14, 2026
Uploaded using Trusted Publishing? What is trusted publishing?	No
Uploaded via	`twine/7.0.0 CPython/3.13.14`

Release files / ovos_utterance_plugin_cancel-0.3.4a1-py3-none-any.whl

Download URL	ovos_utterance_plugin_cancel-0.3.4a1-py3-none-any.whl
Size	27.4 kB
Tags	Python 3
SHA-256 checksum How to use checksums	`eecdc0c369af2e1b46d045a3111d6414e949ec56e9440d38829c0de604e39745`
BLAKE2b-256 checksum How to use checksums	`0d08ba3f6e90602966d5f842c679b39e74d92b0fb68f7f70d637b7be74c70275`
Upload date	Sep 14, 2026
Uploaded using Trusted Publishing? What is trusted publishing?	No
Uploaded via	`twine/7.0.0 CPython/3.13.14`