Adding and using your own custom samples in Tidal Cycles is relatively easy. You don't actually add samples, but instead add them into SuperCollider and the SuperDirt quark. To do this, you will need to customize your SuperDirt startup code.
When you open SuperCollider, instead of the normal
code, you will need to write a longer script that tells SuperDirt where
to find your samples. The startup script will look like this:
To run the above code, place the cursor anywhere inside that code block,
Command+Enter on MacOS) to evaluate the
The above code will boot the SuperCollider server, then start up
SuperDirt with some samples located at
/Users/myUserName/Dirt/samples. You can find a more complete startup file in the SuperDirt code repository.
If you are running Windows, you will need to escape the backslash characters in Windows paths:
If you have samples located in many folders, you can import them all:
In the above example, we have imported a folder at the path
/Users/myUserName/Dirt/samples. In order for SuperDirt to recognize the sound names that Tidal sends, the
/Users/myUserName/Dirt/samples folder will need to have sub-folders for each sound name, and each sound name folder will need to have sample files:
Given the folder structure above, you can now use the
field sounds in your Tidal patterns: