DroidTux is a tool designed to seamlessly integrate your Android applications directly into your Linux desktop. It leverages scrcpy for screen mirroring and a small "Bridge" app on the device to extract original icons and labels, creating .desktop files that allow you to launch Android apps as if they were native.
- Native Integration: Launch Android apps from your application menu (GNOME, KDE, XFCE, etc.).
- Icon Extraction: Fetches real icons and names from the device.
- Automatic Sync: Thanks to
udevrules, DroidTux can automatically sync your apps when connecting your phone via USB. - GTK Dashboard: A simple interface to manage synchronization and view logs.
- Multidisplay: Uses
scrcpycapabilities to create virtual displays with custom resolutions.
- Linux: Python 3,
scrcpy,adb, and GTK3 libraries. - Android: USB Debugging enabled. Enabling "Install via USB" in developer options is highly recommended for the best experience.
- Clone this repository.
- Ensure the bridge APK is generated (or use the included one):
./build_bridge.sh
- Run the installation script:
chmod +x install.sh ./install.sh
You can generate native packages for your distribution using the package.sh script. This script requires fpm:
./package.sh [version]This will generate .deb, .rpm, and .pkg.tar.zst files in the root directory.
You can also find the native definition files in the packaging/ folder:
- Arch Linux:
packaging/arch/PKGBUILD - Fedora:
packaging/fedora/droidtux.spec
To uninstall the package version:
- Debian:
./uninstall_deb.sh - Fedora:
./uninstall_rpm.sh - Arch Linux:
./uninstall_pacman.sh
To manually compile the Android bridge, you need the Android SDK (aapt2, d8, apksigner, etc.) and run:
./build_bridge.shDeveloped by JaimeGH. vreadme1.2.1
Note
This project was developed with the assistance of Artificial Intelligence (AI) for coding, and all the code and its operations have been thoroughly reviewed and tested.