This documentation covers a development version of IPython. The development version may differ significantly from the latest stable release.


This documentation covers IPython versions 6.0 and higher. Beginning with version 6.0, IPython stopped supporting compatibility with Python versions lower than 3.3 including all versions of Python 2.7.

If you are looking for an IPython version compatible with Python 2.7, please use the IPython 5.x LTS release and refer to its documentation (LTS is the long term support release).

Module: utils.terminal

Utilities for working with terminals.


  • Brian E. Granger

  • Fernando Perez

  • Alexander Belchenko (e-mail: bialix AT ukr.net)

5 Functions


Control whether set_term_title is active or not.

set_term_title() allows writing to the console titlebar. In embedded widgets this can cause problems, so this call can be used to toggle it on or off as needed.

The default state of the module is for the function to be disabled.


val (bool) – If True, set_term_title() actually writes to the terminal (using the appropriate platform-specific module). If False, it is a no-op.


Set terminal title using the necessary platform-dependent calls.


Restore, if possible, terminal title to the original state

IPython.utils.terminal.get_terminal_size(defaultx=80, defaulty=25)