Installation

Prerequisites

Before you start make sure you have:

Installing via Package Control

The recommended way to install ENSIME Sublime is via Package Control (which is a must-have tool anyway):

  1. install Package Control;

  2. open the Command Palette in Sublime Text (Ctrl+Shift_P);

  3. type/select “Package Control: Install Package” and press Enter;

  4. After a few seconds a second command palette will appear, asking you which package you’d like to install. Type/select “Ensime” and press Enter.

Sublime Text and ENSIME Sublime should now be correctly configured. The next step is to install ENSIME sbt.

Launching ENSIME

Once you have a .ensime file for your project, start an ENSIME session from within Sublime Text as follows:

  1. Open the root folder of your project (the one containing the .ensime file) in Sublime Text. If you are already viewing a project file in Sublime, you can open the root folder by selecting Project Menu / Add Folder to Project… and selecting the project root directory.

  2. [Optional] You may find it helpful to open the console view to see the output and logs upon starting Ensime. You do this in the Sublime View menu and selecting Show Console.

  3. Choose “Ensime: Startup” from the Sublime Text command palette (Tools Menu / Command Palette…), or simply by selcting *Tools Menu / Ensime / Startup *

  4. The first time you start ENSIME it will take a few minutes to index the files and get set up (it’ll be much faster on subsequent runs).

    How do you tell when it’s initialised? Open one of your scala source files and break the code by simply adding a whitespace to a function or class name and then save the file, you will then see the error highlighted within Sublime Text.

    Open a Scala file and verify that ENSIME is working.

Trouble Getting It Working?

See the troubleshooting page and chat to us on Gitter!



[edit]