Home

Awesome

NBTui

demo

An interactive viewer for Jupyter notebooks from the command line.

It should work for any terminal, but you will only be able to view plots when using Kitty, or any terminal that implements the Kitty graphics protocol.

This is a work in progress, and things may break. Bug reports and general constructive criticism about implementation details are welcome.

Install

pip install nbtui

nbtui {NOTEBOOK}.ipynb

Or, you can directly pull this folder from master (this is recommended, since there are most likely still going to be some issues):

python -m nbtui {NOTEBOOK}.ipynb

Features

Usage

Movement and scrolling is based on vim keybindings - j to scroll down, k to scroll up, C-D to scroll down by 15 lines, C-U to scroll up by 15 lines. Press g and G to go to the beginning and end of the notebook, respectively, press / to start searching, and press q to close.

NOTE: currently, displaying images is done in a quite inefficient way. I plan to update this logic soon to take advantage of new features from the Kitty graphics protocol, once Kitty version 0.19.3 has been out for a little while longer.

In the meantime, prefer using C-D and C-U to scrolling when many images are on the screen, to avoid large slowdowns.

Planned features

For obvious reasons, rich output formats like HTML, PDF, Javascript, videos, audio, and hyperlinks are not planned to be implemented.