pure-data
Pure Data reference documentation for audio patch development. Use when writing .pd patches, working with OSC/audio/sampling, or implementing Pure Data code.
When & Why to Use This Skill
This Claude skill serves as a comprehensive technical reference for Pure Data (Pd), an open-source visual programming language for multimedia. It provides deep documentation on audio signal processing, OSC/FUDI networking protocols, and complex message routing logic. Designed for developers and sound artists, it streamlines the creation of .pd patches, offering precise guidance on DSP optimization, file format syntax, and real-time audio synthesis to enhance the development workflow for interactive audio projects.
Use Cases
- Designing custom digital synthesizers and audio effects using oscillators, filters, and sophisticated envelope generators (ADSR, vline~).
- Implementing low-latency communication between hardware (like ESP32 sensors) and software via OSC and FUDI protocols for interactive installations.
- Developing algorithmic music compositions and generative sequences using advanced timing, message routing, and conditional logic patterns.
- Troubleshooting and optimizing DSP performance to prevent CPU dropouts and ensure stable real-time audio processing in complex patches.
- Programmatically generating or validating .pd file structures for automated patch creation and large-scale project management.
| name | pure-data |
|---|---|
| description | Pure Data reference documentation for audio patch development. Use when writing .pd patches, working with OSC/audio/sampling, or implementing Pure Data code. |
Pure Data Reference
Pure Data (Pd) reference documentation organized by topic. Files are independent unless cross-referenced. Load relevant files as needed.
Core Concepts
- pd-fundamentals.md - Patches, canvases, box types, inlets/outlets basics
- pd-execution-model.md - Message passing, execution order, hot/cold inlets
- pd-workflow-and-editing.md - Edit vs run mode, patch editing operations
- pd-advanced-structures.md - Subpatches, abstractions, arrays, graph-on-parent
Audio Processing
- pd-audio-fundamentals.md - Sample rates, tilde objects, signal/control conversion basics
- pd-audio-routing.md - Signal routing, throw
/catch, send/receive, feedback loops - pd-audio-performance.md - Block size optimization, DSP control, realtime processing
- pd-audio-objects.md - Reference catalog: oscillators, filters, analysis, I/O
- pd-audio-examples.md - Quick-start audio patches with raw .pd code
- pd-audio-multichannel.md - Multichannel signal features (Pd 0.54+)
Envelopes
- pd-envelopes-basics.md - Basic envelope generation with line~ and vline~
- pd-envelopes-adsr.md - ADSR abstraction implementation and retrigger behavior
- pd-envelopes-dbtable-conversions.md - Logarithmic dB conversion and quartic curves
- pd-envelopes-pitch-modulation.md - Pitch envelopes, portamento, frequency modulation
- pd-envelopes-reference.md - Envelope techniques comparison and parameter ranges
Expression Language
- pd-expr-basics.md - expr, expr
, fexprobjects and methods - pd-expr-operators-and-functions.md - Complete math and function reference tables
- pd-expr-strings.md - String manipulation operations (control-rate only)
- pd-expr-examples-and-advanced.md - Real-world calculation patterns and performance
File Format
Essentials
- pd-file-format-reference.md - .pd file syntax, object types, connection format
- pd-file-format-messaging.md - Send/receive patterns, $0 addressing, message variables
- pd-file-format-organization.md - Subpatches, abstractions, creation arguments structure
Advanced
- pd-file-format-patterns.md - Reusable patch templates and common structures
- pd-file-format-generation.md - Programmatic .pd file creation from code
- pd-file-format-validation.md - File format validation and error detection
Message Routing
- pd-message-construction.md - Message aggregation and distribution with pack/unpack
- pd-message-variables-and-dispatch.md - Dynamic messages using $N, semicolons, commas
- pd-conditional-routing.md - Decision-making with select, route, spigot, moses
- pd-random-numbers.md - Pseudo-random generation, seeding, distributions
- pd-routing-patterns.md - Design patterns for message flow and control logic
Networking
- pd-fudi-protocol.md - FUDI protocol specification and command-line tools
- pd-osc-protocol.md - OSC protocol concepts and native object usage
- pd-network-objects-reference.md - netsend, netreceive, oscformat, oscparse reference
- pd-networking-guide.md - Network examples, TCP vs UDP, debugging strategies
Sampling
- pd-sampling-basic-reading.md - Scratch machine and basic table looping
- pd-sampling-smooth-looping.md - Click-free loops with envelopes and overlapping readers
- pd-sampling-triggered-playback.md - One-shot and parameterized sample triggering
- pd-sampling-polyphony.md - Multi-voice sample allocation and management
- pd-sampling-utilities.md - Table operations and sampler object reference
Timing & Sequencing
- pd-timing-metro-counters.md - Periodic pulse generation and counting patterns
- pd-timing-conditional-counting.md - Bounded sequences with conditional logic
- pd-timing-delays-timers.md - Single-event scheduling with delay and timer
- pd-timing-pipe.md - Multi-event queuing with data preservation
- pd-timing-sequencing.md - Complex event scheduling with qlist and text
- pd-timing-loops.md - Immediate iteration with until (safety warnings)
- pd-timing-reference.md - Timing precision notes and quick reference tables
- pd-timing-and-format.md - Scheduling semantics, determinism, time representation
Task Recipes
- common-tasks-creating-patches.md - When to use subpatches vs abstractions
- common-tasks-osc-networking.md - OSC message receive/send implementation
- common-tasks-sample-playback.md - Loading samples from files and tables
- common-tasks-audio-processing.md - Rate conversion, envelope application, stereo panning
- common-tasks-message-routing.md - Trigger sequencing and threshold routing
- common-tasks-testing-validation.md - Console debugging and signal monitoring
- common-tasks-integration-setup.md - External libraries, path configuration, DSP startup
- common-tasks-performance-optimization.md - CPU profiling and DSP optimization strategies
Troubleshooting
- troubleshooting-patch-creation.md - Object creation failures, DSP loops, network setup
- troubleshooting-audio.md - DSP configuration, signal flow, audio device issues
- troubleshooting-timing-performance.md - Message ordering, latency, CPU dropouts
- troubleshooting-libraries-advanced.md - External library loading and array configuration
- troubleshooting-debugging-methodology.md - Systematic debugging workflow
Project Context
Architecture: ESP32 Sensors → OSC :8000 → Pure Data → Audio Out + OSC :8001 → Lighting
Required Externals: mrpeach (OSC), cyclone (Audio utilities)
Project Files:
docs/audio/reference/phase1-trd.md- Technical requirementsdocs/audio/tasks/phase1-audio.md- Implementation tasksaudio/patches/- Patch filesaudio/samples/- Audio samples