https://github.com/s-valent/jupyterlab-app

An app for macOS that launches and displays jupyter lab. No need to keep terminal open for that anymore!
https://github.com/s-valent/jupyterlab-app

app ipynb ipynb-notebook jupyter jupyter-lab jupyter-notebook jupyterlab lab mac macos osx

Last synced: about 2 months ago
JSON representation

An app for macOS that launches and displays jupyter lab. No need to keep terminal open for that anymore!

• Host: GitHub
• URL: https://github.com/s-valent/jupyterlab-app
• Owner: s-valent
• License: mit
• Archived: true
• Created: 2020-04-02T16:34:16.000Z (over 4 years ago)
• Default Branch: master
• Last Pushed: 2022-07-06T14:10:04.000Z (over 2 years ago)
• Last Synced: 2024-09-24T22:03:30.871Z (about 2 months ago)
• Topics: app, ipynb, ipynb-notebook, jupyter, jupyter-lab, jupyter-notebook, jupyterlab, lab, mac, macos, osx
• Language: Swift
• Homepage:
• Size: 1.54 MB
• Stars: 3
• Watchers: 0
• Forks: 1
• Open Issues: 0
• Metadata Files:
  • Readme: readme.md
  • License: license.md

Awesome Lists containing this project

README

        
# 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](https://github.com/jupyterlab/jupyterlab-desktop). I switched to Jupyter Notebooks, so if you are interested, you can find [a new project here](https://github.com/python-mac/jupyter-app).

---

An app that launches and displays jupyter-lab.

![screenshot](screenshot.png)

### Overview

~~Unfortunately, [the official desktop app](https://github.com/jupyterlab/jupyterlab-desktop) 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](https://github.com/nanoant/jupterlab-macos-runner), 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](https://github.com/nanoant/jupterlab-macos-runner) (similar project)

which is taken from [here](https://jupyter.org) and slightly redesigned.

- [font JetBrains Mono](https://www.jetbrains.com/lp/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