Skip to content
Switch branches/tags

Latest commit


Git stats


Failed to load latest commit information.
Latest commit message
Commit time


mosh is a small command-line application written in Nim for 'moshing' data into audio. There is also an experimental markov-based synthesiser that can help you generate audio based on the results of your conversion process.

mosh is fast, small and bare bones and can be compiled to any platform that Nim can compile to. This includes MacOS, Windows, Linux, iOS, Android.

This project stems from my own perverse use of SoX to bend raw data into audio with the command:

sox -r 44100 -b 8 -c 1 -e unsigned-integer input.raw output.wav

I wanted to write a small application that could implement this functionality but without the overhead of having to install SoX, a tool suited to performing a number of other DSP tasks that I didn't need. This was also a fun project to learn more about the structure of WAVE audio as well as experimenting with the Nim language.

Francesco Cameli is a significant contributor, particularly in optimising the code to be fast (from 100ms to less than 5ms!). I'd like to also thank him for his patience and guidance on all things Nim.


Installation is simple. git clone this repo, cd to it and run the following nimble command:

nimble installRelease

The command will install all mosh's executables in your predefined nimble directory. (Usually, ~/.nimble/bin)

You can also build it however you like with something like nim c --threads:on mosh.nim.


The mosh executable mosh takes a first argument that defines what sub-command you would like to run (either convert or generate).


In convert mode, you can pass a folder or file as the input and the executable will convert all files in the folder recursively or a single file and place it at the output which is a directory or file.

an input file/folder and an output file/folder name. Example:

mosh cat.png output.wav

Which could convert the cat.png file to a new wav file output.wav.


mosh foo bar

Which would convert all the files inside the directory foo recursively into a new folder called bar.


To generate some more audio based on an output you can use the generate command which uses a markov chain analysis to construct a state graph of the values in the output audio. This only works on 8-bit audio right now, and probably won't work well on anything above this due to the sheer increase in possible values by moving above an 8-bit representation.

An example execution would look something like:

mosh generate -i inputfile.wav -o outputfile.wav --order 32 --length 10.

Help and issues

Detailed help can be found by running mosh -h or mosh convert -h or mosh generate -h.

If you have any issues or questions please raise one on the github!


turn raw data into audio




No releases published


No packages published