diff --git a/README.md b/README.md
new file mode 100644
index 0000000000000000000000000000000000000000..c9f508f5bf78f33165a184a5700a38cd8a82ef5b
--- /dev/null
+++ b/README.md
@@ -0,0 +1,68 @@
+# Intro
+Each cpp file is a standalone little program. The initial idea was to show that modern C++(just by itself and standard library) can be as "easy to use" as some higher level languages for certain simple tasks. That was a total failure, and I decided to cheat and move some of the code out into a few simple libraries, so while the programs here look more or less clear and concise and don't exceed 200 lines, they depend on some external code that does not... at all.
+
+Since these are file tools they all depend on [libsimple_file](https://github.com/namark/libsimple_file). Additional dependencies for each program (if any) are listed below.
+
+---
+
+## shred.cpp
+Splits a given file(s) into small pieces, generating a .info file(s) that can be used to reassemble them. You can specify the size of the pieces (in bytes) with the -s option, which affects all the files specified after it. The size can be specified several times in a single command. Use -- to prevent option parsing if it conflicts with your file name(s). <br />
+When run without parameters enters interactive mode, expecting a piece size followed by a list of files to "shred", input on spearate lines (not just separted with whitespace). To specify new size just input an empty line and the program will expect a size again. <br />
+Does not modify or delete the input files. <br />
+Any errors will likely terminate the program.
+
+**Additional dependencies** <br />
+[libsimple_support](https://github.com/namark/libsimple_support)
+
+---
+
+## glue.cpp
+Assembles a file(s) split by [shred](#shredcpp) program according to specified .info file(s). <br />
+When run without parameters enters interactive mode, expecting a list of .info files to "glue", input on spearate lines (not just separted with whitespace). <br />
+Does not modify or delete the input files or associated pieces. <br />
+Any errors will likely terminate the program.
+
+---
+
+## swap.cpp
+Look how easy it is to swap two files now! Please don't ever use this...
+
+---
+
+<br />
+<br />
+
+# Building and installation
+It's all in the makefile... but you'll need to install the dependencies manually. Make sure to use the latest stable compiler available to you, since that's what I do and have no idea what specific language or standard library features I relied on. I also primarily use GNU/linux based systems so no guarantee that the makefile won't spectacularly break for you, if you don't.
+
+Here is an example of installing all dependencies and building all programs.
+``` shell
+# get the project
+git clone https://github.com/namark/filetools
+
+# get the dependencies
+git clone https://github.com/namark/libsimple_file
+git clone https://github.com/namark/libsimple_support # for shred.cpp
+
+# install dependencies locally for this porject only
+cd libsimple_file
+make install PREFIX=../filetools
+cd ../libsimple_enum
+make install PREFIX=../filetools
+cd ../libsimple_support
+make install PREFIX=../filetools
+cd ..
+
+# remove repositories of the dependencies
+rm -rf libsimple_file libsimple_support
+
+# build the entire project
+cd filetools 
+make
+```
+After this you should have all the binaries available in ./out directory, and can install them anywhere with `make install`(by default /usr/local/bin/).
+
+Each .cpp file is compiled to(and installed as) a binary with the same name, prefixed with the letter f, without an extension. <br /> 
+For example `swap.cpp` will turn into `fswap`.
+
+