Skip to content

Latest commit

 

History

History
23 lines (16 loc) · 2.27 KB

README.md

File metadata and controls

23 lines (16 loc) · 2.27 KB
Raw

awesome-synthdefs

This is a repository of SynthDefs for the SuperCollider language, started with the hope of 'synthesizing' (forgive me) some community knowledge on how to write SynthDefs and make some good sounds. I made this with an emphasis on documentation and providing examples, with the hope of keeping contributions as usable and modular as possible.

I've had a think of how to structure this and the best format I've thought of so far is to do the following:

  1. Fork this repo to make changes
  2. Inside your fork, make a folder with your name
  3. Inside that folder, put a readme with any info/links about the SynthDefs you've contributed, and any other information you want to include.
  4. Make a subfolder for SynthDefs and a subfolder for Examples
  5. Put your SynthDefs in the SynthDefs folder, preferably commented with some information about what they are for, and what variables do. Try and package the SynthDefs as executable .scd files so that they can be pulled into other projects easily, or can be referenced easily within your Examples.
  6. If you can, put some examples of how you use the SynthDefs in the example folder - to give an idea of how to use them, and any sweet spots in the settings that would otherwise be hard to discover.
  7. Make whatever other folders you think you need to functionally package the SynthDef (samples/tunings/data/etc)
  8. Add your username to the list of contributors in contributors.md
  9. Open a pull request and get your SynthDefs in here. The more the merrier.

I've made an Example_user folder that demonstrates this with one SynthDef and examples.

If you don't have a GitHub account or aren't familiar with the process but have something to contribute, find me on @theseanco on social media, or e-mail theseancotterill atsign live period com and i'll give you a hand!

This format is pretty flexible, so don't feel bound to it. Equally don't feel bound to just adding SynthDefs, add bits of synthesis, cool functions, one-liners etc etc. Really the goal is to build a library of practices that SuperCollider folks are using, with the hope that we can learn from each other, the most important thing is to do some documenting so others can get the most out of your contributions!

Unless stated by individual authors, materials in this repo are CC0