Skip to content

InledGroup/DroidTux

Repository files navigation

DroidTux Logo

DroidTux - Android Desktop Integrator 🐧📱

English | Español


Español

DroidTux es una herramienta diseñada para integrar de forma fluida tus aplicaciones de Android directamente en tu escritorio Linux. Utiliza scrcpy para la transmisión de pantalla y un pequeño "Bridge" en el dispositivo para extraer iconos y etiquetas originales, creando archivos .desktop que permiten lanzar aplicaciones de Android como si fueran nativas.

✨ Características

  • Integración Nativa: Lanza aplicaciones de Android desde tu menú de aplicaciones (GNOME, KDE, XFCE, etc.).
  • Extracción de Iconos: Obtiene los iconos y nombres reales de las aplicaciones del dispositivo.
  • Sincronización Automática: Gracias a las reglas udev, DroidTux puede sincronizar tus aplicaciones automáticamente al conectar el móvil por USB.
  • Dashboard GTK: Una interfaz sencilla para gestionar la sincronización y ver los logs.
  • Multidisplay: Utiliza las capacidades de scrcpy para crear displays virtuales con resoluciones personalizadas.

📋 Requisitos

  • Linux: Con Python 3, scrcpy, adb y librerías GTK3.
  • Android: Depuración USB habilitada. Se recomienda habilitar "Instalar vía USB" en opciones de desarrollador para la mejor experiencia.

🚀 Instalación

  1. Clona este repositorio.
  2. Asegúrate de tener el APK del bridge generado (o usa el incluido):
    ./build_bridge.sh
  3. Ejecuta el script de instalación:
    chmod +x install.sh
    ./install.sh

🛠️ Desarrollo

Para compilar el bridge de Android manualmente, necesitas el SDK de Android (aapt2, d8, apksigner, etc.) y ejecutar:

./build_bridge.sh

English

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.

✨ Features

  • 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 udev rules, 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 scrcpy capabilities to create virtual displays with custom resolutions.

📋 Prerequisites

  • 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.

🚀 Installation

  1. Clone this repository.
  2. Ensure the bridge APK is generated (or use the included one):
    ./build_bridge.sh
  3. Run the installation script:
    chmod +x install.sh
    ./install.sh

🛠️ Development

To manually compile the Android bridge, you need the Android SDK (aapt2, d8, apksigner, etc.) and run:

./build_bridge.sh

Developed with ❤️ by JaimeGH. vreadme1.0

About

Integrate your Android phone's apps on Linux.

Resources

Stars

Watchers

Forks

Packages

 
 
 

Contributors