beatstoch¶

BPM-aware stochastic drum MIDI generator - Create dynamic, probabilistic drum patterns that adapt to any song's BPM.

Overview¶

beatstoch is a powerful tool for generating drum patterns that intelligently adapt to any song's BPM. Whether you're a music producer looking for inspiration or a developer wanting to integrate dynamic rhythm generation into your application, beatstoch provides both a command-line interface and Python library.

Key Features¶

🎵 BPM Database Integration: Automatically looks up song BPM from online databases
🎶 Multiple Styles: House, breaks, and generic drum patterns
🔀 Stochastic Generation: Creates varied, probabilistic drum patterns
🎹 MIDI Export: Generates standard MIDI files compatible with all DAWs
⚡ CLI & Library: Use as a command-line tool or Python library
🎛️ Customizable: Adjust swing, intensity, bars, and more

Quick Start¶

Command Line¶

# Generate 8 bars of house drums for any song
beatstoch generate "Billie Jean" --artist "Michael Jackson"

# Generate breaks pattern at specific BPM
beatstoch generate-bpm 128 --bars 16 --style breaks

# See all options
beatstoch --help

Python Library¶

from beatstoch import generate_from_song, generate_stochastic_pattern

# Generate from song lookup
midi_file, bpm = generate_from_song(
    "1979",
    artist="Smashing Pumpkins",
    bars=8,
    style="house"
)

# Generate with explicit BPM
midi_file = generate_stochastic_pattern(
    bpm=127,
    bars=4,
    style="breaks",
    swing=0.1
)

Installation¶

pip install beatstoch

Documentation Contents¶

User Guide - Complete usage instructions and examples
API Reference - Python library documentation
Developer Guide - Contributing and development workflows

Examples¶

See the User Guide for comprehensive examples and detailed usage instructions.

License¶

[Add your license information here]

Support¶

Generated drum patterns are for educational and creative purposes. Always respect music copyrights and licensing.