|
1 | | - |
2 | | - |
3 | | -<h1 align="Center">Ubuntu 21.04 On android</h1> |
4 | | -A tweaked ubuntu-21.04 with xfce4 runs on android with termux/proot-distro |
5 | | - |
6 | | -> This means now you can install ubuntu like above screenshot right in your smartphone without destroying your phone with rooting |
7 | | -
|
8 | | -| | | |
9 | | -|--|--| |
10 | | -|This project is |  | |
11 | | -|status|  | |
12 | | -|Maintainence status |  | |
13 | | -|Platform | **Android Termux App (proot `prtace()` )**| |
14 | | -| Linux Distribution |  | |
15 | | -|Community | [](https://discord.gg/y432PhPYCS) [](https://gitter.im/ubuntu-on-android/community?utm_source=badge&utm_medium=badge&utm_campaign=pr-badge&utm_content=badge) | |
16 | | -| Code quality & stats | [](https://www.codefactor.io/repository/github/randomcoderorg/ubuntu-on-android) | |
17 | | -- codename -> `udroid` |
18 | | - |
19 | | -<details> |
20 | | - <summary>Note & Disclaimer (Must read !)</summary> |
21 | | - |
22 | | -A note before you try |
23 | | -- As lot of it is preinstalled you can login and start right after you install |
24 | | -- As this runs on termux and on software rendering so performence clearly depends on CPU, ram and storage read-write speed! |
25 | | -- Don't try heavy apps unless you have a good device :) |
26 | | -- If you have any issues or suggestions make sure i know at https://github.com/RandomCoderOrg/ubuntu-on-android/issue (create an issue) |
27 | | - |
28 | | -> **Disclaimer** : |
29 | | -- i dont work with any company or organization of ubuntu or any third party sources took in making fs(for now). |
30 | | -- This project works by compliying to selinux android. and all aim of the project is just run linux on android without direct root with a twist and this project improves time by time with your support and motivation. |
31 | | -- the linux you trying to install from this repo is not fully functional in target space because of the selinux policies, and increasing requirement in linux requirements and also because project is set to run with `ptrace()` a low level access in android kernel |
32 | | -- Graphics performence is really bad cause proot and usage on VNC, we dont support any adoptation on improving it **for now** cause insufficient data on android (ping me in discord if you have any ideas or any codes on this) |
33 | | -- - **(Update)** see https://github.com/RandomCoderOrg/ubuntu-on-android/wiki/XWayland-in-proot to run smooth and fast session |
34 | | -- This project comes without warranties or data protection |
35 | | -</details> |
36 | | - |
37 | | -## supported architectures status |
| 1 | + |
| 2 | + |
| 3 | +<h2 align="Center">Ubuntu-21.04 on android</h2> |
| 4 | +Ubuntu-on-android aims to run ubuntu with pre-installed Desktop Environment, development tools, and software on top of android without root with the help of proot in termux application. This project just like any other linux on android projects but with aim of making it easy for end user on setting up linux. |
| 5 | + |
| 6 | + |
| 7 | + |
| 8 | +  |
| 9 | +[](https://discord.gg/y432PhPYCS) [](https://gitter.im/ubuntu-on-android/community?utm_source=badge&utm_medium=badge&utm_campaign=pr-badge&utm_content=badge)[](https://www.codefactor.io/repository/github/randomcoderorg/ubuntu-on-android) |
| 10 | + |
| 11 | +codename = `udroid` |
| 12 | + |
| 13 | + |
| 14 | + |
| 15 | +## Supported arch status |
38 | 16 | | arch | status | |
39 | 17 | |------ |--------| |
40 | 18 | | arm64 |  | |
41 | 19 | | armv7l |  | |
42 | 20 | | armv8l |  | |
43 | 21 | | Others | `not started` | |
44 | 22 |
|
45 | | -# Installation |
46 | | -- First install termux from [termux.com](https://termux.com) or [F-Droid!](https://f-droid.org/en/packages/com.termux/) |
47 | | - |
48 | | -## Getting Sources and install scripts |
49 | | -```bash |
50 | | -# download installer |
51 | | -curl -L -o install.sh https://git.io/hippo-installer |
52 | | -# run the installer |
53 | | -bash install.sh |
54 | | -# Install ubuntu with this command |
55 | | -udroid --install |
56 | | -``` |
57 | | -### Basic Usage |
58 | | - | **Command** | **Usage** | |
59 | | - |--------------------|-----------| |
60 | | - | `udroid` | To login to shell | |
61 | | - | `udroid upgrade` | to upgrade fs or to get new features if available | |
62 | | - | `startvnc` | start vncserver at port `1` (you can change default port by exporting env varaible `DEFAULT_VNC_PORT` to a port number) | |
63 | | - | `udroid stopvnc` | stop vncserver at given or default port `1` |
64 | | - | `udroid --enable-dbus` | To start udroid with dbus hack enabled | |
65 | | - | `udroid --enable-dbus-vnc` | To start vnc session with dbus hack enabled | |
66 | | - |
67 | | -## Environment Variables |
68 | | -- `DEFAULT_VNC_PORT` to set vnc port for scripts |
69 | | -- `HIPPO_BRANCH` to set custom branch for cloning code |
70 | | - |
71 | | -## 🔊 Audio |
72 | | -pulseaudio starts everytime you invoke start commands with `udroid` |
73 | | - |
74 | | -> You can start audio manually with this command |
75 | | -```bash |
76 | | -pulseaudio --start --load="module-native-protocol-tcp auth-ip-acl=127.0.0.1 auth-anonymous=1" --exit-idle-time=-1 |
77 | | -``` |
78 | | -## Default passwords |
79 | | - |
80 | | -| |password| |
81 | | -|--|--------| |
82 | | -| udroid user | `secret` | |
83 | | -|vncserver root | `secret` | |
84 | | - |
85 | | -## some Screenshots |
| 23 | +## Desclaimer |
| 24 | +Just before starting the installation, you can check [this.](https://github.com/GxmerSam/ubuntu-on-android/blob/modified/desclaimer.md) |
| 25 | + |
| 26 | +## Installation |
| 27 | +Installation, variables, sound and other things can be found [here.](https://github.com/GxmerSam/ubuntu-on-android/blob/modified/installation.md) |
| 28 | + |
| 29 | +## Some Screenshots |
86 | 30 |
|
| 31 | + |
87 | 32 |  |
88 | | - |
89 | | - |
90 | | - |
91 | | - |
92 | | - |
| 33 | + |
| 34 | +More can be found [here.](https://github.com/GxmerSam/ubuntu-on-android/blob/modified/showcase.md) |
93 | 35 |
|
94 | 36 | A small help from me if you want to build your own rootfs [wiki_page](https://github.com/RandomCoderOrg/ubuntu-on-android/wiki/commands-took-to-make-a-custom-rootfs) |
95 | 37 |
|
96 | | -# Devolopers & credits |
97 | | -Made with ❤️ from: |
| 38 | +## Devolopers & credits |
98 | 39 |
|
99 | | -DEV #0 -> [Saicharankandukuri](https://github.com/SaicharanKandukuri) |
| 40 | +DEV #0 = [Saicharankandukuri](https://github.com/SaicharanKandukuri) |
100 | 41 |
|
101 | | -Dev #1 -> [Gxmersam](https://github.com/GxmerSam) |
| 42 | +Dev #1 = [Gxmersam](https://github.com/GxmerSam) |
102 | 43 |
|
103 | | -# Licence |
| 44 | +## Licence |
104 | 45 | MIT |
105 | 46 | Copyright (c) 2021 Saicharan Kandukuri |
106 | 47 |
|
107 | | -<h2 align="center"> More Updates coming soon 💛</h2> |
| 48 | +<h2 align="center"> More Updates coming soon...</h2> |
108 | 49 |
|
109 | | -- feel free to contribute to this repo :) |
| 50 | +feel free to contribute to this repo. |
0 commit comments