Metadata-Version: 2.1
Name: polyendtracker-midi-export
Version: 0.3.2
Summary: Unofficial tool that converts Polyend Tracker *.mt project and *.mtp pattern files to midi files.
Home-page: https://github.com/DataGreed/polyendtracker-midi-export
Author: Alexey Strelkov
Author-email: datagreed@gmail.com
License: MIT License
Platform: UNKNOWN
Classifier: Programming Language :: Python :: 3.9
Classifier: Operating System :: OS Independent
Requires-Python: >=3.7
Description-Content-Type: text/markdown
License-File: LICENSE.txt

# Polyend Tracker MIDI Export tool

MIDI conversion tool for Polyend Tracker project files written in Python.

If you just want to convert your Tracker project to MIDI you can use the Web Service: https://polyend-tracker-midi-export.onrender.com/


## Disclaimer

I am in no way affiliated with Polyend. This is a hobby project.

## Installation 

```sh
pip install polyendtracker-midi-export
```

## Usage

Polyend Tracker MIDI Export tool can be used as a command line utility or as a library that can be imported in your python projects.

### Converting an entire Tracker project to MIDI

Just point the script to your project's directory:

```sh
$ polymidiexport ./my-tracker-project/ 
```

Alternatively point it to a project file:

```sh
$ polymidiexport ./my-tracker-project/project-file.mt 
```


### Converting an individual Tracker pattern file to MIDI

Converting Polyend Tracker `*.mtp` pattern file to midi (pattern files are nested in project folders under `patterns`):

```sh
$ polymidiexport ./my-tracker-project/patterns/pattern_02.mtp 
```

Specifying custom output file name:

```sh
$ polymidiexport ./my-tracker-project/patterns/pattern_02.mtp ./my-midi-file.mid
```

Converting Polyend Tracker `*.mtp` pattern file to a text file (outputs a table view of the 
pattern similar to how you see it in Tracker UI):

```sh
:$ python polytracker2text.py ./my-tracker-project/patterns/pattern_02.mtp 
```

You can see an example of pattern text representation [here](./reverse-engineering/session%201/project%20files/datagreed%20-%20rebel%20path%20tribute%202/patterns/pattern_01.txt)

## Usage in python projects

Import lib:

```python
import polytrackermidi
from polytrackermidi.parsers import constants, project, patterns, arps, chords
from polytrackermidi.exporters import midi
```

```python
#todo: describe API usage
```  

## Reverse Engineering

- [Pattern *.mtp files](reverse-engineering/patterns-reverse-engineering.md)
 
## TODOs

- ~~Pattern file parsing~~
- Render names for All FX types 
- Support rendering of all possible ranges of values for FXs
- Pattern MIDI export
  - ~~basic export~~
  - support for velocity (volume FX)
  - ~~support for chord FX~~
    - make sure that all chord interval formulas are correct 
  - ~~support for arp FX~~
  - support for microtiming (micromove, `m`) FX
  - support for microtuning `M` fx (do midi files support that?) 
  - ~~cli tool for converting files~~
  - support for panning ([it seems](http://midi.teragonaudio.com/tech/midispec/pan.htm) to be supported by midi )
- Song arrangement MIDI export
  - ~~export~~
  - ~~extract BPM~~
  - ~~cli tool for converting files~~
  - assign instrument names to midi tracks from instrument project files
- ~~PyPi package~~
- ~~conversion web service~~ – https://polyend-tracker-midi-export.onrender.com/



