# `mix mx.hum`
[🔗](https://github.com/mx-music/mx/blob/main/lib/mix/tasks/mx.hum.ex#L1)

Reads a recording of one voice humming, singing or whistling a melody, and writes it as a song beside the recording.

    mix mx.hum hum.wav --tempo 90
    mix mx.hum hum.wav --tempo 90 --out tune.exs --force

The recording is WAV or AIFF, mono or stereo, at any sample rate, and `--tempo` is the tempo it was hummed at.
The song is named after the recording with `.exs`, or `--out` names it, and a song that exists is written over only with `--force`.
It has one part, hum, on mx's default synth, that plays the melody again and again as a seq of note names and rests, as `Mx.Hum` describes.

    mix mx.hum --record hum.wav --tempo 90

`--record` plays a click at the tempo, a bar of 4 beats as a count-in and then every beat, records the sound card's first input to the file until Enter is pressed, and turns it into a song as above, with beat 0 on the first beat after the count-in, as `Mx.Hum.Recorder` describes.
`--input 2` records another input, and `--force` records over a recording that exists and writes over its song.

---

*Consult [api-reference.md](api-reference.md) for complete listing*