Skip to main content
This is a pre-production deployment of Warehouse. Changes made here affect the production instance of PyPI (
Help us improve Python packaging - Donate today!

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+).
Release History

Release History

This version
History Node


History Node


History Node


History Node


History Node


History Node


History Node


History Node


History Node


Download Files

Download Files

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

File Name & Checksum SHA256 Checksum Help Version File Type Upload Date
IPythonBell-0.10.tar.gz (3.5 kB) Copy SHA256 Checksum SHA256 Source May 29, 2017

Supported By

WebFaction WebFaction Technical Writing Elastic Elastic Search Pingdom Pingdom Monitoring Dyn Dyn DNS Sentry Sentry Error Logging CloudAMQP CloudAMQP RabbitMQ Heroku Heroku PaaS Kabu Creative Kabu Creative UX & Design Fastly Fastly CDN DigiCert DigiCert EV Certificate Rackspace Rackspace Cloud Servers DreamHost DreamHost Log Hosting