> ## Documentation Index
> Fetch the complete documentation index at: https://dixon-solutions.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Lindroids

> Linux apps on Android, each one an app of its own. No root, nothing to download.

Lindroids is a package for the Linux environments you already use on Android: Termux, proot
distros and Flatpak. It opens their GUI programs as Android windows, and `lindroids export` turns
a program into a real Android app, with its name and icon in the app list and Recents, built on
the phone in milliseconds.

<video autoPlay muted loop playsInline controls src="https://mintcdn.com/dixon-solutions/-qQSu6GkUgpucdwI/media/demos/export-and-run.mp4?fit=max&auto=format&n=-qQSu6GkUgpucdwI&q=85&s=392514d1abe160973dece6ade9cfc66b" />

45 seconds on a Galaxy Tab (Android 16): lindroids run opens GNOME Calculator, lindroids export builds it an app of its own, which starts from its icon.

```sh theme={null}
curl -fsSL https://dixonsolutions.github.io/lindroids/install.sh | sh   # in Termux
lindroids run org.gnome.Calculator         # a window of its own, now
lindroids export org.gnome.Calculator      # an app of its own: tap Install, then its icon
```

## What it is, and is not

* **A package, not an app.** You install Lindroids *inside* your container apps: with `pkg` in
  Termux, or with the package manager of a proot distro. There is nothing to install on Android
  first.
* **Not a container app.** Termux, proot-distro and Flatpak keep running your programs, with their
  files and packages. Lindroids gives those programs windows on Android, and Android's features
  through the desktop portals.
* **It builds apps for your programs.** `lindroids export` fills in a template with a program's
  name and icon and signs it on the phone: no Android SDK, no Java.

## What you get

> [card] [An app per program](https://dixon-solutions.mintlify.site/docs/APPS.md)
>
> About 180 KB, built on the phone. Its icon starts the program, even when Termux is not
> running, and Recents shows its own icon.

> [card] [Any Linux program with a window](https://dixon-solutions.mintlify.site/docs/INSTALL.md)
>
> Termux packages, programs in a proot distro, Flatpaks from Flathub, X11 programs.

> [card] Android underneath
>
> Dark mode and accent colour, Android's file picker, notifications, the clipboard, sound and
> the microphone, touch, pen and keyboards.

> [card] [How it works](https://dixon-solutions.mintlify.site/docs/ARCHITECTURE.md)
>
> A Wayland compositor and PulseAudio server in one Rust binary, drawing each window over an
> authenticated loopback link.

## Next

> [card] [Install](https://dixon-solutions.mintlify.site/docs/INSTALL.md)
>
> Termux, proot distros and desktops.

> [card] [FAQ](https://dixon-solutions.mintlify.site/docs/faq.md)
>
> Root, Android versions, Termux:X11, security, GPU.

> [card] [Contribute](https://dixon-solutions.mintlify.site/docs/DEVELOPMENT.md)
>
> Build it, test a dev build, send a pull request.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.