Skip to content
iPython line & cell magic to notify the programmer when a line/cell has completed execution.
Find file
Latest commit cfc14cc @samwhitehall Merge pull request #1 from garrison/py3k
[py3k] removed relative imports
Failed to load latest commit information.
ipybell [py3k] removed relative imports
.gitignore basic .gitignore Added reference to pip (PyPI) installation
README.txt PyPI compliance PyPI compliance


IPython Bell is a simple magic for IPython, which notifies the user when the current line/cell has finished execution. This is particularly useful for long tasks. This also works in IPython QT and IPython Notebook. It can also notify you via. OS X Notification Center.


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 ipybell or %load_ext ipybell

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 ipybell to :

c.TerminalIPythonApp.extensions = [

(you may need to create this).


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 -- (default) prints an audible bell character to stdout (doesn't work in Notebook).
  • Mac System Beep osx -- system beep (Mac OS X only).
  • Notification Center nc -- Notification Center (Mac OS X 10.8+ only)
  • Notification Center (silent) ncsilent -- Notification Center, just popup (Mac OS X 10.8+ only)

Specified as follows (in this case, for Notification Center):

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

In[2]: %%bell -n nc
import time
Something went wrong with that request. Please try again.