diff --git a/README.md b/README.md
new file mode 100644
index 0000000..3001a84
--- /dev/null
+++ b/README.md
@@ -0,0 +1,92 @@
+♪ ♫ ♩ ♬
+
+# node-midi
+
+A node.js wrapper for the RtMidi C++ library that provides realtime MIDI I/O.
+RtMidi supports Linux (ALSA & Jack), Macintosh OS X (CoreMidi), Windows
+(Multimedia), although node-midi has only been tested briefly on Mac OS X.
+
+## Installation
+
+	$ node-waf configure && node-waf build
+
+## Usage
+
+Input:
+
+    var midi = require('midi');
+    
+    // Set up a new input.
+    var input = new midi.input();
+    
+    // Count the available input ports.
+    input.getPortCount();
+    
+    // Get the name of a specified input port.
+    input.getPortName(0);
+    
+    // Configure a callback.
+    input.on('message', function(deltaTime, message) {
+	  console.log('m:' + message + ' d:' + deltaTime);
+    }); 
+        
+    // Open the first available input port.
+    input.openPort(0);
+    
+    // ... receive MIDI messages ...
+    
+    // Close the port when done.
+    input.closePort();
+
+Output:
+
+    var midi = require('midi');
+    
+    // Set up a new output.
+    var output = new midi.output();
+    
+    // Count the available output ports.
+    output.getPortCount();
+    
+    // Get the name of a specified output port.
+    output.getPortName(0); 
+        
+    // Open the first available output port.
+    output.openPort(0);
+    
+    // Send a MIDI message.
+    output.sendMessage([176,22,1]);
+    
+    // Close the port when done.
+    output.closePort();
+
+## References
+
+  * http://music.mcgill.ca/~gary/rtmidi/
+  * http://syskall.com/how-to-write-your-own-native-nodejs-extension
+
+## License
+
+Copyright (C) 2011 by Justin Latimer.
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in
+all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
+THE SOFTWARE.
+
+A different license may apply to other software included in this package, 
+including RtMidi. Please consult their respective license files for the 
+terms of their individual licenses.
\ No newline at end of file