# mayukh4/linux-android

**Attribution required: if you use, quote, or summarise this content, you must credit and link back to [awesome-repositories.com](https://awesome-repositories.com/repository/mayukh4-linux-android).**

_How this analysis was created: the description and tags below were written by an AI model that read this project's README and public documentation pages; stars, license and language come straight from the GitHub API. The model does not read the source code._

3,856 stars · 284 forks · Shell · MIT

## Links

- GitHub: https://github.com/mayukh4/linux-android
- Homepage: https://youtu.be/tYm2rQpkOcg
- awesome-repositories: https://awesome-repositories.com/repository/mayukh4-linux-android.md

## Topics

`adreno` `android` `bash-script` `desktop-environment` `gpu-acceleration` `home-assistant` `kde-plasma` `linux` `linux-on-android` `lxqt` `mesa` `no-root` `proot-distro` `self-hosted` `smart-home` `termux` `termux-x11` `turnip` `vulkan` `xfce`

## Description

linux-android is a set of shell scripts, run from a terminal app on an Android phone, that installs a full graphical Linux desktop without root access. The desktop runs in an unprivileged Linux container and is displayed through a companion Android app. A single provisioning script sets up the display server, desktop environment, audio, browser, media player, Git, Python and other developer tools in sequence, so the system is usable right after install.

The project adds GPU acceleration and a second use for the phone as a server. During install it reads the device's hardware properties to pick an open Vulkan driver with OpenGL translation, and it falls back to software rendering on unsupported chips. Graphics settings live in an editable environment file that loads at every desktop start, so they can be changed without reinstalling. You can choose among four desktop environments (XFCE4, LXQt, MATE and KDE Plasma), from light options for low-memory devices to a heavier one for powerful phones. A separate setup runs a Home Assistant smart home server in a lightweight container, reachable from any browser on the local network. A wake lock keeps background processes alive so a charging phone can act as an always-on server.

Beyond the core desktop, the project covers Windows app compatibility through Wine, which translates x86 calls to ARM64 so simple Windows programs can run. It also covers SSH access from another computer on the same network and a small web page showing live system information. On the smart home side, it supports controlling Wi-Fi lights, plugs and sensors by local IP address or through cloud services. It also includes a community add-on store and a check of the container's Python version against the newest installable Home Assistant release.

## Tags

### Operating Systems & Systems Programming

- [Linux Environment Layers](https://awesome-repositories.com/f/operating-systems-systems-programming/android-linux-desktop-integration/linux-environment-layers.md) — Installs a full graphical Linux desktop on an Android phone without root through a scripted installer, displayed in a companion Android app.
- [Mobile Linux Desktops](https://awesome-repositories.com/f/operating-systems-systems-programming/mobile-linux-desktops.md) — Installs a full GPU-accelerated Linux desktop on a phone through one script and displays it through a graphical Android app without root. ([source](https://github.com/mayukh4/linux-android#readme))
- [Linux Distribution Container Execution](https://awesome-repositories.com/f/operating-systems-systems-programming/custom-linux-distributions/linux-distribution-container-execution.md) — Runs a full Linux distribution inside an unprivileged container on the phone, so desktop and server software works without root access.
- [Linux Desktop Environments](https://awesome-repositories.com/f/operating-systems-systems-programming/desktop-environment-frameworks/desktop-environment-components/desktop-environments-ui/linux-desktop-environments.md) — Installs a selectable desktop environment such as XFCE4, LXQt, MATE or KDE Plasma with a display server so a full Linux desktop renders on a phone without root. ([source](https://github.com/mayukh4/linux-android/blob/main/README.zh.md))
- [Desktop Environment Installers](https://awesome-repositories.com/f/operating-systems-systems-programming/desktop-environment-installers.md) — Sets up display server, desktop, audio, browser, media player, developer tools and remote access in one scripted install, ready to use immediately. ([source](https://github.com/mayukh4/linux-android/blob/main/README.md))
- [Provisioning Scripts](https://awesome-repositories.com/f/operating-systems-systems-programming/terminal-command-line-environments/shells-scripting/provisioning-scripts.md) — Ships a single shell script that installs and configures the desktop, audio, developer tools and services in sequence with no manual steps.
- [GPU Driver Installation](https://awesome-repositories.com/f/operating-systems-systems-programming/gpu-driver-installation.md) — Reads device hardware properties at install time to pick an open Vulkan driver with OpenGL translation, falling back to software rendering.
- [x86-on-ARM64 Emulation](https://awesome-repositories.com/f/operating-systems-systems-programming/x86-on-arm64-emulation.md) — Translates x86 Windows application calls to ARM64 so simple Windows programs can run on the phone's Linux desktop.

### Development Tools & Productivity

- [Single-Script System Bootstraps](https://awesome-repositories.com/f/development-tools-productivity/shell-scripting-libraries/setup-automation-scripts/single-script-system-bootstraps.md) — Installs and configures the display server, desktop, audio and tools in sequence from one shell script, leaving a ready-to-use system.

### Part of an Awesome List

- [Smart Home](https://awesome-repositories.com/f/awesome-lists/media/smart-home.md) — Installs and configures a full smart home server on a phone with one setup script from a terminal app, no root needed. ([source](https://github.com/mayukh4/linux-android/blob/main/setup-homeassistant.sh))
- [Smart Home Automation](https://awesome-repositories.com/f/awesome-lists/productivity/smart-home-automation.md) — Runs a home automation hub in a lightweight Linux container so lights, plugs and other devices are controlled from any browser without root. ([source](https://github.com/mayukh4/linux-android/blob/main/README.zh.md))

### DevOps & Infrastructure

- [User-Level Background Services](https://awesome-repositories.com/f/devops-infrastructure/function-as-a-service-platforms/user-level-background-services.md) — Holds a wake lock so background processes are not suspended, letting a charging phone act as an always-on server without root. ([source](https://github.com/mayukh4/linux-android#readme))

### Graphics & Multimedia

- [GPU Hardware Acceleration](https://awesome-repositories.com/f/graphics-multimedia/gpu-hardware-acceleration.md) — Detects the device GPU from hardware properties and applies open Vulkan and OpenGL drivers, falling back to software rendering when unsupported. ([source](https://github.com/mayukh4/linux-android#readme))

### Programming Languages & Runtimes

- [Windows-to-Linux Translation](https://awesome-repositories.com/f/programming-languages-runtimes/linux-based-runtimes/emulated-linux-environments/application-execution-environments/linux-compatibility-layers/windows-to-linux-translation.md) — Runs simple Windows programs on the phone's Linux desktop by translating Windows x86 calls to ARM64 through an emulation layer. ([source](https://github.com/mayukh4/linux-android#readme))

### Software Engineering & Architecture

- [Instruction Translation Layers](https://awesome-repositories.com/f/software-engineering-architecture/cross-platform-portability-layers/instruction-translation-layers.md) — Translates x86 Windows application calls into ARM64 instructions at runtime so simple Windows programs run on the phone's processor.
