Skip to content
This repository was archived by the owner on Jul 6, 2022. It is now read-only.

Latest commit

 

History

History
53 lines (37 loc) · 2.55 KB

readme.md

File metadata and controls

53 lines (37 loc) · 2.55 KB

JupyterLab App for macOS

This repository is now archived

When you are reading this, this repository is probably already archived. It was a fun quick project, but I didn't use it for quite a while, and I will probably never update it. Also, the official repository is now alive and well, so go check it out. I switched to Jupyter Notebooks, so if you are interested, you can find a new project here.

An app that launches and displays jupyter-lab.

screenshot

Overview

Unfortunately, the official desktop app successfully died, so this is one of many apps that try to replace it.

This app can run jupyter-lab:

  • in a separate window like it's own app (because it is) and not in browser tab
  • without an opened terminal window (but if you like it, just use it as an c.LabApp.browser)

It is written on Swift and SwiftUI. It is my first project on Swift, sorry about bad coding style.

Why another similar app?

I thought it will be a good practice for me. Almost every app that I found didn't do what I wanted. The best one that I found is this one, but it's written on another language. I was trying to fix webview problem (see known bugs), but I had no luck. This app still uses different mechanics to run and stop jupyter-lab.

How to run?

Make sure you've already installed python and jupyter-lab and everything works fine.

Make sure you placed jupyter at /usr/local/bin/jupyter (jupyter-lab is not required). If you haven't already, it's just ln -s /path/to/your/jupyter /usr/local/bin/jupyter in terminal.

You will probably want to write this to you jupyter_notebook_config.py:

c.LabApp.browser = '/Applications/JupyterLab.app/Contents/MacOS/JupyterLab %s
c.NotebookApp.notebook_dir = "/your/homedir/"   # don't forget to change to your home directory

If everything is ready, just click the app icon. You also can run it from terminal as jupyter lab.

Disclaimers

  • icon is borrowed from here (similar project) which is taken from here and slightly redesigned.
  • font JetBrains Mono is used on a screenshot

Knows Bugs

  • if app stays inactive for a while (~3-4 min for me), webview doesn't respond immediately. (Please, help me! I have absolutely no idea how to fix it).
  • Terminal is not rendering properly