Skip to content

Commit bdfcc8b

Browse files
Update README.md
1 parent 6788b19 commit bdfcc8b

File tree

1 file changed

+34
-9
lines changed

1 file changed

+34
-9
lines changed

README.md

Lines changed: 34 additions & 9 deletions
Original file line numberDiff line numberDiff line change
@@ -1,20 +1,26 @@
11
![Screenshot_20210605-115657_VNC Viewer](https://user-images.githubusercontent.com/68287637/120882449-b4729680-c5f5-11eb-8a47-c452aefcc882.jpg "A Screenshot of ubuntu xfce showing some pre-installed apps")
2+
![stage](https://img.shields.io/badge/Status-Installable-green) ![badge2](https://img.shields.io/badge/App-Termux-green) ![badge3](https://img.shields.io/badge/Linux%20Distribution-UBUNTU-brightgreen) ![bagge4](https://img.shields.io/badge/Linux%20Distribution__version-21.04%20(hippo)-brightgreen)
23

34
# ubuntu-on-android
45
A tweaked ubuntu-21.04 with xfce4 runs on android with termux/proot-distro
56

6-
![stage](https://img.shields.io/badge/Status-Installable-green)
7+
> This means now you can install ubuntu like above screenshot right in your smartphone without destroying your phone with rooting
8+
> (let android and google live)
79
8-
its called `hippo`
10+
- codename -> `hippo`
911

1012
### A note before you try
1113
- As lot of it is preinstalled you can login and start right after you install
12-
- And its in early stages of building so things may look kind of bad (make sure to notice me if you find any in issues)
14+
- As this runs on termux so performence clearly depends on CPU, ram and storage read-write speed!
15+
- Don't try heavy apps unless you have a good device :)
16+
- And its in early stages of building so some things may look kind of bad or missing(make sure to notice me if you find any in issues)
1317
- If you have any issues or suggestions make sure i know at https://github.com/RandomCoderOrg/ubuntu-on-android/issue (create an issue)
1418

1519
# installation
1620
- first install termux from [termux.com](https://termux.com) or playstore!
1721
```bash
22+
# remove ubuntu-on-android folder if exists
23+
rm -rf ubuntu-on-android
1824
# install dependencies
1925
apt update; apt upgrade -y ; apt install -y pulseaudio proot-distro git -y
2026
# clone the code
@@ -25,24 +31,36 @@ bash install.sh
2531
# install
2632
proot-distro install hippo
2733
```
28-
## logging into hippo
34+
### logging into hippo
2935
```bash
3036
# run
3137
proot-distro login hippo
3238
```
33-
## starting vncserver
39+
### starting vncserver
40+
3441
```bash
3542
vncserver :1
3643
```
37-
## stoping vncserver
44+
This step start GUI like screenshot above
45+
it requires an app to see, its up to yourchoice but here are some recommended apps
46+
- [RealVnc](https://play.google.com/store/apps/details?id=com.realvnc.viewer.android&hl=en_IN&gl=US) avalible in playstore
47+
- [Nethunter KEX](https://store.nethunter.com/en/packages/com.offsec.nethunter.kex/)
48+
### stoping vncserver
3849
```bash
3950
vncserver --kill :1
4051
```
41-
## Logout from hippo :)
52+
> if you press `logout` button inside vnc no need to do this step
53+
### Logout from hippo :)
4254
```bash
4355
exit
4456
```
45-
### Default passwords
57+
58+
## 🔊 Audio
59+
If you cant hear audio from vnc then use this command by openning a new session in termux
60+
```bash
61+
pulseaudio --start --load-"module-native-protocol-tcp auuth-ip-acp=127.0.0.1 auth-anonymus=1" --exit-idle-time=1
62+
```
63+
## Default passwords
4664
`user` -> root
4765

4866

@@ -53,5 +71,12 @@ vnc password -> `ubuntu`
5371
you can change it by command `vncpasswd`
5472

5573
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)
74+
# Devolopers & credits
75+
Made with ❤️ from:
76+
DEV #0 -> [Saicharankandukuri](https://github.com/SaicharanKandukuri)
77+
78+
# Links to community
79+
- create an [issue](https://github.com/RandomCoderOrg/ubuntu-on-android/issues) if you want to make me create one!
80+
5681
## More updates comming soon👊.
57-
- Update to stable in 1 day
82+
- feel free to contribute to this repo :)

0 commit comments

Comments
 (0)