Skip to main content

JupyterLab Distribution with a retro look and feel

Project description

RetroLab

Github Actions Status Binder Binder main PyPI conda-forge

RetroLab (also known as JupyterLab Retro, previously called JupyterLab Classic) is a JupyterLab distribution with a retro look and feel.

image

Install

retrolab can be installed with pip:

pip install retrolab

With mamba:

mamba install -c conda-forge retrolab

With conda:

conda install -c conda-forge retrolab

Usage

retrolab can be started as a standalone app with:

jupyter retro

Existing federated JupyterLab extensions listed via:

jupyter labextension list

Should also be available when starting retrolab.

Launching

From an open notebook:

  1. Click the RetroLab button in the toolbar; or
  2. View > Open in RetroLab from the menu

To access the main RetroLab tree (file browser):

  1. Help > Launch RetroLab File Browser from the menu; or
  2. Go to the /retro URL path of your Jupyter site

Tour

Files 📂 and Running Sessions 🏃‍♀️

tree

Notebook 📒

notebook

Open in a new Browser Tab by default

new-browser-tab

Command Palette 🎨

command-palette

Themes 🌈

Support for existing JupyterLab themes!

themes

For an even more retro look, you might want to start retrolab with the --retro-logo CLI flag:

jupyter retro --retro-logo

# or
# jupyter retro --RetroApp.retro_logo=True

Example with the JupyterLab Miami Nights Theme installed as a prebuilt extension:

image

Zen Mode 😌

compact-zen-mode

Terminals 🖥️

terminals

File Editor 🖊️

image

Compact View on Mobile Devices 📱

mobile

Support for prebuilt extensions 🧩

Install new extensions easily!

federated-extensions

Switch between JupyterLab and RetroLab easily ↔️

jupyterlab-switch

Contributing

If you would like to contribute to the project and set up a development environment, check out CONTRIBUTING.md.

Motivation

JupyterLab is the next-gen UI for Project Jupyter. Currently at version 3.0, it is becoming more mature and provides an advanced computational environment, that can sometimes be compared to what traditional IDEs offer.

However in some cases, having a leaner, simpler, and more focused interface to work on a notebook is really useful.

The single document mode as currently implemented in JupyterLab helps address this issue, but still displays a couple of visual cues that can be distracting to some users.

The goal of the retrolab project is to provide an alternative JupyterLab distribution with the look and feed of the classic notebook UI, while leveraging the efforts put in the development of JupyterLab itself and its extension system.

Technically speaking, retrolab reuses many of the existing plugins for JupyterLab (notebook, toolbar), and also supports prebuilt (federated) third-party extensions using the new distribution system added in 3.0. That way, extensions built for JupyterLab should also be compatible with retrolab, as long as they can be added to the application shell provided by RetroLab.

Relation to other Jupyter frontends

RetroLab is an alternative frontend built using the latest JupyterLab components, with the look and feel of the Classic Jupyter Notebook UI. Below is a short comparison to know where it stands when compared to other Jupyter UI projects:

  • Classic Jupyter Notebook - Classic frontend, classic notebook server.
  • NBClassic - Classic frontend, new Jupyter Server.
  • JupyterLab - Jupyterlab frontend, new Jupyter Server (or Classic Notebook Server). Extensions are not compatible with the Classic Jupyter Notebook since it is built with different components. With version 3.0 onwards, it uses the new Jupyter Server and supports federated extensions that don't need to be rebuilt on the end-user machine.
  • RetroLab - JupyterLab frontend built with JupyterLab components, with the look and feel of the Classic Notebook. Consistent with the latest version of Jupyterlab. Extensions built for Jupyterlab should work as long as the components they depend on are part of this classic interface (for install RetroLab doesn't have the left, right and bottom areas).

Prior art

This project is mostly a reboot of the two previous attempts at making something similar:

These projects really expressed the need for a stripped down, minimal version of the Jupyter Notebook UI.

retrolab contributes to that space with the added features:

  • Support for existing federated (prebuilt) JupyterLab extensions
  • Zen Mode
  • Repo structure, similar to JupyterLab
  • Reusing as much as possible from upstream JupyterLab
  • Serve as a template and reference implementation for other alternative JupyterLab distributions

Community Guidelines and Code of Conduct

This repository is a Jupyter project and follows the Jupyter Community Guides and Code of Conduct.

Project details


Download files

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

Source Distribution

retrolab-0.3.2.tar.gz (3.1 MB view hashes)

Uploaded Source

Built Distribution

retrolab-0.3.2-py3-none-any.whl (3.2 MB view hashes)

Uploaded Python 3

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page