Skip to content


Switch branches/tags

Name already in use

A tag already exists with the provided branch name. Many Git commands accept both tag and branch names, so creating this branch may cause unexpected behavior. Are you sure you want to create this branch?

Latest commit


Git stats


Failed to load latest commit information.
Latest commit message
Commit time


gif demo

Your friendly hydra library. A wrapper around hydra to allow for quicker, enhanded visual coding by way of stateful handlers and generators.

See it in action on Twitch!

Are There Docs?

Yes, but they are a work in progress - I will work on these once the library itself is more complete (I promise 🙏).

How Can I Use This?

Ok, so you've cloned this repo, or found it on npm. Congrats!! Then you had some serious issues trying to get it to work... my bad! These are the early days, things will only get better.

That being said, it is possible to use this right now. To do so, follow these steps:

  1. install atom
  2. install tidalcycles and hydra on atom
  3. navigate to the hydra-atom package on your machine (Linux: ~/.atom/packages/atom-hydra)
  4. remove this package and clone my fork
    • my fork adds 2 things:
      1. ability to eval whole file ctrl-alt-enter, necessary for importing packages
      2. installs the latest version of HydraFriend
  5. npm install in the forked repo
  6. open atom and go at it!


Let's create a super trivial setup that will do invert the colors of an octagon every 5 times bd is heard. This example assumes you have a SuperCollider session that relays messages to some given port (we are using port 3333). For an example file to use at startup, see here.


// import library (now on npm yeah!)
const { Handler, HydraFriend, initialize, Shape } = require("hydrafriend");

// Only call initialize once
// see

// define a new octagon shape
const octagon = new Shape()sides(8);

// handle bd by inverting every 5
const handle_bd = new Handler("bd", () => octagon.invert());

// register all our handlers
const hf = new HydraFriend();


d1 $ s "bd sn"


No releases published


No packages published