xmrwallet/README.md

# Monerujo
Another Android Monero Wallet

### QUICKSTART
- Download the APK for the most current release [here](https://github.com/m2049r/xmrwallet/releases) and install it
- Run the App and select "Generate Wallet" to create a new wallet or recover a wallet
- Advanced users can copy over synced wallet files (all files) onto sdcard in directory Monerujo (created first time App is started)
- See the [FAQ](doc/FAQ.md)

### Disclaimer
You may lose all your Moneroj if you use this App. Be cautious when spending on the mainnet.

### Random Notes
- Based off monero v0.11.0.0 with PR #2289 applied
- currently only android32 (runs on 64-bit as well)
- works on the testnet & mainnet
- sync is slow due to 32-bit architecture
- use your own daemon - it's easy
- screen stays on until first sync is complete
- saves wallet only on first sync and when sending transactions or editing notes
- Monerujo means "Monero Wallet" according to https://www.reddit.com/r/Monero/comments/3exy7t/esperanto_corner/

### TODO
- more sensible error dialogs

### Issues / Pitfalls
- The backups folder is now called "backups" and not ".backups" - which in most file explorers was a hidden folder
- Wallets are now created directly in the "monerujo" folder, and not in the ".new" folder as before
- You may want to check the old folders with a file browsing app and delete the ".new" and ".backups" folders AFTER moving neccessary wallet files to the new locations. Or simply make new backups from within Monerujo.
- Also note, that on some devices the backups will only be visible on a PC over USB after a reboot of the device (it's an Android bug/feature)
- Created wallets on a private testnet are unusable because the restore height is set to that
of the "real" testnet.  After creating a new wallet, make a **new** one by recovering from the seed.
The official monero client shows the same behaviour.

### HOW TO BUILD
No need to build. Binaries are included:

- openssl-1.0.2l
- monero-v0.11.0.0 + pull requests #2289
- boost_1_64_0

If you want to build them yourself (recommended) check out [the instructions](doc/BUILDING-external-libs.md)

Then, fire up Android Studio and build the APK.

### Donations
- Address: 4AdkPJoxn7JCvAby9szgnt93MSEwdnxdhaASxbTBm6x5dCwmsDep2UYN4FhStDn5i11nsJbpU7oj59ahg8gXb1Mg3viqCuk
- Viewkey: b1aff2a12191723da0afbe75516f94dd8b068215f6e847d8da57aca5f1f98e0c
save prefs async wallet load / close by service wakelock & async loading / closing looks good progress indicator ode cleanup added license boilerplates 2017-08-02 07:39:38 -06:00			`# Monerujo`
			`Another Android Monero Wallet`

			`### QUICKSTART`
Making a few small changes to the readme Added a link to the release page corrected a few small spelling and grammatical errors 2017-09-06 22:27:49 -06:00			`- Download the APK for the most current release [here](https://github.com/m2049r/xmrwallet/releases) and install it`
cleanup + docs 2017-08-20 08:18:59 -06:00			`- Run the App and select "Generate Wallet" to create a new wallet or recover a wallet`
Making a few small changes to the readme Added a link to the release page corrected a few small spelling and grammatical errors 2017-09-06 22:27:49 -06:00			`- Advanced users can copy over synced wallet files (all files) onto sdcard in directory Monerujo (created first time App is started)`
			`- See the [FAQ](doc/FAQ.md)`
save prefs async wallet load / close by service wakelock & async loading / closing looks good progress indicator ode cleanup added license boilerplates 2017-08-02 07:39:38 -06:00
			`### Disclaimer`
Making a few small changes to the readme Added a link to the release page corrected a few small spelling and grammatical errors 2017-09-06 22:27:49 -06:00			`You may lose all your Moneroj if you use this App. Be cautious when spending on the mainnet.`
save prefs async wallet load / close by service wakelock & async loading / closing looks good progress indicator ode cleanup added license boilerplates 2017-08-02 07:39:38 -06:00
Create BUILDING-external-libs.md Update README.md 2017-08-14 02:05:28 -06:00			`### Random Notes`
Upgrade to monero v0.11.0.0 (#50) 2017-09-08 16:37:12 -06:00			`- Based off monero v0.11.0.0 with PR #2289 applied`
updated version number + docs 2017-08-29 15:00:07 -06:00			`- currently only android32 (runs on 64-bit as well)`
Making a few small changes to the readme Added a link to the release page corrected a few small spelling and grammatical errors 2017-09-06 22:27:49 -06:00			`- works on the testnet & mainnet`
new version (#91) 2017-09-29 11:21:11 -06:00			`- sync is slow due to 32-bit architecture`
save prefs async wallet load / close by service wakelock & async loading / closing looks good progress indicator ode cleanup added license boilerplates 2017-08-02 07:39:38 -06:00			`- use your own daemon - it's easy`
			`- screen stays on until first sync is complete`
cleanup + docs 2017-08-20 08:18:59 -06:00			`- saves wallet only on first sync and when sending transactions or editing notes`
Create BUILDING-external-libs.md Update README.md 2017-08-14 02:05:28 -06:00			`- Monerujo means "Monero Wallet" according to https://www.reddit.com/r/Monero/comments/3exy7t/esperanto_corner/`
save prefs async wallet load / close by service wakelock & async loading / closing looks good progress indicator ode cleanup added license boilerplates 2017-08-02 07:39:38 -06:00
			`### TODO`
updated version number + docs 2017-08-29 15:00:07 -06:00			`- more sensible error dialogs`
save prefs async wallet load / close by service wakelock & async loading / closing looks good progress indicator ode cleanup added license boilerplates 2017-08-02 07:39:38 -06:00
Docs updated for 0.7 and bugfixes (#55) * docs and version * wallet failed message moved to UI thread * display balance in pure white 2017-09-10 12:04:21 -06:00			`### Issues / Pitfalls`
Fixup wallet locations (#89) * create wallets directly in wallet dir, renamed backup dir * new version + notes 2017-09-27 15:01:37 -06:00			`- The backups folder is now called "backups" and not ".backups" - which in most file explorers was a hidden folder`
			`- Wallets are now created directly in the "monerujo" folder, and not in the ".new" folder as before`
			`- You may want to check the old folders with a file browsing app and delete the ".new" and ".backups" folders AFTER moving neccessary wallet files to the new locations. Or simply make new backups from within Monerujo.`
			`- Also note, that on some devices the backups will only be visible on a PC over USB after a reboot of the device (it's an Android bug/feature)`
Docs updated for 0.7 and bugfixes (#55) * docs and version * wallet failed message moved to UI thread * display balance in pure white 2017-09-10 12:04:21 -06:00			`- Created wallets on a private testnet are unusable because the restore height is set to that`
			`of the "real" testnet. After creating a new wallet, make a new one by recovering from the seed.`
			`The official monero client shows the same behaviour.`
save prefs async wallet load / close by service wakelock & async loading / closing looks good progress indicator ode cleanup added license boilerplates 2017-08-02 07:39:38 -06:00
			`### HOW TO BUILD`
			`No need to build. Binaries are included:`

			`- openssl-1.0.2l`
Update README.md 2017-09-12 15:48:01 -06:00			`- monero-v0.11.0.0 + pull requests #2289`
save prefs async wallet load / close by service wakelock & async loading / closing looks good progress indicator ode cleanup added license boilerplates 2017-08-02 07:39:38 -06:00			`- boost_1_64_0`

Create BUILDING-external-libs.md Update README.md 2017-08-14 02:05:28 -06:00			`If you want to build them yourself (recommended) check out [the instructions](doc/BUILDING-external-libs.md)`

			`Then, fire up Android Studio and build the APK.`
Update README.md 2017-08-20 16:22:57 -06:00
			`### Donations`
updated version number + docs 2017-08-29 15:00:07 -06:00			`- Address: 4AdkPJoxn7JCvAby9szgnt93MSEwdnxdhaASxbTBm6x5dCwmsDep2UYN4FhStDn5i11nsJbpU7oj59ahg8gXb1Mg3viqCuk`
Making a few small changes to the readme Added a link to the release page corrected a few small spelling and grammatical errors 2017-09-06 22:27:49 -06:00			`- Viewkey: b1aff2a12191723da0afbe75516f94dd8b068215f6e847d8da57aca5f1f98e0c`