Code Monkey home page Code Monkey logo

xwaydroid's Introduction

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.

xwaydroid's People

Contributors

rikj000 avatar

Stargazers

Doãn Hiện avatar 企鹅2035 avatar x13igpoppa avatar Ardeshir avatar  avatar Martin Bučko avatar  avatar

Watchers

 avatar  avatar

Forkers

guy-amun-ra

xwaydroid's Issues

Why not create our OWN HOSTED WEBSITE WITH REPOS AND APPS?

Yeah, for FOSS privacy lovers like me and you, androidacy is crap, so why not create a free no-cost website and repos (i have a completely free hosting service btw), that would help the FOSS users of Android to not struggle to that big giant repo eater..

Recommend Projects

  • React photo React

    A declarative, efficient, and flexible JavaScript library for building user interfaces.

  • Vue.js photo Vue.js

    🖖 Vue.js is a progressive, incrementally-adoptable JavaScript framework for building UI on the web.

  • Typescript photo Typescript

    TypeScript is a superset of JavaScript that compiles to clean JavaScript output.

  • TensorFlow photo TensorFlow

    An Open Source Machine Learning Framework for Everyone

  • Django photo Django

    The Web framework for perfectionists with deadlines.

  • D3 photo D3

    Bring data to life with SVG, Canvas and HTML. 📊📈🎉

Recommend Topics

  • javascript

    JavaScript (JS) is a lightweight interpreted programming language with first-class functions.

  • web

    Some thing interesting about web. New door for the world.

  • server

    A server is a program made to process requests and deliver data to clients.

  • Machine learning

    Machine learning is a way of modeling and interpreting data that allows a piece of software to respond intelligently.

  • Game

    Some thing interesting about game, make everyone happy.

Recommend Org

  • Facebook photo Facebook

    We are working to build community through open source technology. NB: members must have two-factor auth.

  • Microsoft photo Microsoft

    Open source projects and samples from Microsoft.

  • Google photo Google

    Google ❤️ Open Source for everyone.

  • D3 photo D3

    Data-Driven Documents codes.