Go to file
2018-10-04 10:48:45 -07:00
.circleci Remove coverage argument. 2018-09-24 13:45:50 -07:00
.github/ISSUE_TEMPLATE Update issue templates 2018-07-19 13:42:15 -07:00
.idea Update filtering and remove byte copies. 2018-08-31 11:28:35 -07:00
app Removed variable in place of raw boolean to improve readability. 2018-10-04 10:48:45 -07:00
gradle/wrapper Template project 2018-04-25 15:08:51 -07:00
play_store put up some assets used in our play store listing 2018-06-19 12:24:48 -07:00
_config.yml Set theme jekyll-theme-hacker 2018-06-14 21:30:32 -07:00
.DS_Store another hotfix attemp for crash on start 2018-08-04 22:46:49 -07:00
.gitignore Ignore all idea files. 2018-06-06 10:17:24 -07:00
build.gradle Remove coverage reporting. 2018-07-27 12:22:40 -07:00
CNAME Create CNAME 2018-06-14 21:19:53 -07:00
CODE_OF_CONDUCT.md Create CODE_OF_CONDUCT.md 2018-07-16 11:00:00 -07:00
CONTRIBUTING.md fix the link to CODE_OF_CONDUCT.md 2018-09-04 09:17:43 -07:00
gradle.properties Template project 2018-04-25 15:08:51 -07:00
gradlew Template project 2018-04-25 15:08:51 -07:00
gradlew.bat Template project 2018-04-25 15:08:51 -07:00
LICENSE Create LICENSE 2018-03-20 14:18:56 -07:00
PULL_REQUEST_TEMPLATE.md Create PULL_REQUEST_TEMPLATE.md 2018-07-13 15:42:37 -07:00
README.md Update README.md 2018-08-22 12:20:09 -07:00
settings.gradle Template project 2018-04-25 15:08:51 -07:00

UserLAnd Feature Graphic

Welcome to UserLAnd

The easiest way to run a Linux distribution or application on Android.
Features:

  • Run full linux distros or specific applications on top of Android.
  • Install and uninstall like a regular app.
  • No root required.

How to get started:

  1. Define a session - This describes what filesystem you are going to use, what server you want to run (ssh or vnc), and how you want to connect to it (ConnectBot or bVNC).
  2. Define a filesystem while defining a session - This describes what distro or application you want to install (only supports debian, but more coming soon).
  3. Once defined, just tap on the session to start up. This will download necessary assets, setup the filesystem, start the server, and connect to it. This will take several minutes for the first start up, but will be quicker afterwards.

A normal first session might look like this:

  • sudo apt update <- sudo or su because you are not fake root initially, update because you need to do this
  • sudo apt install wget <- install whatever you want to use
  • wget http://google.com <- use it

But, you can do so much more than that...your phone is not just a play thing anymore.

This app is fully open source. You can find our code and file issues here.

The assets that UserLAnd depends on and the scripts that build them are contained in other repositories.

The common assets that are used for all distros and application are found at CypherpunkArmory/UserLAnd-Assets-Support.

Distribution or application specific assets are found under CypherpunkArmory/UserLAnd-Assets-(Distribution/App). For example, our Debian specific assets can be found at CypherpunkArmory/UserLAnd-Assets-Debian