tuxu / ipynb-quicklook

A Quick Look generator for Jupyter/IPython notebooks without further dependencies

ipynb-quicklook

Note: This plugin has now been integrated into a native macOS app, Jupyter Notebook Viewer. This is the recommended way to install the QuickLook generator.

A stand-alone Quick Look generator for Jupyter/IPython notebooks on macOS. Contents are rendered on-the-fly using nbviewer.js.

Getting started

• Download ipynb-quicklook.qlgenerator (Releases)
• The generator is unsigned and not notarized by Apple. You need to remove the quarantine attribute like this on macOS Catalina and later (#6):

  xattr -d com.apple.quarantine ipynb-quicklook.qlgenerator

• Move the generator into /Library/QuickLook ¹. You may need to run qlmanage -r to reset the Quick Look server and caches.
• Press space whenever you encounter a .ipynb file. Enjoy 👍

Similar projects

• jupyter-notebook-quick-look: renders using the nbconvert utility.

Acknowledgments

• Ondrej Kokes for nbviewer.js

License

This project is licensed under the MIT license. See LICENSE.md for details.

© 2017 Tino Wagner

Footnotes

1. Note that the generator must be installed globally. Installation to ~/Library/QuickLook/ is not sufficient (see #4). ↩