KO | EN

GitLite

Minimalist Open Source Repository Search Engine

gitlite — search

#dsh #dsh-plugin #developer-tools #ai-agent #claude-code #codex #typescript #ai-agents #deepseek-harness #mcp #cli #rust

Bud-Music-Box

★ 7 Open GitHub ↗

Generative music through operads.

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

# Bud Music Box
`|3^^|3`

A tool to generate random music from short patterns using operads, colored operads, and bud
generating systems.

## Quick overview and examples
This program offers a complete language allowing to represent musical patterns, to compute
over them, and to randomly generate some of them. Results can be converted to files in the
[abc format](http://abcnotation.com) and then into MIDI files.

### Main functionalities
1. [Multi-pattern creation](Examples/MultiPatternCreation.bmb)
1. [Multi-pattern operations](Examples/MultiPatternOperations.bmb)
1. [Specificating the context](Examples/ContextSpecifications.bmb)
1. [Colored multi-patterns and random generation](Examples/Generation.bmb)

### Some examples
1. An [example](Examples/CompleteHir1.bmb) on the Hirajoshi scale.
   Listen [here](https://soundcloud.com/samuele-giraudo-541379677/completehir1).
2. An [example](Examples/CompleteHir2.bmb) on the Hirajoshi scale.
   Listen [here](https://soundcloud.com/samuele-giraudo-541379677/completehir2).
3. An [example](Examples/CompleteHir3.bmb) on the Hirajoshi scale.
   Listen [here](https://soundcloud.com/samuele-giraudo-541379677/completehir3).
4. An [example](Examples/CompleteMaj1.bmb) on the natural major scale.
   Listen [here](https://soundcloud.com/samuele-giraudo-541379677/completemaj1).
5. An [example](Examples/CompleteHar1.bmb) on the harmonic minor scale.
   Listen [here](https://soundcloud.com/samuele-giraudo-541379677/completehar1).
6. An [example](Examples/CompletePen1.bmb) on the minor pentatonic scale.
   Listen [here](https://soundcloud.com/samuele-giraudo-541379677/completepen1).
7. An [example](Examples/CompletePen2.bmb) on the minor pentatonic scale.
   Listen [here](https://soundcloud.com/samuele-giraudo-541379677/completepen2).
8. An [example](Examples/CompleteMPen1.bmb) on the major pentatonic scale.
   Listen [here](https://soundcloud.com/samuele-giraudo-541379677/completempen1).

### Other examples
1. A [Mix of patterns](Examples/Mix.bmb).
   Listen [here](https://soundcloud.com/samuele-giraudo-541379677/mix).
2. A [horizontal transformations](Examples/Horizontal.bmb).
   Listen [here](https://soundcloud.com/samuele-giraudo-541379677/horizontal).
3. A [vertical transformations](Examples/Vertical.bmb).
   Listen [here](https://soundcloud.com/samuele-giraudo-541379677/vertical).
4. Some [local variations](Examples/Variation.bmb).
   Listen [here](https://soundcloud.com/samuele-giraudo-541379677/variation).
5. A [full piece](Examples/Composition.bmb).
   Listen [here](https://soundcloud.com/samuele-giraudo-541379677/composition).

## Versions
Here is the [changelog](Versions.md) of the different versions.

## Installation
The following instructions hold for up-to-date Linux systems.

### Dependencies
The following programs are needed:

+ `make`
+ `ocaml`
+ `ocamlbuild`
+ `ocamlfind`
+ `menhir`
+ `abcmidi`
+ `abcm2ps`
+ `timidity`

Moreover, a proper installation of a SoundFont is necessary.

### Building
Here are the required steps to build the interpreter `Bud Music Box`:

1. Clone the repository somewhere by running
```
git clone https://github.com/SamueleGiraudo/Bud-Music-Box.git
```

2. Install all dependencies (see the section below).

3. Build the project by running `make`.

This creates an executable `bmb`. The following sections explain how to use it.

## User guide
This [page](Help.md) contains the description of the Bud Music Box instruction set and
language.

Files containing such instructions must have `.bmb` as extension. Given such a file
`Program.bmb`, the command

`./bmb --file Program.bmb`

executes the instructions of `Program.bmb`, sequentially from the first one to the last one.

## Miscellaneous
To get the syntax highlighting in the text editor `vim` for the Bud Music Box language, put
the file [bmb.vim](Vim/syntax/bmb.vim) at `~/.vim/syntax/bmb.vim` and the file
[bmb.vim](Vim/ftdetect/bmb.vim) at `~/.vim/fdetect/bmb.vim`.

## Theoretical aspects
An operad is an algebraic structure wherein elements are operations. This generative method
is based upon an abstraction of polyphonic musical phrases called _multi-patterns_, forming
the **music box model**. The set of these objects is endowed with the structure of an
operad, thus enabling us to perform computations on musical phrases. Indeed, the operad
structure on multi-patterns makes it possible to consider any multi-pattern as an operation
on multi-patterns. The main idea is that one can, from a set of small musical phrases,
randomly generate a new musical phrase by computing various random compositions of these
patterns.

## Bibliography
+ About operads:
    + M. Méndez.
      Set operads in combinatorics and computer science.
      Springer, Cham, SpringerBriefs in Mathematics, xvi+129, 2015.

+ S. Giraudo.
      Nonsymmetric Operads in Combinatorics.
      Springer Nature Switzerland AG, ix+172, 2018.

+ About operads and combinatorial generation:
    + S. Giraudo.
      Colored operads, series on colored operads, and combinatorial generating systems.
      Discrete Math., 342, 6, 1624--1657, 2019.

+ S. Giraudo.
      Combinatorial operads from monoids.
      J. Algebr. Comb., 41, Issue 2, 493–538, 2015.

+ About the operad of patterns:
    + S. Giraudo.
      Generation of musical pattern through operads.
      [Journées d'informatique musicale](https://jim2020.sciencesconf.org/), 2020.

+ S. Giraudo.
      [The music box operad: random generation of musical phrases from patterns](
        https://arxiv.org/abs/2104.13040),
      Work in progress, 2022.

Bud-Music-Box

Explore Similar Repositories

Was this content helpful?

Recent Feedback

Download README