Skip to content

A library of tools for hybrid drums (or other instruments), with onset detection, timbre analysis, basic algorithmic composition techniques, midi and osc trigger outputs, and more

License

Notifications You must be signed in to change notification settings

tmhglnd/drumcode

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

85 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

./drum.code

A library of tools for hybrid drums (or instruments), with onset detection, timbre analysis, midi and osc trigger outputs, and more

⭐️ watch and star this repo to keep up-to-date with the latest results of my research

📟 About

Drumcode (stylized as ./drum.code) is a live coding performance for human and computer. During the performance the computer acts as a co-performer playing itself by making changes in the code while listening and reacting to patterns played on the drums. On the other side the human will react to the sounds made by the computer resulting in a dialogue between the analog and digital worlds of both performers. The code is generated in real-time, based on previous programmed live coding performances and pre-coded snippets. Decisions are made via machine learning techniques trained on rhythmical patterns and tuned probabilities.

This library consists of tools, utilities, practices and research that I am currently working on in order to create the live performance. The project has recently been granted funding by the Creative Industries Fund in the Netherlands. Within the scope of this fund it is my goal to not only create these tools for myself, but also give workshops to drummers (and other musicians) to learn about creative coding and creating a hybrid instrument from their acoustic drums. This project is a continuation of my research in algorithmic and electronic music composition and connects in various ways with my other projects such as the Mercury live coding environment, the Mercury Playground and the Total Serialism library.

./drum.code live performance. Photo by Paulus

🚀 Install

This library runs in PureData (0.55.0+) or PlugData (v0.9.2+). If you're a first time user I recommend you install PlugData first, after that do:

  • Download drumcode, Unzip folder and move to /Documents/plugdata/externals, rename the folder to drumcode.

OR (for advanced git users:)

  • $ cd ~/Documents/plugdata/externals, $ git clone https://github.com/tmhglnd/drumcode.git

Dependencies

The drumcode library uses the following dependencies, which you will have to download and install separately before starting to use drumcode.

  • Fluid Corpus Manipulation
    • Download the Pure Data Binaries
    • Unpack the .dmg .zip or .tar.gz (depending on your OS)
    • Place the FluidCorpusManipulation folder in /Documents/plugdata/externals
  • Cyclone (PureData only! included in PlugData by default)
    • When using PureData, install via Help > Find Externals
  • ELSE (PureData only! included in PlugData by default)
    • When using PureData, install via Help > Find Externals

Usage

  1. Open PlugData and start a new patch
  2. Place the following object in the patch: [declare -path drumcode/pd]
  3. Create an object to check if it is working. Objects are typed as [dc.objectNameHere]

Open the drumcode-objects-overview.pd to get an overview of available objects.

🥁 Performances & Publications

📝 Cite this work

Hoogland, T. (2023). './drum.code'. AIMC 2023. Retrieved from https://aimc2023.pubpub.org/pub/micjpv5j

@article{Hoogland2023drum,
	author = {Hoogland, Timo},
	journal = {AIMC 2023},
	year = {2023},
	month = {aug 29},
	note = {https://aimc2023.pubpub.org/pub/micjpv5j},
	publisher = {},
	title = {./drum.code},
}

🔭 Goals

  • An accessible, documented, entry-level toolkit/library for working with acoustic instruments and electronic music
  • Research into real-time onset-detection, timbre-analysis and other sound descriptors for acoustic instruments and creating a documented open-source toolkit/library
  • Research into pattern detection, tempo detection and other temporal based descriptors through machine learning classification techniques and other techniques such as auto-correlation
  • Research in working with contact microphones on drums and other acoustic instruments and documentation with good practices and findings
  • Creating ways to connect the toolkit with other platforms via protocols such as MIDI, OSC and DMX
  • Combining the library with open-source live coding languages such as the Mercury Playground
  • Using live coding techniques and languages to create electronic music with self-build triggers
  • Research into training neural networks on small live coded datasets to generate, suggest or adjust code in real-time based on external input from for example matched descriptors of the acoustic instrument.
  • Using the library to give workshops to drummers (and potentially other musicians) in which live interaction between the acoustic drums and digital electronic music is created through creative coding.

🔋 Powered By

✨ Inspiration & Reading

For this project I've found inspiration in many different places, from different artists, coders, musicians, papers, you name it.

📝 License

The GNU GPL v.3 License

THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.

About

A library of tools for hybrid drums (or other instruments), with onset detection, timbre analysis, basic algorithmic composition techniques, midi and osc trigger outputs, and more

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Languages