Skip to main content

IPython/Jupyter notebook magic to notify the programmer when a line/cell has completed execution

Project description


IPython Bell is a simple magic for IPython and Jupyter Notebooks, which notifies yoy when the current line/cell has finished execution. This is particularly useful for long tasks. It can make sounds or even make notification bubbles pop up.


IPython bell can be installed as a standard Python package: either from PyPI:

pip install IPythonBell

or from git:

git clone
cd ipython-bell/
python install

This can be imported into an IPython shell session using either: import ipython_bell or %load_ext ipython_bell

Although you probably want it to load when IPython loads, in which case, edit your IPython profile file (by default ~/.ipython/profile_default/ and add ipython_bell to :

c.TerminalIPythonApp.extensions = [

(you may need to create this, and can do so with ipython profile create).


This can be used as a magic for a single line (line magic):

In [1]: %bell print 'hello'

or across multiple lines (cell magic):

In[2]: %%bell
import time

There are four currently available notifiers, selectable with the -n or --notifier arguments:

  • Terminal Bell term: prints an audible bell character to stdout (doesn’t work in Notebook).
  • Say say: play a system sound & use text-to-speech.
  • Notification notify: (default) operating system notification with sound.
  • Silent Notification notify-silent: operating notification without sound

Specified as follows (in this case, for notify):

In [1]: %bell -n notify print 'hello'

In[2]: %%bell -n notify
import time


  • MacOS: should work out of the box.
  • Linux: you may need to install beep and/or libnotify.
  • Windows: entirely untested, so please create an issue if it doesn’t work (notifications only designed to work work on Windows 10+).

Project details

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Files for IPythonBell, version 0.10
Filename, size File type Python version Upload date Hashes
Filename, size IPythonBell-0.10.tar.gz (3.5 kB) File type Source Python version None Upload date Hashes View hashes

Supported by

Elastic Elastic Search Pingdom Pingdom Monitoring Google Google BigQuery Sentry Sentry Error logging AWS AWS Cloud computing DataDog DataDog Monitoring Fastly Fastly CDN SignalFx SignalFx Supporter DigiCert DigiCert EV certificate StatusPage StatusPage Status page