README.md

   1 # Waydroid
   2
   3 Waydroid is a container-based approach to boot a full Android system on a
   4 regular GNU/Linux system like Ubuntu.
   5
   6 ## Overview
   7
   8 Waydroid uses Linux namespaces (user, pid, uts, net, mount, ipc) to run a
   9 full Android system in a container and provide Android applications on
  10 any GNU/Linux-based platform.
  11
  12 The Android inside the container has direct access to needed hardwares.
  13
  14 The Android runtime environment ships with a minimal customized Android system
  15 image based on the [LineageOS](https://lineageos.org/).
  16 The used image is currently based on Android 10
  17
  18 ## Install and Run Android Applications
  19
  20 You can install Android applications from the command line.
  21
  22 ```sh
  23 waydroid app install xyz.apk
  24 ```
  25
  26 The apk files you will sometimes find on the internet tend to only have arm
  27 support, and will therefore not work on x86\_64.
  28
  29 You may want to install [F-Droid](https://f-droid.org/) to get applications
  30 graphically. Note that the Google Play Store will not work as is, because it
  31 relies on the proprietary Google Play Services, which are not installed.
  32
  33 ## Reporting bugs
  34
  35 If you have found an issue with Waydroid, please [file a bug](https://github.com/Waydroid/waydroid/issues/new).
  36
  37 ## Get in Touch
  38
  39 If you want to get in contact with the developers please feel free to join the
  40 *WayDroid* groups in [Matrix](https://matrix.to/#/#waydroid:connolly.tech) or [Telegram](https://t.me/WayDroid).