ovos-utterance-plugin-cancel

An OpenVoiceOS utterance transformer plugin that cancels an utterance when the user says a cancel/nevermind phrase at the end.

Example: "Hey Mycroft, can you tell me the weather in… ugh, nevermind that" → utterance is dropped, no skill fires.

Installation

pip install ovos-utterance-plugin-cancel

How it works

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

Language selection is automatic via langcodes.closest_match. Phrases support bracket-expansion syntax (e.g. 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

Credits

@penrods — original Mycroft PR
NeonGecko — original plugin

Metadata

Release files for ovos-utterance-plugin-cancel 0.2.8

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.2.8
File	Size	Uploaded
ovos_utterance_plugin_cancel-0.2.8.tar.gz	12.0 kB	Apr 17, 2026	Details

Built distribution (wheel)

Table of built distributions (wheels) for ovos-utterance-plugin-cancel 0.2.8
File	Interpreter	ABI	Platform	Reset
ovos_utterance_plugin_cancel-0.2.8-py3-none-any.whl 13.6 kB Apr 17, 2026	Python 3	none	any	Details

Total release size: 25.5 kB

Release files / ovos_utterance_plugin_cancel-0.2.8.tar.gz

Download URL	ovos_utterance_plugin_cancel-0.2.8.tar.gz
Size	12.0 kB
Tags	Source
SHA-256 checksum How to use checksums	`dbc29e4030ffee627a712ec4117c4dcb0292598f802028a4b40a47c59b770d51`
BLAKE2b-256 checksum How to use checksums	`3d7cef2583194029d0eb831cc597e0cfdf850ccbdda4a494024839e4f6044cf6`
Upload date	Apr 17, 2026
Uploaded using Trusted Publishing? What is trusted publishing?	No
Uploaded via	`twine/6.1.0 CPython/3.13.12`

Release files / ovos_utterance_plugin_cancel-0.2.8-py3-none-any.whl

Download URL	ovos_utterance_plugin_cancel-0.2.8-py3-none-any.whl
Size	13.6 kB
Tags	Python 3
SHA-256 checksum How to use checksums	`ca98257c634cf2a96dd2b876aab4de0f104518a72e63f2b3499bdafbf76abda4`
BLAKE2b-256 checksum How to use checksums	`2c6d0d0f9b52d4145030f4d701d0d3fd0b129b04a1f9ac53584a8de66247db2c`
Upload date	Apr 17, 2026
Uploaded using Trusted Publishing? What is trusted publishing?	No
Uploaded via	`twine/6.1.0 CPython/3.13.12`