https://github.com/mikea/clave
Midi click-track generator
https://github.com/mikea/clave
clicktrack metronome midi
Last synced: 2 months ago
JSON representation
Midi click-track generator
- Host: GitHub
- URL: https://github.com/mikea/clave
- Owner: mikea
- Created: 2025-01-12T03:18:19.000Z (5 months ago)
- Default Branch: master
- Last Pushed: 2025-01-20T23:37:45.000Z (5 months ago)
- Last Synced: 2025-03-28T11:21:12.439Z (3 months ago)
- Topics: clicktrack, metronome, midi
- Language: Rust
- Homepage:
- Size: 106 KB
- Stars: 1
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
# Clave
Clave is a midi click-track generator.
It generates single-track single-channel midi file
with a customizable click pattern.
Note: click tracks are percussion in their nature.
Because of this clave does not generate note off events
(only note on).
## Pregenerated Tracks
A lot of pregenerated tracks are available
in [tracks](https://github.com/mikea/clave/tree/master/tracks) folder.
## Installation
`cargo install clave`
## Usage
By default Clave generates 1000 beats of 120bpm 4/4 clicks:
```
clave --out 44_120.mid
```
You can use command line arguments to customize the track:
```
-b, --bpm Track tempo (beats per minute) [default: 120]
--channel Midi channel [default: 10]
--beats Track length in number of beats [default: 1000]
--vel Default note velocity [default: 63]
--acc-vel Accented note velocity [default: 94]
--ghost-vel Ghost note velocity [default: 31]
--subs Number of subdivisions in a pattern [default: 1]
-p, --pattern Click pattern [default: m>mmm]
```
### Click Pattern
You can use `--pattern` together with `--subs` to create
more sophisticated click patterns:
- the pattern consists of pattern items optionally separated by spaces
- each pattern item consists of the note:
- `m` - metronome click
- `c` - clave click
- `h` - closed hi-hat
- `r` - rest
- and optional volume modifier:
- `>` - accented note
- `,` - ghost note
Default pattern is `m>mmm` which corresponds to 4/4
metronome click with accented first beat.
Some usefull patterns are:
| Description | Subs | Pattern
|---|---|--|
|4/4 with ghost 8th| `2` | `"m>m,mm,mm,mm,"`
|Son clave 3-2| `2` | `"crrcrrcrrrcrcrrr"`
|Son clave 2-3| `2` | `"rrcrcrrrcrrcrrcr"`
|Rumba clave 3-2| `2` | `"crrcrrrcrrcrcrrr"`
|Rumba clave 2-3| `2` | `"rrcrcrrrcrrcrrrc"`
|Cascara 2-3| `2` | `"h>rh>rhh>rhh>rhh>rh>rh"`