Update README.md

README.md

@@ -1,2 +1,29 @@
-# freeotpexport
-FreeOTP qr code exporter in javascript
+# freeotp-export
+
+FreeOTP qrcode exporter app in javascript
+
+Backround: FreeOTP is a Google Authenticator compatible open source Android app, made by Red Hat. Available at https://play.google.com/store/apps/details?id=org.fedorahosted.freeotp .
+
+Google authenticator does not allow backuping the secrets with adb, to backup one needs a rooted phone. FreeOTP however allows adb backup. The backup file obviously can be restored to any android phone, but for easy transfer to other phones, you can create qr codes with this app. The app does all processing locally, no data is sent anywhere. 
+
+__Be sure to understand the security implications of backing up the secrets from the authenticator app, and writing them on your computer storage.__
+
+# Instructions
+
+Make an adb backup of FreeOTP, extract the backup file (details on how to do this are currenly left as an excercise for the reader). Open the tokens.xml file (path is apps/org.fedorahosted.freeotp/sp) with this app. Read the displayed qrcodes with the authenticator app on your other phone.
+
+The author has tested the app with current Google Chrome and Mozilla Firefox on Ubuntu 14.04 in September 2015.
+
+This app can be opened directly at https://cdn.rawgit.com/viljoviitanen/freeotp-export/master/export.html 
+
+An example tokens.xml file from FreeOTP is included with this repository.
+
+#Acknowledgements
+
+Based on https://github.com/philipsharp/FreeOTPDecoder (Apache license)
+
+Uses https://github.com/davidshimjs/qrcodejs (MIT license)
+
+# License
+
+Apache License, Version 2.0