diff --git a/README.md b/README.md
new file mode 100644
index 0000000..c37667d
--- /dev/null
+++ b/README.md
@@ -0,0 +1,17 @@
+# Hexxy
+
+A modern alternative to `xxd` and `hexdump`
+
+Huge thanks to ![igoracmelo](https://github.com/igoracmelo/xx) for the idea and reference.
+The idea and code for colorizing xxd/hexdump output in a gradient format came from them.
+
+## Example usage
+```sh
+hexxy /path/to/file.bin
+# dont output with color
+hexxy --no-color /path/to/file.bin
+# refer to multiple files
+hexxy file1 file2 file3
+# read from stdin
+cat mybinary | hexxy
+```