Links
Comment on page

Message Types

Messages are used to communicate information between Mycroft services and other components. This list of Message types outlines the details and provides sample code for each.
Each Message type listed contains a description outlining it's meaning or purpose. Where relevant, the Message type will also list the specific JSON data packets expected to be emitted with that Message, and the most common producers and consumers of the Message.
See the MessageBus documentation for further information on this service and examples of using Messages.

General

speak

Request to speak utterance
Data:
{
"utterance": <words to be spoken>,
"lang": <language code, e.g. en-us>
}
Usage:
Message handler in MycroftSkill
Generating Message from MycroftSkill
Command line invocation
...
def initialize(self):
self.add_event('speak',
self.handler_speak)
def handler_speak(self, message):
# code to excecute when speak message detected...
...
...
def some_method(self):
self.bus.emit(Message('speak',
{"utterance": <words to be spoken>,
"lang": <language code, e.g. en-us>}))
...
python3 -m mycroft.messagebus.send 'speak' '{ "utterance": <words to be spoken>, "lang": <language code, e.g. en-us>}'

mycroft.internet.connected

Internet connection is now available (only generated on initial connection)
Usage:
Message handler in MycroftSkill
Generating Message from MycroftSkill
Command line invocation
...
def initialize(self):
self.add_event('mycroft.internet.connected',
self.handler_mycroft_internet_connected)
def handler_mycroft_internet_connected(self, message):
# code to excecute when mycroft.internet.connected message detected...
...
...
def some_method(self):
self.bus.emit(Message('mycroft.internet.connected'))
...
python3 -m mycroft.messagebus.send 'mycroft.internet.connected'

mycroft.ready

Sent by start-up sequence when everything is ready for user interaction
Producer
Consumer
skills/padatious_service.py
Pairing Skill
Usage:
Message handler in MycroftSkill
Generating Message from MycroftSkill
Command line invocation
...
def initialize(self):
self.add_event('mycroft.ready',
self.handler_mycroft_ready)
def handler_mycroft_ready(self, message):
# code to excecute when mycroft.ready message detected...
...
...
def some_method(self):
self.bus.emit(Message('mycroft.ready'))
...
python3 -m mycroft.messagebus.send 'mycroft.ready'

mycroft.stop

Stop command (e.g. button pressed)
Usage:
Message handler in MycroftSkill
Generating Message from MycroftSkill
Command line invocation
...
def initialize(self):
self.add_event('mycroft.stop',
self.handler_mycroft_stop)
def handler_mycroft_stop(self, message):
# code to excecute when mycroft.stop message detected...
...
...
def some_method(self):
self.bus.emit(Message('mycroft.stop'))
...
python3 -m mycroft.messagebus.send 'mycroft.stop'

mycroft.not.paired

Start the pairing process when this event is emitted.
Producer
Consumer
Pairing Skill
Weather Skill
Wolfram Alpha Skill
Pairing Skill
Message handler in MycroftSkill
Generating Message from MycroftSkill
Command line invocation
...
def initialize(self):
self.add_event('mycroft.not.paired',
self.handler_mycroft_not_paired)
def handler_mycroft_not_paired(self, message):
# code to excecute when mycroft.not.paired message detected...
...
...
def some_method(self):
self.bus.emit(Message('mycroft.not.paired'))
...
python3 -m mycroft.messagebus.send 'mycroft.not.paired'

mycroft.paired

Pairing has completed
Producer
Consumer
Pairing Skill
skills/skill_manager.py
enclosure/mark1/__init__.py
enclosure/generic/__init__.py
client/speech/__main__.py
Message handler in MycroftSkill
Generating Message from MycroftSkill
Command line invocation
...
def initialize(self):
self.add_event('mycroft.paired',
self.handler_mycroft_paired)
def handler_mycroft_paired(self, message):
# code to excecute when mycroft.paired message detected...
...
...
def some_method(self):
self.bus.emit(Message('mycroft.paired'))
...
python3 -m mycroft.messagebus.send 'mycroft.paired'

mycroft.awoken

Has come out of sleep mode
Usage:
Message handler in MycroftSkill
Generating Message from MycroftSkill
Command line invocation
...
def initialize(self):
self.add_event('mycroft.awoken',
self.handler_mycroft_awoken)
def handler_mycroft_awoken(self, message):
# code to excecute when mycroft.awoken message detected...
...
...
def some_method(self):
self.bus.emit(Message('mycroft.awoken'))
...
python3 -m mycroft.messagebus.send 'mycroft.awoken'

mycroft.debug.log

log level can be: "CRITICAL" "ERROR" "WARNING" "INFO" "DEBUG" These correspond to the Python logging object.
The "bus" parameter allows turning the logging of all bus messages on/off.
Data:
{
"level" : <log level>,
"bus": <True/False>
}
Usage:
Message handler in MycroftSkill
Generating Message from MycroftSkill
Command line invocation
...
def initialize(self):
self.add_event('mycroft.debug.log',
self.handler_mycroft_debug_log)
def handler_mycroft_debug_log(self, message):
# code to excecute when mycroft.debug.log message detected...
...
...
def some_method(self):
self.bus.emit(Message('mycroft.debug.log',
{
"level" : <log level>,
"bus": <True/False>}))
...
python3 -m mycroft.messagebus.send 'mycroft.debug.log' '{ "level" : <log level>, "bus": <True/False>}'

complete_intent_failure

Intent processing failed
Usage:
Message handler in MycroftSkill
Generating Message from MycroftSkill
Command line invocation
...
def initialize(self):
self.add_event('complete_intent_failure',
self.handler_complete_intent_failure)
def handler_complete_intent_failure(self, message):
# code to excecute when complete_intent_failure message detected...
...
...
def some_method(self):
self.bus.emit(Message('complete_intent_failure'))
...
python3 -m mycroft.messagebus.send 'complete_intent_failure'

configuration.updated

Notification to services that the configuration has changed and needs reloaded
Usage:
Message handler in MycroftSkill
Generating Message from MycroftSkill
Command line invocation
...
def initialize(self):
self.add_event('configuration.updated',
self.handler_configuration_updated)
def handler_configuration_updated(self, message):
# code to excecute when configuration.updated message detected...
...
...
def some_method(self):
self.bus.emit(Message('configuration.updated'))
...
python3 -m mycroft.messagebus.send 'configuration.updated'

Recognizer

recognizer_loop:wakeword

Wakeword was heard
Data:
{
"utterance": <wakeword heard>,
"session": <session ID>,
}
Producer
Consumer
client/speech/main.py
Usage:
Message handler in MycroftSkill
Generating Message from MycroftSkill
Command line invocation
...
def initialize(self):
self.add_event('recognizer_loop:wakeword',
self.handler_wakeword)
def handler_wakeword(self, message):
# code to excecute when recognizer_loop:wakeword message detected...
...
...
def some_method(self):
self.bus.emit(Message('recognizer_loop:wakeword',
{"utterance": <wakeword heard>,
"session": <session ID>,}
))
...
python3 -m mycroft.messagebus.send 'recognizer_loop:wakeword' '{ "utterance": <wakeword heard>, "session": <session ID>,}'

recognizer_loop:record_begin

Recording has started
Producer
Consumer
client/speech/main.py
Usage:
Message handler in MycroftSkill
Generating Message from MycroftSkill
Command line invocation
...
def initialize(self):
self.add_event('recognizer_loop:record_begin',
self.handler_record_begin)
def handler_record_begin(self, message):
# code to excecute when recognizer_loop:record_begin message detected...
...
...
def some_method(self):
self.bus.emit(Message('recognizer_loop:record_begin'))
...
python3 -m mycroft.messagebus.send 'recognizer_loop:record_begin'

recognizer_loop:record_end

Recording has ended
Producer
Consumer
client/speech/main.py
Usage:
Message handler in MycroftSkill
Generating Message from MycroftSkill
Command line invocation
...
def initialize(self):
self.add_event('recognizer_loop:record_end',
self.handler_record_end)
def handler_record_end(self, message):
# code to excecute when recognizer_loop:record_end message detected...
...
...
def some_method(self):
self.bus.emit(Message('recognizer_loop:record_end'))
...
python3 -m mycroft.messagebus.send 'recognizer_loop:record_end'

recognizer_loop:utterance

STT has detected the given text or text was injected as an utterance via the CLI.
Data:
{
"utterances": [text],
"lang": self.stt.lang,
"session": session_id
}
Producer
Consumer
client/speech/__main__.py
client/speech/listener.py
client/text/text_client.py
skills/__main__.py
client/text/text_client.py
messagebus/client/client.py
skills/intent_service.py
Message handler in MycroftSkill
Generating Message from MycroftSkill
Command line invocation
...
def initialize(self):
self.add_event('recognizer_loop:utterance',
self.handler_utterance)
def handler_utterance(self, message):
# code to excecute when recognizer_loop:utterance message detected...
...
...
def some_method(self):
self.bus.emit(Message('recognizer_loop:utterance',
{"utterances": [text],
"lang": self.stt.lang,
"session": session_id}))
...
python3 -m mycroft.messagebus.send 'recognizer_loop:utterance' '{ "utterances": [text], "lang": self.stt.lang, "session": session_id}'

recognizer_loop:audio_output_start

Text output (TTS) has begun
Producer
Consumer
audio/speech.py
Usage:
Message handler in MycroftSkill
Generating Message from MycroftSkill
Command line invocation
...
def initialize(self):
self.add_event('recognizer_loop:audio_output_start',
self.handler_audio_output_start)
def handler_audio_output_start(self, message):
# code to excecute when recognizer_loop:audio_output_start message detected...
...
...
def some_method(self):
self.bus.emit(Message('recognizer_loop:audio_output_start'))
...
python3 -m mycroft.messagebus.send 'recognizer_loop:audio_output_start'

recognizer_loop:audio_output_end

Text output (TTS) has ended
Producer
Consumer
audio/speech.py
Usage:
Message handler in MycroftSkill
Generating Message from MycroftSkill
Command line invocation
...
def initialize(self):
self.add_event('recognizer_loop:audio_output_end',
self.handler_audio_output_end)
def handler_audio_output_end(self, message):
# code to excecute when recognizer_loop:audio_output_end message detected...
...
...
def some_method(self):
self.bus.emit(Message('recognizer_loop:audio_output_end'))
...
python3 -m mycroft.messagebus.send 'recognizer_loop:audio_output_end'

recognizer_loop:sleep

Go into "sleep" mode. Everything except "Hey Mycroft, wake up" will be ignored.
Usage:
Message handler in MycroftSkill
Generating Message from MycroftSkill
Command line invocation
...
def initialize(self):
self.add_event('recognizer_loop:sleep',
self.handler_sleep)
def handler_sleep(self, message):
# code to excecute when recognizer_loop:sleep message detected...
...
...
def some_method(self):
self.bus.emit(Message('recognizer_loop:sleep'))
...
python3 -m mycroft.messagebus.send 'recognizer_loop:sleep'

recognizer_loop:wake_up

Come out of "sleep" mode.
Usage:
Message handler in MycroftSkill
Generating Message from MycroftSkill
Command line invocation
...
def initialize(self):
self.add_event('recognizer_loop:wake_up',
self.handler_wake_up)
def handler_wake_up(self, message):
# code to excecute when recognizer_loop:wake_up message detected...
...
...
def some_method(self):
self.bus.emit(Message('recognizer_loop:wake_up'))
...
python3 -m mycroft.messagebus.send 'recognizer_loop:wake_up'

Enclosure

enclosure.notify.no_internet

Detected a connection error during STT
Producer
Consumer
audio/speech.py
Usage:
Message handler in MycroftSkill
Generating Message from MycroftSkill
Command line invocation
...
def initialize(self):
self.add_event('enclosure.notify.no_internet',
self.handler_enclosure_notify_no_internet)
def handler_enclosure_notify_no_internet(self, message):
# code to excecute when enclosure.notify.no_internet message detected...
...
...
def some_method(self):
self.bus.emit(Message('enclosure.notify.no_internet'))
...
python3 -m mycroft.messagebus.send 'enclosure.notify.no_internet'

enclosure.mouth.viseme_list

start: timestamp for audio starts (unix epoch) END_TIME: time in seconds from "start" until the end of the viseme CODE can be 0 = shape for sounds like 'y' or 'aa' 1 = shape for sounds like 'aw' 2 = shape for sounds like 'uh' or 'r' 3 = shape for sounds like 'th' or 'sh' 4 = neutral shape for no sound 5 = shape for sounds like 'f' or 'v' 6 = shape for sounds like 'oy' or 'ao'
Data:
{
"start": timestamp,
"visemes": [[CODE,END_TIME],...]
}
Usage:
Message handler in MycroftSkill
Generating Message from MycroftSkill
Command line invocation
...
def initialize(self):
self.add_event('enclosure.mouth.viseme_list',
self.handler_enclosure_mouth_viseme_list)
def handler_enclosure_mouth_viseme_list(self, message):
# code to excecute when enclosure.mouth.viseme_list message detected...
...
...
def some_method(self):
self.bus.emit(Message('enclosure.mouth.viseme_list',
{
"start": timestamp,
"visemes": [[CODE,END_TIME],...]}))
...
python3 -m mycroft.messagebus.send 'enclosure.mouth.viseme_list' '{ "start": timestamp, "visemes": [[CODE,END_TIME],...]}'

mycroft.eyes.default

Change eyes to default color
Producer
Consumer
mycroft-mark-1
Usage:
Message handler in MycroftSkill
Generating Message from MycroftSkill
Command line invocation
...
def initialize(self):
self.add_event('mycroft.eyes.default',
self.handler_mycroft_eyes_default)
def handler_mycroft_eyes_default(self, message):
# code to excecute when mycroft.eyes.default message detected...
...
...
def some_method(self):
self.bus.emit(Message('mycroft.eyes.default'))
...
python3 -m mycroft.messagebus.send 'mycroft.eyes.default'

Microphone Behavior

mycroft.mic.listen

Begin recording for STT processing
Usage:
Message handler in MycroftSkill
Generating Message from MycroftSkill
Command line invocation
...
def initialize(self):
self.add_event('mycroft.mic.listen',
self.handler_mycroft_mic_listen)
def handler_mycroft_mic_listen(self, message):
# code to excecute when mycroft.mic.listen message detected...
...
...
def some_method(self):
self.bus.emit(Message('mycroft.mic.listen'))
...
python3 -m mycroft.messagebus.send 'mycroft.mic.listen'

mycroft.mic.mute

Turn off the mic (no wakeword or STT processing)
Producer
Consumer
Pairing Skill
client/speech/main.py
Usage:
Message handler in MycroftSkill
Generating Message from MycroftSkill
Command line invocation
...
def initialize(self):
self.add_event('mycroft.mic.mute',
self.handler_mycroft_mic_mute)
def handler_mycroft_mic_mute(self, message):
# code to excecute when mycroft.mic.mute message detected...
...
...
def some_method(self):
self.bus.emit(Message('mycroft.mic.mute'))
...
python3 -m mycroft.messagebus.send 'mycroft.mic.mute'

mycroft.mic.unmute

Turn on the mic (enable wakeword and STT processing)
Producer
Consumer
Pairing Skill
client/speech/main.py
Usage:
Message handler in MycroftSkill
Generating Message from MycroftSkill
Command line invocation
...
def initialize(self):
self.add_event('mycroft.mic.unmute',
self.handler_mycroft_mic_unmute)
def handler_mycroft_mic_unmute(self, message):
# code to excecute when mycroft.mic.unmute message detected...
...
...
def some_method(self):
self.bus.emit(Message('mycroft.mic.unmute'))
...
python3 -m mycroft.messagebus.send 'mycroft.mic.unmute'

Audio Playback

mycroft.audio.service.play

Start playback of tracklist
Producer
Consumer
skills/audioservice.py
playback-control
audio/main.py
Message handler in MycroftSkill
Generating Message from MycroftSkill
Command line invocation
...
def initialize(self):
self.add_event('mycroft.audio.service.play',
self.handler_mycroft_audio_service_play)
def handler_mycroft_audio_service_play(self, message):
# code to excecute when mycroft.audio.service.play message detected...
...
...
def some_method(self):
self.bus.emit(Message('mycroft.audio.service.play'))
...
python3 -m mycroft.messagebus.send 'mycroft.audio.service.play'

mycroft.audio.service.stop

Stop playback
Producer
Consumer
skills/audioservice.py
playback-control
audio/main.py
Message handler in MycroftSkill
Generating Message from MycroftSkill
Command line invocation
...
def initialize(self):