Go to file
GitHub Action 8c869b5d33 Publish 0.3.11
SHA256 hashes:

retrolab-0.3.11-py3-none-any.whl: 76d69c333713648ce106f68570dad0cea7b5facaf2982395987d912e6d2b4b41

retrolab-0.3.11.tar.gz: a8f45ec244f8d7ff024d9799bd5c6d785a5ed8e14d1fd2e2cf15e5a48f1400c4

retrolab-application-0.3.11.tgz: 633b23cd2fbd5d66a58135f6f9318b7e6472196e9dbbdda68d06ff972803daf1

retrolab-application-extension-0.3.11.tgz: 2197f9f043bae137b1e543d04c7b9780e28657b21e3e926d694cf61487db3e3a

retrolab-console-extension-0.3.11.tgz: 47ff25da1e191378d4bd8ef46882bea9143a73e00fb5701548fcad41ff52149c

retrolab-docmanager-extension-0.3.11.tgz: bd6b63bf9dfeffe90cfc1bf7cc42c1e42cf22a2863df2f90f013e6e0d3d48d4d

retrolab-help-extension-0.3.11.tgz: c9ed5ebba43bbe6d705b1484c536b986307a37f20891f83ad877f85335deed73

retrolab-lab-extension-0.3.11.tgz: 8b48e7d035e9d19bffec59edb80e6ce4a08f412f523a0f561e361f8b9801e7f6

retrolab-notebook-extension-0.3.11.tgz: 8345bbc30b9abaf5520a9c7ef3e40056e01d36d9d179b78e963ac3e643aaeded

retrolab-terminal-extension-0.3.11.tgz: e82b8a8a8f2a62074ba85e2f36bc972e1fb158136758ec780409fd9e450c9a2f

retrolab-tree-extension-0.3.11.tgz: 54a7c4fce6cc3665a4e81a46b0b5ece27f6a6b3f736c13eadd9e38dba77a65a2

retrolab-ui-components-0.3.11.tgz: ce615fabb585ba428e12c16154dc0d2dc4188696b98c61308ce90fd001ae5f27
2021-10-14 16:19:41 +00:00
.github/workflows Clean up bump version script 2021-09-11 19:32:59 +02:00
app Publish 0.3.11 2021-10-14 16:19:41 +00:00
binder Use Python 3.9 on Binder 2021-09-21 22:39:06 +02:00
buildutils Publish 0.3.11 2021-10-14 16:19:41 +00:00
jupyter-config Rename to RetroLab (#121) 2021-05-19 15:13:00 +02:00
packages Publish 0.3.11 2021-10-14 16:19:41 +00:00
retrolab Publish 0.3.11 2021-10-14 16:19:41 +00:00
.bumpversion.cfg Publish 0.3.11 2021-10-14 16:19:41 +00:00
.eslintignore Initial commit 2020-12-04 15:15:41 +02:00
.eslintrc.js Cleanup 2021-07-05 20:01:15 +02:00
.gitignore Add the console favicon 2021-08-30 11:36:29 +02:00
.prettierignore Update to the 3.1.0-alpha.x upstream packages (#127) 2021-05-20 17:19:55 +02:00
.prettierrc Initial commit 2020-12-04 15:15:41 +02:00
CHANGELOG.md Automated Changelog Entry for 0.3.11 on main 2021-10-14 15:39:20 +00:00
CONTRIBUTING.md Update to jupyter-packaging 0.10 (#179) 2021-07-14 15:11:46 +02:00
jupyter_config.json Update to the 3.1.0-alpha.x upstream packages (#127) 2021-05-20 17:19:55 +02:00
lerna.json Add script to do a patch release 2021-01-19 09:56:25 +01:00
LICENSE Follow-up to the move to the jupyterlab organization (#137) 2021-05-26 21:35:22 +02:00
lint-staged.config.js Initial commit 2020-12-04 15:15:41 +02:00
logo.png Update logo 2021-05-26 10:17:26 +02:00
logo.svg Follow-up to the move to the jupyterlab organization (#137) 2021-05-26 21:35:22 +02:00
MANIFEST.in Improve the bump version script (#185) 2021-07-22 17:19:59 +02:00
package.json Update to JupyterLab 3.2 final 2021-10-14 13:27:22 +02:00
pyproject.toml Update to JupyterLab 3.2 final 2021-10-14 13:27:22 +02:00
README.md Update link to the stable Binder 2021-09-23 18:27:43 +02:00
RELEASE.md Update RELEASE.md to mention the Jupyter Releaser (#223) 2021-09-10 18:08:03 +02:00
setup.cfg Update to JupyterLab 3.2 final 2021-10-14 13:27:22 +02:00
setup.py Update to jupyter-packaging 0.10 (#179) 2021-07-14 15:11:46 +02:00
tsconfig.eslint.json Add script to do a patch release 2021-01-19 09:56:25 +01:00
tsconfig.test.json Initial commit 2020-12-04 15:15:41 +02:00
tsconfigbase.json Initial commit 2020-12-04 15:15:41 +02:00
tsconfigbase.test.json Initial commit 2020-12-04 15:15:41 +02:00
yarn.lock Update to JupyterLab 3.2 final 2021-10-14 13:27:22 +02:00

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

Try it online in your browser

It is possible to try RetroLab on Binder without installing anything using the following link:

Try it on Binder

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.