DubbyGen

---

Welcome to DubbyGen, the official repository for developing gen~ patches on the Dubby platform by Componental. This package enables Max/MSP Gen users to build, test, and deploy custom DSP patches for Dubby, creating a robust, modular tool for music production and live performance.

DubbyGen is an open-platform toolkit designed for developers, musicians, and sound designers to create and share custom audio effects and musical applications on the Dubby device made with Gen.

Overview

DubbyGen is designed to integrate seamlessly with Oopsy, Componental's fork from ElectroSmith adapted for Dubby. With DubbyGen, developers can:

Access a library of gen~ modules for DSP effects and synthesis - coming soon.

Use example patches to explore Dubby’s audio processing capabilities - coming soon.

Deploy patches to Dubby via the Oopsy package for embedded performance - coming soon.

Features

• Patch Templates and DSP Components: Reusable DSP modules and templates tailored for Dubby’s hardware capabilities.
• Example Patches: A collection of patches to kickstart your Dubby development, available in the Max "Examples" folder once installed.
• Documentation and Resources: In-depth resources and examples on developing, deploying, and optimising patches for Dubby.

Requirements

• Max/MSP with Gen~: Required for building and editing patches. Gen is a package included in Max. Get Max here
• Oopsy for Dubby - WILL BE AVAILABLE LATER: Our customised fork of Electro-smith's Oopsy to flash Gen patches to Dubby. Get Oopsy for Dubby here.

Installation STEP 1 of 2

Installing DubbyGen on macOS

To install DubbyGen as a Max Package on macOS:

1. Clone the Repository - CHECK YOUR VERSION OF MAX!
   Clone this repository into your Max Packages directory:

   cd ~/Documents/Max 8/Packages/
   git clone https://github.com/Componental/DubbyGen.git
   

In case Oopsy is not installed

2. Install Componental's fork of Oopsy - CHECK YOUR VERSION OF MAX! - WILL BE AVAILABLE LATER
   DubbyGen depends on Oopsy to flash Gen patches to Dubby. Clone our Oopsy fork:

   cd ~/Documents/Max 8/Packages/
   git clone ...................

3. Restart Max
   Once installed, restart Max to load the new DubbyGen package and access the example patches.

---

Installing DubbyGen on Windows

To install DubbyGen as a Max Package on Windows:

1. Clone the Repository - CHECK YOUR VERSION OF MAX!
   Clone this repository into your Max Packages directory:

   cd "%UserProfile%\Documents\Max 8\Packages"
   git clone https://github.com/Componental/DubbyGen.git
   

In case Oopsy is not installed

2. Install Componental's fork of Oopsy - CHECK YOUR VERSION OF MAX! - WILL BE AVAILABLE LATER
   DubbyGen depends on Oopsy to flash Gen patches to Dubby. Clone our Oopsy fork:

   cd "%UserProfile%\Documents\Max 8\Packages"
   git clone ...................

3. Restart Max
   Once installed, restart Max to load the new DubbyGen package and access the example patches.

---

Installation STEP 2 of 2

Adding DubbyGen to the Max file search path.

1. Add Path to Max
   
2. Open Max, go to Options > File Preferences, and add the path to your DubbyGen package.
   

Select Directory In the file browser, navigate to the DubbyGen package directory, select it, and confirm.

Confirm Directory Added to Max The DubbyGen directory should now appear in Max’s file preferences, indicating successful addition.

Getting Started

1. Explore Examples - coming soon
   Open Max, go to Help > Examples, and select "Dubby Examples" for a hands-on introduction to Dubby patch development.

2. Create Custom Patches
   Use DubbyGen’s templates and DSP modules to design your patches. Open a new patch, add a Gen~ object, and use the provided modules.

3. Deploy with Oopsy
   With your patch open, follow the Oopsy instructions to flash it directly to your Dubby hardware.

For visual help, we recommend duplicating this Google Drawing template and using it as an overview for parameter mapping and DSP Block Diagram.

Recommended reading

Graham Wakefield: Generating Sound & Organizing Time: Thinking With gen~ Book 1 [BOOK]

See more here
Link to Graham Wakefield's Github profile.

Gen for beginners [ONLINE TUTORIAL]

Explore the basics of using gen~ with this beginner-friendly video series from Cycling74.

• Gen~ for Beginners, Part 1: A Place to Start
• Gen~ for Beginners, Part 2: Similarities and Differences
• Gen~ for Beginners, Part 3: Counting, and a World without bang Messages
• Gen~ for Beginners, Part 4: Working with Buffers (and Data)
• Gen~ for Beginners, Part 5: The Codebox Operator
• Gen~ for Beginners, Part 6: Thinking Inside the Codebox
• Gen~ for Beginners, Part 7: Creating Reusable Tools

Contribution

Read more about contributing here.
Please review this issue for a discussion about the timing and considerations for making this repository public.

Support

Get in touch with us via:

• Link-in-Bio
  
• Discord
• Instagram
• LinkedIn
• YouTube

License

DubbyGen is licensed under a Creative Commons Attribution-NonCommercial 4.0 International License (CC-BY-NC 4.0) with additional terms for code generated via Cycling74’s Max/gen environment. For full license terms, including these modifications and Cycling74 Gen Code Export Licensing information, please see the LICENSE file.