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):
    self.add_event('mycroft.audio.service.stop',
                   self.handler_mycroft_audio_service_stop)
​
def handler_mycroft_audio_service_stop(self, message):
    # code to excecute when mycroft.audio.service.stop message detected...
...