|
| 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