Skip to content

Instantly share code, notes, and snippets.

@parente parente/
Last active Aug 28, 2018

What would you like to do?
Jupyter Tidbit: Run and say "done!"


Many modern web browsers provide a speech synthesis API for JavaScript. You can write and invoke a function to have your notebook speak when it finishes executing certain cells, whether you're running it in JupyterLab (>=0.34) or classic Jupyter Notebook.

def speak(text):
    from IPython.display import Javascript as js, clear_output
    # Escape single quotes
    text = text.replace("'", r"\'")
    if(window.speechSynthesis) {{
        var synth = window.speechSynthesis;
        synth.speak(new window.SpeechSynthesisUtterance('{text}'));
    # Clear the JS so that the notebook doesn't speak again when reopened/refreshed


  • Binder (Jupyter Notebook)
  • Binder (JupyterLab)

When I open the demo.ipynb notebook below and Run All cells, I hear the notebook speak aloud when it finishes executing the first and second loops.

Why is this useful?

You can add notifications at select locations in your notebook to report execution progress even while you're not looking at the notebook


You can also use the %%javascript cell magic to achieve the same net effect in Jupyter Notebook.

if(window.speechSynthesis) {{
    var synth = window.speechSynthesis;
    synth.speak(new window.SpeechSynthesisUtterance('All done!'));
    setTimeout(this.clear_output.bind(this), 0);

However, the same code doesn't properly clear the JS from the notebook document in JupyterLab, and the notebook speaks immediately when opened unless you clear the cell output manually.

The jupyter_contrib_nbextensions project includes a notify extension for Jupyter Notebook which can show desktop popups and play a sounds when unattended notebooks become idle.

Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
You can’t perform that action at this time.