README.md

Jupyter Native

Run Jupyter Lab and Jupyter Notebook natively and seamlessly!

Installation

1. Install dependencies

npm install nativefier
brew install toilet

2. Create a Jupyter electron app

Note that naming matters here, since we later use AppleScript to open the application.

nativefier --name "Jupyter Lab" "http://localhost:8888/"
nativefier --name "Jupyter Notebook" "http://localhost:8888/"

This will create native applications called "Jupyter Lab" and "Jupyter Notebook".

3. Add this repo's script to your .bash_profile or .zshrc

git clone https://github.com/stevenschmatz/jupyter-native
cd jupyter-native

# OPTIONAL: Use this if you use a .bash_profile (default)
if [ -f ~/.bash_profile ]; then cat jupyter-native.sh >> ~/.bash_profile; fi

# OPTIONAL: Use this if you use a .zshrc
if [ -f ~/.zshrc ]; then cat jupyter-native.sh >> ~/.zshrc; fi

4. Run lab or notebook in your terminal!

But why?

1. Years of using macOS and web browsers has drilled the tab-switching shortcuts ⌘⇧[ and ⌘⇧] completely drilled into my mind. Unfortunately, this is incompatible with Jupyter Lab.

These can be solved by installing this repo, navigating to the advanced settings editor (⌘,) and adding the following custom shortcut override to Jupyter Lab:

{
    "application:activate-next-tab": {
        "command": "application:activate-next-tab",
        "keys": [
            "Accel Shift ]"
        ],
        "selector": "body"
    },

    "application:activate-previous-tab": {
      "command": "application:activate-previous-tab",
      "keys": [
        "Accel Shift ["
      ],
      "selector": "body"
    }
}

2. Using nativefier by itself provides a subpar experience, because copying the token from the URL and closing the original web window can still be annoying.