This package allows state-history interaction with the TidalCycles live-coding language.
Before You Use
- Make sure you already have the TidalCycles package installed. 3.16.48 is known to work. Currently SHARP does not work with other live-coding languages.
Directions for Installation
Download the package on Pulsar. This can be done installing the package through the packages menu on the Pulsar application or running
pulsar -p install tidal-sharp in your terminal.
- Clone the repo
- (Most likey): need to run
npm installin the project folder.
- In the project folder, run
apm link -d. This adds a symlink to this package in the
~/.atom/dev/packagesdirectory. For Pulsar, this is
ppm link -d. If Pulsar's
ppmcommand isn't working, you can manulaly create a symlink. On a mac, this is:
ln -s <cloned_repo_path> ~/Users/<user>/.pulsar/dev/packages/sharp. NOTE: You can also just clone the repo to this directory and skip the sym-link altogether, if you want.
- In the command line, run
atom -dto use the packages in the dev directory. You should see 'sharp' in the Packages menu now. Alternatively, in the Atom/Pulsar menu, click
view > developer > open in dev mode
- Run SHARP by either using the Packages menu and choosing
SHARP > Activate SHARPor by using the keyboard shortcut: ctrl+alt+x
- Run one block of code with the TidalCycles keyboard shortcut ctrl+enter (or cmd+enter). Note that SHARP will not run alongside TidalCycles if you choose the TidalCycles Eval commands from the Packages drop-down. You must use the keyboard shortcuts if you want both to run together.
- Alternatively, run all blocks of code with the TidalCycles keyboard shortcut ctrl+alt+shift+enter (or cmd+alt+shift+enter).
- You can choose whether or not to allow duplicate code entries in the state-history tree SHARP creates for you by going to the Packages drop-down menu and choosing
SHARP > Allow/Disallow unique nodes in graphsor by using the keyboard shortcut ctrl+alt+u.
- After making changes, you can close the package with
Packages > SHARP > Quit SHARP(the keyboard shortcut for this is ctrl + opt + cmd + q). You will be asked to save your history into a file if you do this with an unsaved SHARP history. You can also save to a file manually with
Packages > SHARP > Dump History to File...(or ctrl + opt + cmd + s).
Interacting with SHARP
- Running a Tidal pattern will create a version history for that pattern. If it is the first time running that pattern, a graph with one history node will appear. Otherwise, a node will be added to the graph as a child of the currently selected node.
- The node that is currently running in Tidal is indicated by a pulsing effect.
- Click on a node to select it and replace the current pattern code with the history state that the node you just selected is holding. The selected node is indicated by a yellow circular outline.
- Tag a node you want to 'bookmark' by right-clicking (or ctrl+clicking) the node and then selecting
Tag nodeon the resulting drop-down menu.
- Alternatively, cmd+click or alt+click the node to cycle through the color options for tagging.
- Messing with line highlighting produces bugs
- Scrolling on history boxes glitches out