https://github.com/nanoant/jupterlab-macos-runner

Standalone app running jupyter-lab in the background, showing JupyterLab UI in WebKit window
https://github.com/nanoant/jupterlab-macos-runner

jupyter jupyter-lab jupyterlab macos macosx python webapp

Last synced: about 1 month ago
JSON representation

Standalone app running jupyter-lab in the background, showing JupyterLab UI in WebKit window

• Host: GitHub
• URL: https://github.com/nanoant/jupterlab-macos-runner
• Owner: nanoant
• License: mit
• Created: 2020-03-19T21:40:25.000Z (almost 5 years ago)
• Default Branch: master
• Last Pushed: 2022-01-06T21:57:43.000Z (about 3 years ago)
• Last Synced: 2024-11-10T13:47:41.753Z (3 months ago)
• Topics: jupyter, jupyter-lab, jupyterlab, macos, macosx, python, webapp
• Language: Objective-C
• Homepage:
• Size: 1.85 MB
• Stars: 4
• Watchers: 0
• Forks: 0
• Open Issues: 2
• Metadata Files:
  • Readme: README.md
  • License: LICENSE

Awesome Lists containing this project

README

        
JupyterLab macOS Runner

=======================

[lab]: https://jupyterlab.readthedocs.io/en/stable/

This is a standalone application that runs `jupyter-lab` command in the background and opens a WebKit window with [*JupyterLab*][lab] interface. When the application is closed, background `jupyter-lab` process is terminated with `SIGTERM`.

It was created to make JupyterLab work more convenient on *macOS*, without the need to fiddle with the command line and making it distinctive from the regular browser.

NOTE: At the moment it does not detect if there are some unsaved notebooks upon application quit.



### Configuration

Accessible via `defaults read/write com.nanoant.webapp.JupyterLab`

This application has no dedicated settings UI. All settings needs to be adjusted using `defaults`. Following settings are exposed, showing default values:

~~~bash

defaults write com.nanoant.webapp.JupyterLab CommandPath  ~/miniconda3/bin/jupyter-lab

defaults write com.nanoant.webapp.JupyterLab NotebookPath ~/Documents/Notebooks

defaults write com.nanoant.webapp.JupyterLab Host "127.0.0.1" # local host address

defaults write com.nanoant.webapp.JupyterLab Port -int 0      # next available port

defaults write com.nanoant.webapp.JupyterLab Token "deadbeefb00b"

~~~

These settings are translated into following `jupyter-lab` invocation:

~~~bash

> $CommandPath \

    --no-browser \

    --ip=$Host \

    --port=$Port \

    --notebook-dir=$NotebookPath \

    --NotebookApp.token=$Token

~~~

### Build

Use CMake with Xcode or Command Line Tools installed to build it.

### License

Licensed under [MIT License](LICENSE).

### Disclaimers

Icon borrowed and revamped from [JupterLab][lab] project.