initial rev

1 files changed, 26 insertions, 0 deletions

diff --git a/README.md b/README.md
new file mode 100644
index 0000000..d20eaf0
--- /dev/null
+++ b/README.md
@@ -0,0 +1,26 @@
+intonation-js
+=============
+
+This module is a general-purpose tuning library used to work with musical scales.  It supports:
+
+- equal temperament generator
+- scales based on intervals (just intonation)
+- scales based on frequencies
+- scl file format
+
+Once a scale is established you should be able to -
+
+- generate frequencies based on a root note
+- find the closest frequency within a scale to a given frequency
+
+links
+-----
+
+ - <http://www.huygens-fokker.org/scala/> - the Scala tuning generator
+ - <https://github.com/abbernie/tune> - another tuning library with scales preloaded
+
+> Scala is a powerful software tool for experimentation with musical tunings, such as just intonation scales, equal and historical temperaments, microtonal and macrotonal scales, and non-Western scales. It supports scale creation, editing, comparison, analysis, storage, tuning of electronic instruments, and MIDI file generation and tuning conversion. All this is integrated into a single application with a wide variety of mathematical routines and scale creation methods. Scala is ideal for the exploration of tunings and becoming familiar with the concepts involved. In addition, a very large library of scales is freely available for Scala and can be used for analysis or music creation.
+
+
+
+