XWaydroid, the Waydroid launcher tool to improve the user experience of KDE / X-Server users!
- Directly launch the full
waydroid
UI in awayland
session window - Directly launch
waydroid
apps in awayland
session window - Easily patch all your
waydroid.*.desktop
files,
to directly launch in awayland
session window throughxwaydroid
!
XWaydroid requires the following dependencies to work properly,
installation of these is out of the scope of this guide.
- Waydroid (Guide assumes
waydroid-container.service
has been enabled) - KWin_Wayland
- ADB
- Download the latest XWaydroid release
- Unzip it somewhere (e.g.
/home/<username>/Documents/XWaydroid/>
) - Create a symbolic link to
/usr/bin/xwaydroid
:
# Alter <username>!
sudo ln -s /home/<username>/Documents/XWaydroid/xwaydroid.sh /usr/bin/xwaydroid
- Download the latest XWaydroid release.
- Unzip it to the previous installation location (default.
/home/<username>/Documents/XWaydroid/>
)
Usage:
xwaydroid [options]
Example:
xwaydroid --app=com.android.calculator2
Optional-Arguments:
| Shorthand | Full notation | Description |
| --------------------- | ------------------------------------- | ----------------------------------------------------------------- |
| -h | --help | Show this help. |
| -v | --version | Show the currently installed XWaydroid version number |
| -a=<app-name> | --app=<app-name> | Name of the Waydroid app to open, defaults to: '' (show-full-ui) |
| -l | --list | Lists all names of installed app. (Waydroid must be running) |
| -pdf | --patch-desktop-files | Patches all the |
| | | "/home/<username>/.local/share/applications/waydroid.*.desktop" |
| | | files, to automatically launch through XWaydroid. |
| -wb=<binary-path> | --waydroid-bin=<binary-path> | Path to the Waydroid binary, defaults to: 'waydroid' |
| -wwb=<binary-path> | --wayland-window-bin=<binary-path> | Path to the Wayland window, defaults to: 'kwin_wayland' |
| | | Others not yet supported. |
| -www=<width> | --wayland-window-width=<width> | Pixel width of the Wayland window, defaults to: 3440 |
| -wwh=<height> | --wayland-window-height=<height> | Pixel height of the Wayland window, defaults to: 1340 |
- Please be patient when starting the first
waydroid
app throughxwaydroid
.
A blackkwin_wayland
window for a few minutes, before you see the LineageOS loading logo, is normal. - If switching between
waydroid
apps throughxwaydroid
, it's recommended to leave thekwin_wayland
window open.
Closing / re-opening thekwin_wayland
window leads to a "reboot" of thewaydroid
session which takes a while.
Leaving thekwin_wayland
window, leads to instant startup of newwaydroid
apps. - Opening / using multiple
waydroid
apps throughxwaydroid
is supported, albeit through a singlekwin_wayland
window. - The default values of some optional-options,
can be configured in theDefault Settings
section at the start of thexwaydroid
script.