Frequently Asked Questions

Everything you need to know about orDrumbox v2 architecture, features, and workflow.

1. General & Architecture

orDrumbox is a free, open-source software drum machine and melodic sequencer designed for composing complex electronic music. Unlike rigid step sequencers, it uses a highly modular architecture where songs are built from custom Patterns, organized in Tracks, assigned to individual Drumitems (voices), and managed within comprehensive Drumkits.

  • Drumkit: A complete collection of sound generators, multi-samples, and synth voices used across your project.
  • Drumitem: An individual sound voice (such as a Kick, Snare, Bassline, or Lead synth) configured with specific synthesis, pitch, or sample parameters.
  • Track: The actual sequence of notes, pitch values, and parameters assigned to a single Drumitem within a Pattern.

orDrumbox was built as a creative playground and research platform for algorithmic sound creation. Rather than mimicking rigid hardware setups, it treats rhythms as dynamic mathematical constructs.

By combining auto-composition, conditional triggers, polyrhythms, and procedural synthesis, it encourages producers to break out of repetitive sequencing habits and explore uncharted generative textures.

Yes. orDrumbox is released under the GNU General Public License (GPL), making it 100% free for both personal and commercial music production.

2. Basslines & Melodic Sequencing

Yes! Despite its name, orDrumbox is a fully featured melodic sequencer. You can load pitched synth waveforms or multi-sampled instruments to sequence dynamic basslines, arpeggios, and lead synth lines alongside your percussion tracks.

  • Pitch Offset & Scales: You can assign precise chromatic notes or constrain your sequences to specific musical scales directly on the step editor.
  • Arpeggiator Tracks: Transform any bass or synth voice into rolling basslines using built-in arpeggiator modes (up, down, random, chord-based) with customizable octaves and gate times.
  • Note Length & Glide: Adjust step durations and pitch envelopes to create smooth 303-style bass glides, muted stabs, or long sub-bass tones.

3. Advanced Pattern Editing & Sequencing

orDrumbox offers extensive pattern manipulation tools that go far beyond standard step sequencing:

  • Triggers & Probabilities: Set conditional rules for note playback (e.g., play a hit or bass accent only 1 time out of 4, or trigger notes based on percentage chances) to create organic, non-repetitive rhythms.
  • Retrigger & Micro-timing: Subdivide single grid steps to execute rapid roll effects (flams, ratchets, and burst fills) directly on the fly.
  • Euclidean Rhythms & Polyrhythms: Generate mathematical, evenly-spaced rhythmic patterns across any step count (e.g., 5 hits over 16 steps) and customize time signatures per track.
  • Per-Note Parameter Automation: Fine-tune pitch, velocity, panning, and VCO envelope parameters individually for every step in the grid.

orDrumbox supports independent track length settings, allowing every track within a single pattern to loop on its own cycle (e.g., running a 3-step hi-hat loop over a standard 16-step kick sequence).

This decoupling of track lengths creates complex polyrhythms and polymeters effortlessly. As the internal loops shift against each other over time, your pattern constantly evolves into new rhythmic combinations without requiring a full song arrangement.

4. Drumkits & Sound Design Deep-Dive

orDrumbox features a rich, out-of-the-box library containing:

  • Acoustic & Percussion Kits: Natural drum sets, hand percussion, and realistic cymbal sounds.
  • Vintage Electronic Kits: Classic analog drum machine sounds (808/909-style kicks, snares, hats, and rims).
  • Synthesized & Melodic Kits: Dedicated synth kits featuring bass waveforms, chords, and sound effects designed for electronic music production.

Yes. You can point orDrumbox to a local directory containing your sample collections. The audio engine automatically scans a sub-folder, parses sound files (such as .wav or .mp3), and attempts to categorise them based on file naming conventions (e.g. automatically assigning samples containing "kick", "snare", or "hihat" to their corresponding instrument tracks).

This allows you to quickly generate new custom Drumkits from your existing sample libraries without having to assign every audio file manually.

Every drumkit is an open container where each Drumitem can be tailored:

  • Hybrid Engine: Mix audio samples (.wav) with the internal Soft-Synth engine (featuring Voltage-Controlled Oscillators, pitch envelopes, and resonant filters).
  • Sample Manipulation: Set custom loop points, start/end trimming, and normalization per sample.
  • Master Effects & Processing: Each drumkit routes through a dedicated master section featuring a Master Compressor, stereo panning, global gain staging, and dynamic pitch modulators.

You can create a custom Drumkit by adding new Drumitems (sound voices) in the Drumkit editor. For each voice, you can either assign local audio samples (via drag-and-drop or batch folder import) or configure the internal Soft-Synth engine to generate pure synthetic tones.

Once your voices are assembled, you can adjust individual volume levels, pitch tuning, panning, and routing before saving the entire kit as a reusable library preset.

Yes. orDrumbox features a hybrid drumkit structure. Within a single kit, you can seamlessly pair sample-backed tracks (like realistic acoustic cymbals or vinyl kicks) with fully synthesized tracks (such as a VCO-generated sub-bass or an analog noise snare).

Yes. Custom drumkits can be exported as standalone kit files or bundled into complete project exports. This makes it easy to archive your personalized sound banks, transfer them between browsers, or share your custom sound designs with the community.

5. Automatic Composition & AI Features

orDrumbox features a built-in Auto-Composition Engine based on heuristics. It analyzes your existing rhythm and bass tracks to automatically generate, mutate, and evolve new patterns and melodic lines. You can generate entire songs from scratch or ask the engine to suggest subtle pattern variations based on your style.

div class="faq-item">

Yes. The underlying code for the MCP integration is already fully written and available in the project repository (see mcp_tools.md).

Currently, this feature is primarily accessible to developers who run or connect their own local MCP server bridge. However, because the protocol handlers and API hooks are already built into the engine, integrating AI-driven natural language control (to generate patterns, switch kits, or automate parameters) into end-user workflows only requires enabling the server connection.

6. Browser Usage, Storage, Cache & PWA

orDrumbox leverages the modern Web Audio API to process high-quality audio and synthesis directly inside your browser. No plugins, Java extensions, or flash players are required. Everything runs natively on your CPU with ultra-low latency.

Your work is automatically cached locally using browser storage (LocalStorage and IndexedDB). This ensures your session persists even if you accidentally close the tab. You can also export and import complete projects as lightweight JSON files or record your audio output to standard .wav format.

Cache Storage (Automatic): Keeps your current session alive inside your browser's local memory (LocalStorage / IndexedDB). It is convenient for quick auto-saves, but it remains tied to that specific browser and device.

Export/Import (Manual): Generates a standalone project file (e.g., .json or custom project format) that you download to your hard drive. This allows you to back up your work permanently, share patterns with other users, or transfer projects across different devices and browsers without risk of losing data during cache cleanups.

Clearing temporary site data or cache will not affect exported files, but manually wiping LocalStorage / site storage will clear local autosaves. We strongly recommend using the Export Project option to keep permanent backups of your compositions on your hard drive.

Yes! orDrumbox is built as a Progressive Web App (PWA). When visiting the website on Chrome, Edge, or mobile browsers, click the install icon in the address bar to add orDrumbox to your desktop or mobile home screen. Service workers cache all core JavaScript and audio engine files, allowing the app to open instantly and work completely offline without an internet connection.