ns-usbloader-mobile/README.md

# NS-USBloader mobile

![License](https://img.shields.io/badge/License-GPLv3+-blue.svg) [![Releases](https://img.shields.io/github/downloads/developersu/ns-usbloader-mobile/total.svg)]() [![LatestVer](https://img.shields.io/github/release/developersu/ns-usbloader-mobile.svg)]()

NS-USBloader mobile is Android implementation of the [original NS-USBloader](https://github.com/developersu/ns-usbloader). 

Please note: You will need USB-OTG cable. Otherwise, you'll be charging phone.

Sometimes I add new posts about this project [on my home page](https://developersu.blogspot.com/search/label/NS-USBloader).

<img src="fastlane/metadata/android/en-US/images/featureGraphic.png" alt="Application logo" width="500"/>

<img src="fastlane/metadata/android/en-US/phoneScreenshots/Screenshot_1.png" alt="screenshot-1" width="250"/>  <img src="fastlane/metadata/android/en-US/phoneScreenshots/Screenshot_2.png" alt="screenshot-2" width="250"/>

#### License

Source code license [GNU General Public License v3](https://github.com/developersu/ns-usbloader-mobile/blob/master/LICENSE) or any later version.

Logo font: [Play](https://fonts.google.com/specimen/Play) by Jonas Hecksher. Open Font License distribution.


### System requirements

* Minimum: Android 4.0 (Ice Cream Sandwich)
* Maximum: Android 10.0 (Q)
* USB-OTG support / WiFi

### Usage

#### USB

1. Open Awoo Installer/Tinfoil/GoldLeaf v0.5
2. Connect NS to Android device using OTG cable.
3. Allow interaction request. Application opens.
4. Click 'hamburger' menu-button and select application you'd like to use.
5. Select NSP on your device. One-by-one each time clicking on button (I know it's not perfect)
6. Click upload button.

Note: use short usb cable.

#### WiFi

For installation over the Net (Tinfoil):
1. Connect to WiFi
2. Setup 90DNS or whatever you use
3. Open Awoo Installer, select installation over the net
4. Open settings (click 'hamburger' menu-button), enter NS IP you see on the screen

#### Bugs

If you're Samsung owner, it would be better to not rotating your phone during transfer. Or minimizing. Well, on my elder device it causes application failure. But you can try if you're curious, and report/update a bug. Please mention your device model. 

### Other notes

'Status' = 'Uploaded' that appears in the table does not mean that file has been installed. It means that it has been sent to NS without any issues! That's what this app about. 
Handling successful/failed installation is a purpose of the other side application: TinFoil/GoldLeaf v0.5. And they don't provide any feedback interfaces so I can't detect success/failure.

#### Contributors and Translators

* Thanks [Huang YunKun](https://github.com/htynkn) for various contributions!

* Traditional Chinese by [qazrfv1234](https://github.com/qazrfv1234)
* Simplified Chinese by FFT9 (XXGAME GROUP)(http://www.xxgame.net)
* Italian by [IvanMazzoli](https://github.com/IvanMazzoli)

#### TODO:

- [ ] Add tools to simplify translation process
- [ ] Better UI
- [ ] Multi-select files (if possible)

#### Support this app

If you like this app, just give a star. 

If you want to make a donation*, refer to this page:

<a href="https://liberapay.com/developersu/donate"><img alt="Donate using Liberapay" src="https://liberapay.com/assets/widgets/donate.svg"></a>

[Yandex.Money](https://money.yandex.ru/to/410014301951665)

[PayPal](https://paypal.me/developersu)

* Please note! This is non-commercial application.
First commit 2019-07-10 04:37:52 +03:00			`# NS-USBloader mobile`

Update readme, update metadata to match fastlane's file-format 2020-08-05 23:56:26 +03:00			`![License](https://img.shields.io/badge/License-GPLv3+-blue.svg) [![Releases](https://img.shields.io/github/downloads/developersu/ns-usbloader-mobile/total.svg)]() [![LatestVer](https://img.shields.io/github/release/developersu/ns-usbloader-mobile.svg)]()`
First commit 2019-07-10 04:37:52 +03:00
			`NS-USBloader mobile is Android implementation of the [original NS-USBloader](https://github.com/developersu/ns-usbloader).`

Fix readme. 2019-07-10 06:57:31 +03:00			`Please note: You will need USB-OTG cable. Otherwise, you'll be charging phone.`

First commit 2019-07-10 04:37:52 +03:00			`Sometimes I add new posts about this project [on my home page](https://developersu.blogspot.com/search/label/NS-USBloader).`

Update screenshots 2020-10-11 17:37:54 +03:00			`<img src="fastlane/metadata/android/en-US/images/featureGraphic.png" alt="Application logo" width="500"/>`

			`<img src="fastlane/metadata/android/en-US/phoneScreenshots/Screenshot_1.png" alt="screenshot-1" width="250"/> <img src="fastlane/metadata/android/en-US/phoneScreenshots/Screenshot_2.png" alt="screenshot-2" width="250"/>`
First commit 2019-07-10 04:37:52 +03:00
			`#### License`

Tinfoil network transfer support Change progress bar behavior. Add settings. Add NCZ/XCI/XCZ 'support' (Fix bug #1). Make IntentService foreground service. 2020-03-23 20:33:17 +03:00			`Source code license [GNU General Public License v3](https://github.com/developersu/ns-usbloader-mobile/blob/master/LICENSE) or any later version.`
First commit 2019-07-10 04:37:52 +03:00
			`Logo font: [Play](https://fonts.google.com/specimen/Play) by Jonas Hecksher. Open Font License distribution.`


			`### System requirements`

			`* Minimum: Android 4.0 (Ice Cream Sandwich)`
Fix readme. 2019-07-10 06:57:31 +03:00			`* Maximum: Android 10.0 (Q)`
Tinfoil network transfer support Change progress bar behavior. Add settings. Add NCZ/XCI/XCZ 'support' (Fix bug #1). Make IntentService foreground service. 2020-03-23 20:33:17 +03:00			`* USB-OTG support / WiFi`
First commit 2019-07-10 04:37:52 +03:00
			`### Usage`

Tinfoil network transfer support Change progress bar behavior. Add settings. Add NCZ/XCI/XCZ 'support' (Fix bug #1). Make IntentService foreground service. 2020-03-23 20:33:17 +03:00			`#### USB`

			`1. Open Awoo Installer/Tinfoil/GoldLeaf v0.5`
First commit 2019-07-10 04:37:52 +03:00			`2. Connect NS to Android device using OTG cable.`
			`3. Allow interaction request. Application opens.`
			`4. Click 'hamburger' menu-button and select application you'd like to use.`
			`5. Select NSP on your device. One-by-one each time clicking on button (I know it's not perfect)`
			`6. Click upload button.`

			`Note: use short usb cable.`

Tinfoil network transfer support Change progress bar behavior. Add settings. Add NCZ/XCI/XCZ 'support' (Fix bug #1). Make IntentService foreground service. 2020-03-23 20:33:17 +03:00			`#### WiFi`

			`For installation over the Net (Tinfoil):`
			`1. Connect to WiFi`
			`2. Setup 90DNS or whatever you use`
			`3. Open Awoo Installer, select installation over the net`
			`4. Open settings (click 'hamburger' menu-button), enter NS IP you see on the screen`

First commit 2019-07-10 04:37:52 +03:00			`#### Bugs`

			`If you're Samsung owner, it would be better to not rotating your phone during transfer. Or minimizing. Well, on my elder device it causes application failure. But you can try if you're curious, and report/update a bug. Please mention your device model.`

			`### Other notes`

			`'Status' = 'Uploaded' that appears in the table does not mean that file has been installed. It means that it has been sent to NS without any issues! That's what this app about.`
Version increment. Add contributors section to 'About' page. Add changelogs to 'fastlane' folder for.. whatever reason. 2020-10-22 23:24:31 +03:00			`Handling successful/failed installation is a purpose of the other side application: TinFoil/GoldLeaf v0.5. And they don't provide any feedback interfaces so I can't detect success/failure.`
First commit 2019-07-10 04:37:52 +03:00
Version increment. Add contributors section to 'About' page. Add changelogs to 'fastlane' folder for.. whatever reason. 2020-10-22 23:24:31 +03:00			`#### Contributors and Translators`
Add new non-translated line for translators. Update readme, correct files with translations a bit. Increment version :) 2020-09-20 15:25:50 +03:00
Version increment. Add contributors section to 'About' page. Add changelogs to 'fastlane' folder for.. whatever reason. 2020-10-22 23:24:31 +03:00			`* Thanks [Huang YunKun](https://github.com/htynkn) for various contributions!`
Add new non-translated line for translators. Update readme, correct files with translations a bit. Increment version :) 2020-09-20 15:25:50 +03:00
Version increment. Add contributors section to 'About' page. Add changelogs to 'fastlane' folder for.. whatever reason. 2020-10-22 23:24:31 +03:00			`* Traditional Chinese by [qazrfv1234](https://github.com/qazrfv1234)`
			`* Simplified Chinese by FFT9 (XXGAME GROUP)(http://www.xxgame.net)`
			`* Italian by [IvanMazzoli](https://github.com/IvanMazzoli)`
Added Italian translation 2020-10-14 11:13:18 +03:00
First commit 2019-07-10 04:37:52 +03:00			`#### TODO:`

Update README.md Add metadata 2020-08-05 05:12:33 +03:00			`- [ ] Add tools to simplify translation process`
First commit 2019-07-10 04:37:52 +03:00			`- [ ] Better UI`
			`- [ ] Multi-select files (if possible)`

			`#### Support this app`

			`If you like this app, just give a star.`

			`If you want to make a donation*, refer to this page:`

Update README.md Add metadata 2020-08-05 05:12:33 +03:00			`<a href="https://liberapay.com/developersu/donate"><img alt="Donate using Liberapay" src="https://liberapay.com/assets/widgets/donate.svg"></a>`

First commit 2019-07-10 04:37:52 +03:00			`[Yandex.Money](https://money.yandex.ru/to/410014301951665)`

Fix readme #2 2019-07-10 18:15:51 +03:00			`[PayPal](https://paypal.me/developersu)`
First commit 2019-07-10 04:37:52 +03:00
Update README.md Add metadata 2020-08-05 05:12:33 +03:00			`* Please note! This is non-commercial application.`