https://github.com/tidalcycles/tidal-bootstrap
Quick installation of TidalCycles programming environment
https://github.com/tidalcycles/tidal-bootstrap
Last synced: 2 months ago
JSON representation
Quick installation of TidalCycles programming environment
- Host: GitHub
- URL: https://github.com/tidalcycles/tidal-bootstrap
- Owner: tidalcycles
- License: gpl-3.0
- Created: 2016-11-30T15:04:03.000Z (over 8 years ago)
- Default Branch: master
- Last Pushed: 2024-06-25T15:21:29.000Z (about 1 year ago)
- Last Synced: 2025-04-20T18:22:31.506Z (2 months ago)
- Language: Shell
- Homepage: https://tidalcycles.github.io/tidal-bootstrap/
- Size: 97.7 KB
- Stars: 50
- Watchers: 5
- Forks: 11
- Open Issues: 7
-
Metadata Files:
- Readme: README.md
- License: LICENSE.txt
Awesome Lists containing this project
README
# tidal-bootstrap
This installation script is an "ad-hoc" solution. Effort is made to ensure it works, but it does not have robust error detection and hasn't been fully tested on all current macOS versions. If you have problems, please join us on the Tidal Cycles [Discord installation-help channel](https://discord.com/channels/779427371270275082/779487905822801930) or [Club Tidal forum](https://club.tidalcycles.org/c/installation/5) and we'll try to help. We'd be very happy to hear about successes too!
## Summary
### OS support
- Tested on Mac Intel: Big Sur, Monterey
- Install on M1 (Silicon) OSX Ventura has been validated
- Support for Linux has been removed, the script will exit.
#### Description
`tidal-bootstrap` is shell script which automates the installation steps for [TidalCycles](http://tidalcycles.org/) live coding environment under Mac OS X.
`tidal-bootstrap` installs the components covered in the TidalCycles [MacOS installation](https://tidalcycles.org/docs/getting-started/macos_install) guide.
The script checks if the following programs are installed on the system, and installs them if they are missing:
- Xcode command line tools (with git)
- [Haskell](https://www.haskell.org/) Language ([Ghcup](https://www.haskell.org/ghcup/))
- [cabal](https://www.haskell.org/cabal/): package system for Haskell and Tidalcycles
- The Tidal Pattern engine (Tidal Cycles itself), with the important BootTidal.hs file
- [Pulsar](https://pulsar-edit.dev/): Text editor
- [tidalcycles plugin](https://github.com/tidalcycles/atom-tidalcycles) for Pulsar
- [SuperCollider](https://supercollider.github.io/) for backend audio generation, and:
- [SuperDirt](https://github.com/musikinformatik/SuperDirt): sample library used by tidal
- [sc-3 plugins](https://github.com/supercollider/sc3-plugins): unit generator plugins
### Running tidal-bootstrap
For best results, first install the Apple Xcode command line tools.
```
/usr/bin/xcode-select --install
```
Then run this:
```
curl https://raw.githubusercontent.com/tidalcycles/tidal-bootstrap/master/tidal-bootstrap.command -sSf | sh
```
Note: if there are failures, the script can be run again. Correctly installed components will be skipped.
### sh profiles
macOS by default does not install a shell profile (.bashrc for bash, .zshrc for zsh). Haskell requires a profile file to be present. This script uses the "touch" command to create these if they are not there then adds a command that will add the ghcup path to your PATH, by running `~/.ghcup/env`