Package: sckernel
sckernelsckernel is a Jupyter Notebook kernel for SuperCollider's sclang.  sckernel
launches a post window to display output just as the SuperCollider IDE does
while the Notebook front end handles input.Syntax highlighting in the Notebook uses codemirror with a mode defined in
kernel.js.sckernel has been tested on both MacOS and Windows 10.RequirementsUsers need a working installation of SuperCollider and Jupyter Notebook.
There are several ways to install Jupyter Notebook as detailed atwww.jupyter.org/install.  The quickest way is by downloading Anaconda.sckernel requires Python 3.5 or higher.  Please be sure if you downloaded
the Notebook through Anaconda that it is for Python 3.5 or higher.InstallationStep 1: Download sckernelTo downloadsckernelfrom PyPI:pip install sckernelStep 2: Install the kernelspec for sckernelTo complete the installation, you must select a location for the sckernel
configuration files (called a kernelspec).  There are three options:To install locally to your user account, runpython -m sckernel.installThe above line is also equivalent topython -m sckernel.install --user.To install in the root directory or for an environment like Anaconda or
venv, runpython -m sckernel.install --sys-prefix.To install to another location (not recommended), runpython -m sckernel.install --prefix <your_prefix_path>sckernel's kernelspec will be installed in {PREFIX}/share/jupyter/kernels/.Step 3: Configure sckernel to find your Python and sclang binariessckernel works by launching two separate subprocesses: a post window implemented
in Python and sclang, the frontend interpreter for SuperCollider.  To launch
these processes properly, sckernel needs to know where to find those binaries.
To complete the installation, run the following with those paths:python -m sckernel.config --python /path/to/python --sclang /path/to/sclangYou may omit this step entirely.  By default, sckernel will attempt to search
through your PATH environment variable for the first instance ofpythonandsclangand attempt to run those.  Depending upon your personal configuration, you may be
able to rely successfully upon your PATH variable without this step.  Additionally,
you can chose to omit just one of the--pythonor--sclangflags if you would
like to provide a path to only one.  Most users with multiple installations of Python
should run this step to ensure that sckernel uses the correct instance of Python.The typical paths for sclang are as follows but may be different on your machine.OS X:"/Applications/SuperCollider/SuperCollider.app/Contents/Resources/sclang"Linux:"/usr/local/bin/sclang"Windows:"C:\Program Files\SuperCollider\sclang.exe"Using SuperCollider kernelWhen opening Jupyter notebook, select from theNewmenu SC_Kernel to create
a new SuperCollider notebook using sclang.For the console frontend, you can runjupyter console --kernel sckernel.Converting from Notebooks to SuperCollider files (.scd)The sckernel package also comes with a convenience script to translate
from Jupyter notebooks to .scd files (i.e., SuperCollider files).python -m sckernel.convertNotebookToScd /path/to/notebook /path/to/destinationSome light formatting is done to make the .scd files readable in a similar way
to Jupyter Notebooks.Version Log0.3.0Created a configuration file for sckernel to read paths to python and sclang
to support different installationsReorganized sclangSub.pyUpdated documentation to reflect the need for running sckernel.config0.2.0Eliminated window flicker on MacOSAdded syntax highlighting by implementing CodeMirror0.1.0First version of sckernel