ns-usbloader-mobile/README.md

88 lines
3.7 KiB
Markdown

# 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.
[<img src="https://fdroid.gitlab.io/artwork/badge/get-it-on.png" alt="Get it on F-Droid" height="80">](https://f-droid.org/packages/com.blogspot.developersu.ns_usbloader)
<img src="fastlane/metadata/android/en-US/images/featureGraphic.png" alt="Application logo" width="500"/>
<img src="fastlane/metadata/android/en-US/images/phoneScreenshots/Screenshot_1.png" alt="screenshot-1" width="250"/> <img src="fastlane/metadata/android/en-US/images/phoneScreenshots/Screenshot_2.png" alt="screenshot-2" width="250"/>
Sometimes I add new posts about this project [on my home page](https://developersu.blogspot.com/search/label/NS-USBloader).
#### 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 11
* 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)
* Korean by [DDinghoya](https://github.com/DDinghoya")
#### TODO:
- [ ] Add tools to simplify translation process
- [ ] 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>
<a href="https://paypal.me/developersu" title="PayPal"><img src="https://www.paypalobjects.com/webstatic/mktg/Logo/pp-logo-100px.png" border="0" alt="PayPal Logo" /></a>
[Yandex.Money](https://money.yandex.ru/to/410014301951665)
*Please note! This is non-commercial application.