Overtone on the Edge!

If you'd like to be running the latest development version of Overtone, here's what you need to do.

Using a specific Git SHA directly from Github

In your deps.edn, instead of a Maven package version (:mvn/version), you can specify a git repository + commit sha.

;; deps.edn
{:deps
  {overtone/overtone {:git/url "https://github.com/overtone/overtone.git"
                      :git/sha "699ed79a335d24ca48d9aa19b8ee5aff21dc5abe"}}} ;; latest commit at time of writing

Have a look at the repository to find the SHA of the latest commit. Not that you have to use the full SHA, abbreviated versions that work with git commands don't work with deps.edn.

This way you can also easily run other branches (for instance to test a PR before it gets merged), or run older versions (for instance to find out exactly in which commit something changed or broke).

Running off a local repository

If you are making changes to Overtone itself, or just want a local copy to be able to jump around in, then start by making a local clone of the repository

git clone git://github.com/overtone/overtone.git
cd overtone

From here you can start a REPL with clojure or clj, or let your editor do it for you (for example in Emacs with cider-jack-in)

You can also use deps.edn to tell Clojure to use the local clone directly, using :local/root

;; deps.edn
{:deps {overtone/overtone {:local/root "../overtone"}}} ;; relative or absolute path to repo checkout

This way you can easily make tweaks to overtone, while keeping your own project code separate.

For a better experience try Overtone in emacs or Overtone in vim.