OffiTracker/README.md

# OffiTracker

Ever wanted to make music in Excel? Now you can!

OffiTracker lets you use CSV spreadsheets to create chiptunes. Its as simple as typing in the frequency, pulse width and duration.

![Screenshot of a spreadsheet program showing tracker data](img/excel.png)
![The softwares CLI](img/cli.png)

## Usage

Running OffiTracker requires the following packages to be present on your system:

`python3, python3-csv, pyhon3-numpy, python3-sounddevice`

Assuming `python3` is already installed, you can use the following command to install the dependencies:

```bash
pip3 install csv numpy sounddevice
```

After that, simply run `python3 offitracker.py` and enjoy. The command can also take a path to a file as a parameter if you wish to use your shells autocompletion.

____

Examples can be found in the `example` folder.

A utility for converting midi files to csv can be found in the utility folder (monophonic only).

For usage information, check the contents of the `offitracker.py` file