Skip to content

Commit e13fb8e

Browse files
SaicharanKandukurigitbook-bot
authored andcommitted
GitBook: [#2] change layout and some emojis
1 parent a2924ff commit e13fb8e

File tree

4 files changed

+89
-4
lines changed

4 files changed

+89
-4
lines changed

README.md

Lines changed: 5 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -1,4 +1,4 @@
1-
# README
1+
# 🐧 udroid
22

33
![an rendered image showing udroid ubuntu mate desktop environment running on smartphone ](<.gitbook/assets/banner (1).jpg>)
44

@@ -40,8 +40,12 @@ A small help from me if you want to build your own rootfs [wiki\_page](https://g
4040

4141
DEV #0 = [Saicharankandukuri](https://github.com/SaicharanKandukuri)
4242

43+
{% embed url="https://github.com/SaicharanKandukuri" %}
44+
4345
Dev #1 = [Gxmersam](https://github.com/GxmerSam)
4446

47+
{% embed url="https://github.com/GxmerSam" %}
48+
4549
### License
4650

4751
MIT Copyright (c) 2021 Saicharan Kandukuri

SUMMARY.md

Lines changed: 5 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -1,4 +1,7 @@
11
# Table of contents
22

3-
* [README](README.md)
4-
* [Disclaimer](disclaimer.md)
3+
## 🛸 udroid-landing
4+
5+
* [🐧 udroid](README.md)
6+
* [📖 Quick Installation and usage](udroid-landing/udroid/quick-installation-and-usage.md)
7+
* [👀 Disclaimer](udroid-landing/udroid/disclaimer.md)
Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -1,4 +1,4 @@
1-
# Disclaimer
1+
# 👀 Disclaimer
22

33

44

Lines changed: 78 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,78 @@
1+
---
2+
description: quick installation guide
3+
---
4+
5+
# 📖 Quick Installation and usage
6+
7+
### Installation
8+
9+
* First, install termux from [termux.com](https://termux.com) or [F-Droid!](https://f-droid.org/en/packages/com.termux/)
10+
* For display, you can use [Xwayland](https://github.com/termux/termux-x11) too.
11+
12+
#### Video tutorial
13+
14+
https://youtu.be/iVF0swfqsKo
15+
16+
#### Getting Sources and install scripts
17+
18+
```bash
19+
# download installer
20+
curl -L -o install.sh https://git.io/hippo-installer
21+
# run the installer
22+
bash install.sh
23+
# Install ubuntu with this command
24+
udroid --install
25+
```
26+
27+
#### Basic Usage
28+
29+
| **Command** | **Usage** |
30+
| -------------------------- | ----------------------------------------------------------------------------------------------------------------------- |
31+
| `udroid` | To login to shell |
32+
| `udroid upgrade` | to upgrade fs or to get new features if available |
33+
| `startvnc` | start vncserver at port `1` (you can change default port by exporting env varaible `DEFAULT_VNC_PORT` to a port number) |
34+
| `udroid stopvnc` | stop vncserver at given or default port `1` |
35+
| `udroid --enable-dbus` | To start udroid with dbus hack enabled |
36+
| `udroid --enable-dbus-vnc` | To start vnc session with dbus hack enabled |
37+
38+
#### Env Variables
39+
40+
* `DEFAULT_VNC_PORT` to set vnc port for scripts
41+
* `HIPPO_BRANCH` to set custom branch for cloning code
42+
43+
#### Audio
44+
45+
Pulseaudio starts everytime you invoke start commands with `udroid`
46+
47+
> You can start audio manually with this command
48+
49+
```bash
50+
pulseaudio --start --load="module-native-protocol-tcp auth-ip-acl=127.0.0.1 auth-anonymous=1" --exit-idle-time=-1
51+
```
52+
53+
#### Default passwds for XFCE4
54+
55+
| | password |
56+
| -------------- | -------- |
57+
| udroid user | `secret` |
58+
| vncserver root | `secret` |
59+
60+
#### Setting up Xwayland manually
61+
62+
First up of all install Termux-x11 from above link, in termux use
63+
64+
```
65+
XDG_RUNTIME_DIR=$PREFIX/bin Xwayland -ac :1 > /dev/null &
66+
```
67+
68+
This time start udroid with
69+
70+
```
71+
proot-distro login udroid --shared-tmp
72+
```
73+
74+
And then start Xfce4 on Xwayland via
75+
76+
```
77+
DISPLAY=:1 xfce4-session
78+
```

0 commit comments

Comments
 (0)