diff --git a/README b/README
index e3b1dad2b..49071b4c9 100644
--- a/README
+++ b/README
@@ -1 +1,126 @@
-This is the directory of the Kiwix Android port.
\ No newline at end of file
+Kiwix is an offline reader for Web content. It's especially thought to
+make Wikipedia available offline.  This is done by reading the content
+of the project stored in a file format ZIM, a high compressed open
+format with additional meta-data.
+
+*********************************************************************
+************* COMPILATION INSTRUCTIONS FOR ANDROID ******************
+*********************************************************************
+
+Android is just an additional target but you can still build for
+Android only from a Linux or Mac (it cross-compiles).
+
+* ./autogen.sh
+
+* ./configure --disable-staticbins --disable-manager --disable-server --disable-launcher --disable-indexer --disable-installer --disable-searcher --disable-reader --disable-components --enable-android --enable-compileall
+
+* cd src/dependencies && make android-deps && cd -
+
+* cd android && ./build-android-with-native.py (If you have problem with aapt on a 64bits Linux, you might have to install 32 libsm on Ubuntu: lib32gcc1, lib32stdc++6, lib32z1)
+
+To install the newly created APK on your device, use the following script:
+./android/install-kiwix-on-device.sh
+
+== Android Custom App ==
+
+Android Custom App are single-content Kiwix-android clones. Those app
+are tied to a single content and CAN NOT open other zim file. As well,
+bundled zim files are not readable by the regular Kiwix app. Custom
+App have specific branding.
+
+Custom App are either compiled as embed (ZIM file is included in APK)
+or are accompanied by a ZIM file.
+
+* Embedded versions can be very large (while Play Store have a 50MB
+  limit)
+* Non-embedded versions are small (6MB) but require a companion ZIM file
+  which can be up to 2GB.
+* Companion file is a feature of the Play store.
+
+Steps to build a Custom App:
+
+0. Install following requirements
+
+1. Build your first APK
+
+* Generate your icon using `gen-std-icon.py logo-file.png lang_code`
+* Prepare your JSON file using the sample in the script
+* Choose your package name wisely.
+** org.kiwix.kiwixcustomXXXXXX
+** o not add levels. Do not use dash or underscores !
+** Use version_code: 1 at first
+* Build your APK with `gen-custom-android-build.py my-file.json`
+
+2. Go to the Developer Page on https://play.google.com/apps/publish
+and create a new Application and give it a name.
+
+3. Fill the Store listing section with decent information
+* App Title (30 chars)
+* App Short Description (80 chars)
+* App Description (4,000 chars)
+
+* Add 2 screenshots
+* Add the 512px icon
+* Add feature graphic (1024x500)
+
+* Select Application Type (Applications)
+* Select Category (Education|Books & Reference|Health & Fitness|...)
+* Select Content Rating (High Maturity|Medium Maturity|Low
+  Maturity|Everyone)
+* Add an email Address
+* Check the "Not submitting a privacy policy URL" box
+
+4. Go to Content Rating Tab
+* Fill the Questionnaire
+** Email address
+** Select category
+** Check "No" for each question
+* Hit Calculate rating
+* Hit Apply rating
+
+5. Go to Pricing & Distribution
+* Check "SELECT ALL COUNTRIES" box
+* Check "Content guidelines"
+* Check "US Export laws"
+
+6. Go to APK 
+* Go to Alpha Testing
+* Manage list of testers (Add
+  https://plus.google.com/communities/106410746144853739922)
+* Upload an APK (Use a proper APK (version 1 usually) with correct
+  package name)
+
+7. Build a second APK
+* Change version_code in JSON file
+* Rebuild
+
+8. Upload your second APK using the upload script:
+$GOOGLE_API_KEY=/home/xxx/google-api.p12
+$python3 ./upload-apk.py my-file.json`
+
+9. [whenever you feel the need to] Update Play Store listing using
+play-store script.
+
+To make an APK which embeds a ZIM file:
+* In the json file, add:
+    "embed_zim": true,
+* You might need to set up following env. variable:
+    _JAVA_OPTIONS="\"-Xmx4096m\" \"-Xms4096m\" \"-XX:MaxPermSize=4096m\""
+
+*********************************************************************
+*************************** CONTACT *********************************
+*********************************************************************
+
+Email: kiwix-developer@lists.sourceforge.net or contact@kiwix.org
+Jabber: kelson@kiwix.org
+IRC: #kiwix on irc.freenode.net
+
+You can use IRC web interface on http://chat.kiwix.org/
+
+More... http://www.kiwix.org/wiki/Communication
+
+*********************************************************************
+********************** LEGAL & DISCLAIMER ***************************
+*********************************************************************
+
+Read '../COPYING' file