diff --git a/README.md b/README.md
new file mode 100644
index 0000000..d67dcdc
--- /dev/null
+++ b/README.md
@@ -0,0 +1,34 @@
+# tidy.nvim 🧹
+
+A function and autocommand pair that removes all
+
+    - trailing whitespace
+    - empty lines at the end of the buffer
+
+on every `BufWritePre`.
+
+![tidy](https://user-images.githubusercontent.com/59481467/142785684-96559135-88e7-4c50-a848-56f2c65262ef.gif)
+
+
+## install 
+- Packer
+
+```lua
+use "McAuleyPenney/tidy.nvim"
+```
+
+or with lazy-loading
+
+```lua
+use{ "McAuleyPenney/tidy.nvim", event = "BufWritePre" }
+``` 
+
+
+## Credits:
+- [Vim Tips Wiki entry for removing unwanted spaces](https://vim.fandom.com/wiki/Remove_unwanted_spaces#Automatically_removing_all_trailing_whitespace)
+   
+- ib., the author of [this stack overflow answer](https://stackoverflow.com/a/7501902)
+    
+- [This line](https://github.com/gpanders/editorconfig.nvim/blob/ae3586771996b2fb1662eb0c17f5d1f4f5759bb7/lua/editorconfig.lua#L180)
+in [gpanders/editorconfig.nvim](https://github.com/gpanders/editorconfig.nvim) for exposing me to the `keepjumps`
+and `keeppatterns` modifiers
diff --git a/readme.md b/readme.md
deleted file mode 100644
index 0b895f2..0000000
--- a/readme.md
+++ /dev/null
@@ -1,19 +0,0 @@
-## tidy.nvim 🧹
-
-A function and autocommand pair that removes all
-
-    - trailing whitespace
-    - empty lines at the end of the buffer
-
-on every `BufWritePre`.
-
-
-https://user-images.githubusercontent.com/59481467/138811091-05031eb1-96fc-4915-a349-e41d87c921ea.mp4
-
-
-Credits:
-1. [Vim Tips Wiki entry for removing unwanted spaces](https://vim.fandom.com/wiki/Remove_unwanted_spaces#Automatically_removing_all_trailing_whitespace)
-2. ib., the author of [this stack overflow answer](https://stackoverflow.com/a/7501902)
-3. [This line](https://github.com/gpanders/editorconfig.nvim/blob/ae3586771996b2fb1662eb0c17f5d1f4f5759bb7/lua/editorconfig.lua#L180)
-in [gpanders/editorconfig.nvim](https://github.com/gpanders/editorconfig.nvim) for exposing me to the `keepjumps`
-and `keeppatterns` modifiers