diff --git a/README.md b/README.md
index 095ff6d..dec55f6 100644
--- a/README.md
+++ b/README.md
@@ -1,3 +1,56 @@
 # ffx
+quickly apply audio effects using ffmpeg
 
-quick apply audio effects using ffmpeg
\ No newline at end of file
+to install, run command 'chmod +x ffx.sh' in same directory as `ffx.sh`
+
+<br>
+
+<pre>
+
+example (bass boost)    ffx.sh bass song.mp3 10 1 song2.mp3
+
+</pre>
+
+---
+
+<pre>
+supports mp3, wav, flac, ogg, opus, m4a, aac, and mka
+
+features
+-bass, treble, volume, distortion
+-trim audio
+-tempo change with pitch preserving
+-pitch change
+
+
+usages
+  ffbass   INPUT PERCENT [FINE_DB] [OUTPUT]
+  fftreble INPUT PERCENT [FINE_DB] [OUTPUT]
+
+    33 = 16.5 dB (half of 33 dB)
+    66 = 33 dB
+    100 = 50 dB
+    FINE_DB is added/subtracted afterward.
+
+  ffvolume  INPUT DB [OUTPUT]
+  ffdistort INPUT [DRIVE_0_TO_10] [OUTPUT]
+  fftrim    INPUT START_SECONDS [END_SECONDS] [OUTPUT]
+  fftempo   INPUT SPEED_0.125_TO_8 [OUTPUT]       # preserves pitch
+  ffpitch   INPUT SEMITONES_-36_TO_36 [OUTPUT]    # preserves duration
+
+Defaults:
+  Output uses the source extension and a unique suffix.
+  Use an explicit filename ending in .mp3 for MP3 output.
+
+Examples:
+  ffbass "cometolifeice.mp3" 33 2
+  ffbass "song.wav" 33 2 "bass.mp3"
+  fftreble "song.flac" 66 -4 "treble.flac"
+  ffvolume "song.mp3" -3
+  ffdistort "song.wav" 4 "distorted.mp3"
+  fftrim "song.mp3" 12.5 48 "clip.mp3"
+  fftempo "song.mp3" 0.5 "slow.mp3"
+  ffpitch "song.mp3" -3 "lower.mp3"
+
+
+</pre>
\ No newline at end of file