This repository has been archived on 2024-10-22. You can view files and clone it, but cannot push or open issues or pull requests.
spacemacs/layers/+music/tidalcycles/README.org
2021-07-12 07:32:24 -07:00

60 lines
1.9 KiB
Org Mode

#+TITLE: TidalCycles layer
#+TAGS: layer|music
[[file:img/tidalcycles.jpg]]
* Table of Contents :TOC_5_gh:noexport:
- [[#description][Description]]
- [[#features][Features:]]
- [[#install][Install]]
- [[#usage][Usage]]
- [[#key-bindings][Key bindings]]
* Description
This layer adds a major mode to control [[https://tidalcycles.org][TidalCycles]], a programming language
for live coding.
** Features:
- =tidal-mode= to interact with TidalCycles
- Spacemacs friendly key bindings
* Install
To use this configuration layer, add it to your =~/.spacemacs=. You will need to
add =tidalcycles= to the existing =dotspacemacs-configuration-layers= list in
this file.
* Usage
After installing TidalCycles and starting SuperDirt as described [[https://tidalcycles.org/docs/][in the docs]],
open a file with the =.tidal= extension and start TidalCycles with =SPC m t s=.
You can evaluate a piece of code with =SPC m RET= or the original key binding
=C-RET=.
* Key bindings
| Key binding | Description |
|-------------+-----------------------|
| ~SPC m RET~ | Run block near cursor |
| ~SPC m t s~ | Start TidalCycles |
| ~SPC m t q~ | Quit TidalCycles |
| ~SPC m r 1~ | Run orbit d1 |
| ~SPC m r 2~ | Run orbit d2 |
| ~SPC m r 3~ | Run orbit d3 |
| ~SPC m r 4~ | Run orbit d4 |
| ~SPC m r 5~ | Run orbit d5 |
| ~SPC m r 6~ | Run orbit d6 |
| ~SPC m r 7~ | Run orbit d7 |
| ~SPC m r 8~ | Run orbit d8 |
| ~SPC m r 9~ | Run orbit d9 |
| ~SPC m s 1~ | Stop orbit d1 |
| ~SPC m s 2~ | Stop orbit d2 |
| ~SPC m s 3~ | Stop orbit d3 |
| ~SPC m s 4~ | Stop orbit d4 |
| ~SPC m s 5~ | Stop orbit d5 |
| ~SPC m s 6~ | Stop orbit d6 |
| ~SPC m s 7~ | Stop orbit d7 |
| ~SPC m s 8~ | Stop orbit d8 |
| ~SPC m s 9~ | Stop orbit d9 |
| ~SPC m m u~ | Unmute all orbits |
| ~SPC m o u~ | Unsolo all orbits |