Skip to content

XWaydroid, the Waydroid launcher tool to improve the user experience of KDE / X-Server users!

License

Notifications You must be signed in to change notification settings

Rikj000/XWaydroid

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

6 Commits
 
 
 
 
 
 
 
 
 
 

Repository files navigation

XWaydroid

Total Releases Downloaded from GitHub Latest Official Release on GitHub GNU General Public License The current place where you can find all XWaydroid Documentation! ICONOMI - The world’s largest crypto strategy provider Buy me a Coffee as a way to sponsor this project!

XWaydroid, the Waydroid launcher tool to improve the user experience of KDE / X-Server users!

Note-able Features

  • Directly launch the full waydroid UI in a wayland session window
  • Directly launch waydroid apps in a wayland session window
  • Easily patch all your waydroid.*.desktop files,
    to directly launch in a wayland session window through xwaydroid!

Dependencies

XWaydroid requires the following dependencies to work properly,
installation of these is out of the scope of this guide.

Installation

  1. Download the latest XWaydroid release
  2. Unzip it somewhere (e.g. /home/<username>/Documents/XWaydroid/>)
  3. Create a symbolic link to /usr/bin/xwaydroid:
# Alter <username>!
sudo ln -s /home/<username>/Documents/XWaydroid/xwaydroid.sh /usr/bin/xwaydroid

Updates

  1. Download the latest XWaydroid release.
  2. Unzip it to the previous installation location (default. /home/<username>/Documents/XWaydroid/>)

Usage

    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             |

Notes

  • Please be patient when starting the first waydroid app through xwaydroid.
    A black kwin_wayland window for a few minutes, before you see the LineageOS loading logo, is normal.
  • If switching between waydroid apps through xwaydroid, it's recommended to leave the kwin_wayland window open.
    Closing / re-opening the kwin_wayland window leads to a "reboot" of the waydroid session which takes a while.
    Leaving the kwin_wayland window, leads to instant startup of new waydroid apps.
  • Opening / using multiple waydroid apps through xwaydroid is supported, albeit through a single kwin_wayland window.
  • The default values of some optional-options,
    can be configured in the Default Settings section at the start of the xwaydroid script.

About

XWaydroid, the Waydroid launcher tool to improve the user experience of KDE / X-Server users!

Topics

Resources

License

Stars

Watchers

Forks

Packages

No packages published

Languages