Metadata-Version: 2.1
Name: tuning-fork
Version: 1.7.1
Summary: A clip/sample auto tuner
Home-page: https://github.com/ddxtanx/TuningFork
Author: Garrett Credi
Author-email: gcc@ameritech.net
License: UNKNOWN
Platform: UNKNOWN
Classifier: Development Status :: 5 - Production/Stable
Classifier: Environment :: Console
Classifier: Intended Audience :: Developers
Classifier: Natural Language :: English
Classifier: Programming Language :: Python :: 3.6
Classifier: License :: OSI Approved :: MIT License
Classifier: Operating System :: OS Independent
Classifier: Topic :: Multimedia :: Sound/Audio :: Mixers
Classifier: Topic :: Multimedia :: Sound/Audio :: Analysis
Classifier: Topic :: Utilities
Description-Content-Type: text/markdown
Requires-Dist: librosa
Requires-Dist: numpy
Requires-Dist: pysoundfile

# Installation/Requirements

All requirements are in requirements.txt. They are numpy for array manipulations, librosa for audio processing, and scipy for it's wavefile export.

Installation, currently, is all via github. To download the cli tool run

    pip3.6 install tuning-fork-cli

or, if you just want the Python Library Code, run

    pip3.6 install tuning-fork

This project does require python3.6 since I use mypy annotations to help me out.

# CLI Usage

    usage: tuning-fork [-h] [--bpm BPM] [--out OUT] [--play] wavfile musicfile

    Autotune a wavfile to a .music file

    positional arguments:
    wavfile     The path to the wavfile you want to autotune.
    musicfile   The path to the music file you want the wavfile autotuned to.

    optional arguments:
    -h, --help  show this help message and exit
    --bpm BPM   The bpm you want the song to play at.
    --out OUT   The desired output file.
    --play      Automatically play after wavfile is created.

# Python Usage

To import the entire package just include

    import tuning_fork ((as tf))

in your imports and all code will be loaded!

`tuning_fork` itself contains methods for pitch shifting, so, to shift a wav to a .music, you can run

    TF = tf.TuningFork
    TF.sampleWAVFileIntoMusic("wavfilename", "musicfilename", (bpm))

and that will return a librosa style ndarray that represents the WAV encoding of the autotuned song.

Along with normal functions, `tuning_fork` also exposes analysis and parseMusic.

* analysis
  * Available via `from tuning_fork.tools.analysis import Analysis`
  * Deals with the analysis of a wavfile.
  * Most useful exports are `startingNote` and `startingNoteFromFile`
    * These methods take in some reference to a wavfile (depending on the function) and returns the approximate starting note frequency of the song.

* parseMusic
  * Available via `from tuning_fork.tools.parseMusic import ParseMusic`
  * Deals with parsing .music files
  * Fairly useful all around, take a look around the source or the `help(parseMusic)` to find what will fit you!


