# Setting Up an Environment

How to set up an environment to get started with soundworks.

# Mac OSX

# Install Build Tools

For some applications you will need tools to compile code, etc.

  1. Open a Terminal (in Applications/Utilities/Terminal.app) and type:
xcode-select --install

and press Enter

  1. Click "Install" in the pop-up window and wait (this can be a bit long)...
  2. Done!

# Install Node.js

  1. Open https://nodejs.org/en/ in your favorite browser (which shall not be Safari).
  2. Download the LTS (Long Term Support) version.
  3. Follow the instructions...
  4. When done, open a Terminal (cf. Applications/Utilities/Terminal.app) and type:
node -v

Press "Return" and you should see:

v12.16.1

(...or whatever Node.js version you just installed)

  1. Done!

Tip

To deal with several versions of Node.js in a easy way, you can install the n package globally on your machine, cf. https://www.npmjs.com/package/n (opens new window).

npm install -g n

Check package documentation to learn how to avoid using sudo

# Install a Text Editor

Pick a text editor of your choice, popular text editor nowadays seems to be

# Sublime Text 3 - Advanced Configuration

If you just want to run an application, you can stop here.

The following are just the author preferences, do whatever suits best for you.

# Package Control

Package control allows to install new packages and extends sublime text, follow instruction here (opens new window).

# EcmaScript Syntax

It's nice to install a new package to support new JavaScript language features:

  1. In Sublime type: cmd + shift + p
  2. Type "Install" in the dialog box, select "Package Control: Install Package"
  3. Search for the "Ecmascript Syntax" package and install it

# Sublime Settings

Go to Preferences > Settings, paste the following in the Preferences.sublime-settings - User file and save (cmd + s):

{
  "caret_style": "blink",
  "color_scheme": "Packages/Color Scheme - Default/Monokai.sublime-color-scheme",
  "default_line_ending": "unix",
  "ensure_newline_at_eof_on_save": true,
  "font_size": 10,
  "highlight_line": true,
  "ignored_packages":
  [
    "Markdown",
    "Vintage"
  ],
  "index_files": false,
  "rulers":
  [
    80
  ],
  "show_encoding": true,
  "show_full_path": true,
  "show_line_endings": true,
  "tab_size": 2,
  "translate_tabs_to_spaces": true,
  "tree_animation_enabled": false,
  "trim_trailing_white_space_on_save": true,
  "word_wrap": true
}
{Sound Music Movement} Interaction Team - STMS-LAB