diff --git a/huffman/README.md b/huffman/README.md
new file mode 100644
index 0000000..f3513fe
--- /dev/null
+++ b/huffman/README.md
@@ -0,0 +1,11 @@
+# Huffman
+the testfiles folder is unpopulated and not staged through gitignore, as it might contain large files.
+use the following command to populate it or create your own testfiles.
+
+dd if=/dev/urandom of=10K-random.img count=1K
+dd if=/dev/urandom of=10K-random.img count=1M
+
+...
+
+files with random bytes wont be able to be compressed byy much, that is normal.
+Instead try something like a text file. The LICENSE in the root of this repo for example.
diff --git a/huffman/bin/huffman b/huffman/bin/huffman
new file mode 100755
index 0000000..03ecade
Binary files /dev/null and b/huffman/bin/huffman differ