{"id":13588265,"url":"https://github.com/musikinformatik/SuperDirt","last_synced_at":"2025-04-08T03:33:03.266Z","repository":{"id":37947571,"uuid":"45493054","full_name":"musikinformatik/SuperDirt","owner":"musikinformatik","description":"Tidal Audio Engine","archived":false,"fork":false,"pushed_at":"2025-03-31T21:17:48.000Z","size":8074,"stargazers_count":558,"open_issues_count":48,"forks_count":79,"subscribers_count":42,"default_branch":"develop","last_synced_at":"2025-04-06T23:43:22.531Z","etag":null,"topics":["haskell","live-coding","signal-processing","sound-files","supercollider"],"latest_commit_sha":null,"homepage":"","language":"SuperCollider","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"gpl-2.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/musikinformatik.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2015-11-03T20:18:44.000Z","updated_at":"2025-04-05T04:05:06.000Z","dependencies_parsed_at":"2024-01-13T10:12:47.853Z","dependency_job_id":"6e11a727-bf9d-40b2-b75d-69493ea6241e","html_url":"https://github.com/musikinformatik/SuperDirt","commit_stats":null,"previous_names":[],"tags_count":14,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/musikinformatik%2FSuperDirt","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/musikinformatik%2FSuperDirt/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/musikinformatik%2FSuperDirt/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/musikinformatik%2FSuperDirt/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/musikinformatik","download_url":"https://codeload.github.com/musikinformatik/SuperDirt/tar.gz/refs/heads/develop","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":247772520,"owners_count":20993588,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["haskell","live-coding","signal-processing","sound-files","supercollider"],"created_at":"2024-08-01T15:06:36.378Z","updated_at":"2025-04-08T03:33:02.992Z","avatar_url":"https://github.com/musikinformatik.png","language":"SuperCollider","funding_links":[],"categories":["SuperCollider","Music \u0026 Audiophile"],"sub_categories":[],"readme":"# SuperDirt\n\nSuperCollider implementation of the Dirt sampler, originally designed\nfor the [TidalCycles](https://github.com/tidalcycles/tidal)\nenvironment. SuperDirt is a general purpose framework for playing\nsamples and synths, controllable over the Open Sound Control protocol,\nand locally from the SuperCollider language. SuperDirt is also\nused by [Sardine](https://sardine.raphaelforment.fr), a live coding\nenvironment for Python 3.10+. \n\n(C) 2015-2023 Julian Rohrhuber, Alex McLean and contributors\n\nSuperDirt is free software: you can redistribute it and/or modify it\nunder the terms of the GNU General Public License as published by the\nFree Software Foundation, either version 2 of the License, or (at your\noption) any later version.\n\nThis program is distributed in the hope that it will be useful, but\nWITHOUT ANY WARRANTY; without even the implied warranty of\nMERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU\nGeneral Public License for more details.\n\nYou should have received a copy of the GNU General Public License\nalong with this library.  If not, see \u003chttp://www.gnu.org/licenses/\u003e.\n\n## Requirements\n\n* SuperCollider \u003e= v3.7 (3.6 possible, but see below): https://github.com/supercollider/supercollider\n* The Vowel Quark: https://github.com/supercollider-quarks/Vowel\n* optional, but recommended (many effect UGens need it): sc3-plugins: https://github.com/supercollider/sc3-plugins/\n* For proper usage you need https://github.com/tidalcycles/Tidal\n\n## Installation from SuperCollider\n```\ninclude(\"SuperDirt\");\n```\nNote: this also automatically installs the DirtSamples quark, which contains a large collection of sound files. It downloads them as a zip file. Sometimes, git fails to unpack these samples and they don't get listed. In this case, you have to unpack them \"manually\".\n\n## Simple Setup\n\n`SuperDirt.start`\n\nYou can pass `port`, `outBusses`, `senderAddr` as arguments.\n\n## Setup with options\n\nFor an example startup file, see the file `superdirt_startup.scd`. you can `load(\u003cpath\u003e)` this from the SuperCollider startup file.\n\n## Automatic startup\nIf you want SuperDirt to start automatically, you can load it from the startup file. To do this, open the sc startup file (```File\u003eOpen startup file```) and add: ```load(\"... path to your tidal startup file ...\")```. This path you can get by dropping the file onto the text editor.\n\n\n## Options on startup\n- `numChannels` can be set to anything your soundcard supports\n- for server options, see `ServerOptions` helpfile: http://doc.sccode.org/Classes/ServerOptions.html\n\n## Options on-the-fly\n- add sound files. `~dirt.loadSoundFiles(\"path/to/my/samples/*\")` You can drag and drop folders into the editor and add a wildcard (*) after˘ it.\n- you can pass the udp port on which superdirt is listenting and the output channel offsets: `~dirt.start(port, channels)`\n- new orbits can be created on the fly (e.g. `~dirt.makeBusses([0, 0, 0])`).\n- add or edit SynthDef files to add your own synthesis methods to be called from tidal: https://github.com/musikinformatik/SuperDirt/blob/master/synths/default-synths.scd\n- you can live rewrite the core synths (but take care not to break them ...): https://github.com/musikinformatik/SuperDirt/blob/master/synths/core-synths.scd\n\n## Trouble Shooting\n If you run into unspecific troubles and want to quickly reset everything, you can run the following: `SuperDirt.resetEverything`\nYou can minimize downtime if you have a startup file that automatically starts SuperDirt (see Automatic startup, above).\n\n\n## Using SuperDirt with SuperCollider 3.6\nIt is in principle possible to use SuperCollider 3.6, but startup will be much slower by comparison. It is **not** recommended if you expect it to run smoothly.\n\nFor reference, we leave here the instructions if you want to try anyway:\n\nThe install works differently: don't do `include(\"SuperDirt\")`, but instead download the three quarks to the SuperCollider `Extensions` folder:\n- https://github.com/musikinformatik/SuperDirt\n- https://github.com/tidalcycles/Dirt-Samples\n- https://github.com/supercollider-quarks/Vowel\n\nNote that for automatically loading the sound files, the folder `Dirt-Samples` should have this name (not Dirt-Samples-master e.g.) and should be next to the SuperDirt folder.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmusikinformatik%2FSuperDirt","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fmusikinformatik%2FSuperDirt","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmusikinformatik%2FSuperDirt/lists"}