alexarchambault / sbt-notebook   0.1.1


A sbt plugin that adds scala-notebook capabilities to sbt projects

Scala versions: 2.10
sbt plugins: 0.13

sbt-notebook plugin

A sbt plugin that adds scala-notebook capabilities to sbt projects.

This plugin mainly adds a notebook task to your sbt project, that launches a scala-notebook server with your project build products and its dependencies on the classpath. You can think of it as a graphical in-browser console.

Build Status Join the chat at


  • Add the following line to project/plugins.sbt:
addSbtPlugin("com.github.alexarchambault" %% "sbt-notebook" % "0.1.1")

Alternatively, you can also add it to all your projects at once by adding it to ~/.sbt/0.13/plugins/build.sbt.

  • That's it! Type notebook at the sbt prompt, and a browser window should open at the right address. This address will also be printed in the console.

Known issues

  • Requires sbt >= 0.13.5. Add sbt.version=0.13.5 (or 0.13.7) to project/ of the projects you want the notebook command to be available for.

  • Does not work with scala versions other than 2.10.

  • scala-notebook relies on akka 2.1.4. It seems not to work with akka >= 2.2.0. See this and this project.

  • Typing a key in the console while the notebook command is running does not fully stop the scala-notebook server as it should. It seems to be stuck like described in these SO questions, as the main function of the server has already exited. Some tuning of the config files or upgrading the akka version may solve this issue. As a temporary workaround, one can disable the forking of the server, by adding this line to build.sbt: fork in Notebook := false, but the other options (hostname, port, notebooks dir, notebooks project name will then be ignored).

  • Connection to the server is not encrypted. By default, this may not be a problem, as only one session to the server can be opened. If one disables this (adding the line notebookSecure := false to build.sbt) and opens a notebook on another machine, then this may be an issue.

Copyright (c) 2014 Alexandre Archambault. See LICENSE file for more details.

Released under Apache 2.0 license.