2 files changed, 47 insertions, 27 deletions

diff --git a/README b/README
deleted file mode 100644
index c72d9da..0000000
--- a/README
+++ /dev/null
@@ -1,27 +0,0 @@
---------------------------------------------------------------------------------

-Heimdall (c) 2010-2014 Benjamin Dobell, Glass Echidna

-http://www.glassechidna.com.au/products/heimdall/

-

-DISCLAIMER:

-

-    This software attempts to flash your Galaxy S device. The very nature of

-    flashing is dangerous. As with all flashing software, Heimdall has the

-    potential to damage (brick) your phone if not used carefully. If you're

-    concerned, don't use this software. Flashing ROMs onto your phone may also

-    void your warranty. Benjamin Dobell and Glass Echidna are not responsible

-    for the result of your actions.

-

---------------------------------------------------------------------------------

-

-For more details about how to compile and install Heimdall please refer to the

-appropriate platform specific README:

-

-- Linux:

-  Linux/README

-

-- OS X

-  OSX/README.txt

-

-- Windows

-  Win32/README.txt

-

diff --git a/README.md b/README.md
new file mode 100644
index 0000000..01bac21
--- /dev/null
+++ b/README.md
@@ -0,0 +1,47 @@
+# Heimdall
+
+Heimdall is a cross-platform open-source tool suite used to flash firmware (aka ROMs) onto Samsung mobile devices.
+
+## Supported Platforms
+
+Officially, AMD64/x86-64 (64-bit) or x86 (32-bit) computers running:
+
+ * Linux
+ * macOS
+ * Windows (XP, Vista, 7 etc.)
+
+However, several third-parties have reported success running Heimdall on ARM chipsets
+(in particular Raspberry Pi), as well as additional operating systems such as FreeBSD.
+
+## How does Heimdall work?
+
+Heimdall connects to a mobile device over USB and interacts with low-level software
+running on device, known as Loke. Loke and Heimdall communicate via the custom
+Samsung-developed protocol typically referred to as the 'Odin 3 protocol'.
+
+USB communication in Heimdall is handled by the popular open-source USB library, [libusb](http://libusb.info).
+
+## Free & Open Source
+
+Heimdall is both free and open source. It is licensed under the MIT license (see LICENSE).
+
+Heimdall is maintained and predominantly developed by [Glass Echidna](http://glassechidna.com.au/),
+a _tiny_ independent software development company. If you appreciate our work and would like
+to support future development please consider making a [donation](http://glassechidna.com.au/donate/).
+
+## Documentation
+
+For more details about how to compile and install Heimdall please refer to the
+appropriate platform specific README:
+
+#### Linux
+
+ - Linux/README ([online](https://raw.githubusercontent.com/Benjamin-Dobell/Heimdall/master/Linux/README))
+
+#### OS X
+
+ - OSX/README.txt ([online](https://raw.githubusercontent.com/Benjamin-Dobell/Heimdall/master/OSX/README.txt))
+
+#### Windows
+
+ - Win32/README.txt ([online](https://raw.githubusercontent.com/Benjamin-Dobell/Heimdall/master/Win32/README.txt))