/ubports-installer

A simple tool to install Ubuntu Touch on UBports devices
  1. JavaScript 57.0%
  2. HTML 37.5%
  3. CSS 5.1%
  4. Shell 0.4%
JavaScript HTML CSS Shell
Clone or download

Clone with HTTPS

Use Git or checkout with SVN using the web URL.

Open in Desktop Download ZIP
Find file
Switch branches/tags
Nothing to show
Latest commit 59751f0 Jan 1, 2018 @NeoTheThird NeoTheThird Merge pull request #69 from ubports/Flohack74-maintenance 
Fix percentage text
Permalink
Failed to load latest commit information.
bin Add snap support Feb 15, 2017
build/icons Build snap (fixes #14) and deb (fixes #13), and fix icons Sep 13, 2017
snap Bump version number Dec 10, 2017
snapcraft Fixed casing Nov 1, 2017
src Fix percentage text Jan 1, 2018
.gitignore Add packagin for all platforms and add travis + general fixes Mar 10, 2017
.travis.yml Try using whildcard to for travis deploy files Sep 23, 2017
Jenkinsfile Updated Jenkinsfile Sep 13, 2017
LICENSE Initial commit Feb 8, 2017
README.md Use --edge to install the snap Dec 5, 2017
TODO Add todo Mar 12, 2017
appveyor.yml Allow appvayor to publish on other branches than master Mar 12, 2017
build.js Fix percentage text Jan 1, 2018
cli.js Fix percentage text Jan 1, 2018
package.json Bump version number Dec 10, 2017
setup-dev.sh Add packagin for all platforms and add travis + general fixes Mar 10, 2017

README.md

UBports Installer

Build Status Build status Coverage Status

This tool is still under development, bugreports are appreciated.

How to install

Linux:

Snap:

  1. Open a terminal
  2. Run sudo snap install ubports-installer --edge --devmode to install
  3. Run ubports-installer or select the icon in your application list to start the program

Deb:

  1. Download the latest deb from https://github.com/ubports/ubports-installer/releases
  2. Open the deb package with your software installation tool and follow the on-screen instructions
  3. Launch the program from your application list.

Appimage:

  1. Download the latest Appimage from https://github.com/ubports/ubports-installer/releases
  2. Make the AppImage executable
  3. Then run the file by double-clicking

Mac

  1. Download the latest dmg file from https://github.com/ubports/ubports-installer/releases
  2. Open the file and follow the onscreen instructions.
  3. Launch the program from the application list.

Windows

  1. Download the latest exe file from https://github.com/ubports/ubports-installer/releases
  2. Open the file and follow the onscreen instructions
  3. Launch the program from your application list.

You might have to install the windows/android/adb drivers required for your device.

How to run the program from source

git clone https://github.com/ubports/ubports-installer.git
cd ubports-installer
./setup-dev.sh

How to start GUI

npm start

How to use CLI

Please note that the command line interface was created for testing purposes only and does not necessarily try to be user-friendly.

$ ./cli.js

Usage: cli [options]

Options:

  -h, --help               output usage information
  -V, --version            output the version number
  -d, --device <device>    Specify device
  -c, --channel <channel>  Specify channel (default: ubuntu-touch/stable)
  -v, --verbose            Verbose output
  -b, --bootstrap          Flash boot and recovery from bootloader

Troubleshooting

Prerequisites: udev rules:

  1. See if cat /etc/udev/rules.d/51-android.rules exists and contains the following rules:
SUBSYSTEM=="usb", ATTRS{idVendor}=="0bb4", MODE="0666", GROUP="plugdev"
SUBSYSTEM=="usb", ATTRS{idVendor}=="0e79", MODE="0666", GROUP="plugdev"  
SUBSYSTEM=="usb", ATTRS{idVendor}=="0502", MODE="0666", GROUP="plugdev"  
SUBSYSTEM=="usb", ATTRS{idVendor}=="0b05", MODE="0666", GROUP="plugdev"  
SUBSYSTEM=="usb", ATTRS{idVendor}=="413c", MODE="0666", GROUP="plugdev"  
SUBSYSTEM=="usb", ATTRS{idVendor}=="0489", MODE="0666", GROUP="plugdev"  
SUBSYSTEM=="usb", ATTRS{idVendor}=="091e", MODE="0666", GROUP="plugdev"  
SUBSYSTEM=="usb", ATTRS{idVendor}=="18d1", MODE="0666", GROUP="plugdev"  
SUBSYSTEM=="usb", ATTRS{idVendor}=="0bb4", MODE="0666", GROUP="plugdev"  
SUBSYSTEM=="usb", ATTRS{idVendor}=="12d1", MODE="0666", GROUP="plugdev"  
SUBSYSTEM=="usb", ATTRS{idVendor}=="24e3", MODE="0666", GROUP="plugdev"  
SUBSYSTEM=="usb", ATTRS{idVendor}=="2116", MODE="0666", GROUP="plugdev"  
SUBSYSTEM=="usb", ATTRS{idVendor}=="0482", MODE="0666", GROUP="plugdev"  
SUBSYSTEM=="usb", ATTRS{idVendor}=="17ef", MODE="0666", GROUP="plugdev"  
SUBSYSTEM=="usb", ATTRS{idVendor}=="1004", MODE="0666", GROUP="plugdev"  
SUBSYSTEM=="usb", ATTRS{idVendor}=="22b8", MODE="0666", GROUP="plugdev"    
SUBSYSTEM=="usb", ATTRS{idVendor}=="0409", MODE="0666", GROUP="plugdev"  
SUBSYSTEM=="usb", ATTRS{idVendor}=="2080", MODE="0666", GROUP="plugdev"  
SUBSYSTEM=="usb", ATTRS{idVendor}=="0955", MODE="0666", GROUP="plugdev"  
SUBSYSTEM=="usb", ATTRS{idVendor}=="2257", MODE="0666", GROUP="plugdev"  
SUBSYSTEM=="usb", ATTRS{idVendor}=="10a9", MODE="0666", GROUP="plugdev"  
SUBSYSTEM=="usb", ATTRS{idVendor}=="1d4d", MODE="0666", GROUP="plugdev"  
SUBSYSTEM=="usb", ATTRS{idVendor}=="0471", MODE="0666", GROUP="plugdev"  
SUBSYSTEM=="usb", ATTRS{idVendor}=="04da", MODE="0666", GROUP="plugdev"  
SUBSYSTEM=="usb", ATTRS{idVendor}=="05c6", MODE="0666", GROUP="plugdev"  
SUBSYSTEM=="usb", ATTRS{idVendor}=="1f53", MODE="0666", GROUP="plugdev"  
SUBSYSTEM=="usb", ATTRS{idVendor}=="04e8", MODE="0666", GROUP="plugdev"  
SUBSYSTEM=="usb", ATTRS{idVendor}=="04dd", MODE="0666", GROUP="plugdev"  
SUBSYSTEM=="usb", ATTRS{idVendor}=="0fce", MODE="0666", GROUP="plugdev"  
SUBSYSTEM=="usb", ATTRS{idVendor}=="0930", MODE="0666", GROUP="plugdev"  
SUBSYSTEM=="usb", ATTRS{idVendor}=="19d2", MODE="0666", GROUP="plugdev"
SUBSYSTEM=="usb", ATTRS{idVendor}=="2ae5", MODE="0666", GROUP="plugdev"

2a. If this file does not exist or has not all the rules inside, create it as su or add accordingly. 2b. Also check if other files contain similar rules 3. Restart udev daemon by issuing sudo service udev restart