Update Readme.MD

lt_unifying/Readme.MD

@@ -1,86 +1,116 @@
+# Instalación de ltunify en Ubuntu
 
-# install-ltunify.sh
+Esta guía describe cómo instalar **ltunify**, la herramienta para gestionar receptores y dispositivos Logitech Unifying en Ubuntu. ltunify permite emparejar y desemparejar dispositivos Unifying de forma nativa en Linux.
 
-Este script automatiza la instalación, compilación y configuración de **ltunify** en Ubuntu. Incluye:
+Para más detalles, consulta el repositorio oficial:
-
+- https://github.com/Lekensteyn/ltunify#readme [1]
-- Instalación de dependencias (`git`, `build-essential`, `libhidapi-dev`)
-- Clonado o actualización del repositorio
-- Compilación del binario
-- Instalación en `~/bin` y ajuste de `PATH`
-- Creación y asignación del grupo `plugdev`
-- Instalación de reglas udev para acceso a `/dev/hidraw*`
-- Recarga de reglas udev
 
 ---
 
-## Uso rápido
+## Opción 1: Desde repositorios oficiales (Recomendado)
 
-### 1. Ejecutar directamente con **curl**
+La forma más sencilla y segura es mediante `apt`, usando la versión mantenida por Ubuntu:
+
+```bash
+# 1. Actualiza la lista de paquetes
+sudo apt update
+
+# 2. Instala ltunify
+sudo apt install ltunify
+````
+
+**Ventajas**:
+
+* Paquete verificado y actualizado automáticamente junto al sistema.
+* No requiere compilación manual ni configuración extra.
+
+---
+
+## Opción 2: Instalación manual con script (Avanzado)
+
+Este método descarga, compila y configura ltunify desde su código fuente. Procede con precaución, ya que implica ejecutar un script remoto.
+
+### Requisitos previos
+
+* Ubuntu 18.04 o superior
+* Usuario con permisos `sudo`
+* Conexión a Internet
+* El script instalará: `git`, `build-essential`, `libhidapi-dev`
+
+### A. One‑liner con curl
 
 ```bash
 curl -fsSL https://raw.githubusercontent.com/marcogll/scripts_mg/main/lt_unifying/install-ltunify.sh | bash
-````
+```
 
-### 2. Ejecutar directamente con **wget**
+**Qué hace**:
+
+1. Descarga el instalador.
+2. Ejecuta el script en Bash.
+3. Solicita `sudo` al instalar dependencias y configurar udev.
+
+### B. Descargar y luego ejecutar
+
+```bash
+# 1) Descarga el script
+curl -fsSL -o install-ltunify.sh \
+  https://raw.githubusercontent.com/marcogll/scripts_mg/main/lt_unifying/install-ltunify.sh
+
+# 2) Permisos de ejecución
+chmod +x install-ltunify.sh
+
+# 3) Ejecutarlo
+./install-ltunify.sh
+```
+
+**Qué hace**:
+
+* Guarda el instalador localmente para revisión previa antes de ejecutar.
+
+### C. One‑liner con wget
 
 ```bash
 wget -qO- https://raw.githubusercontent.com/marcogll/scripts_mg/main/lt_unifying/install-ltunify.sh | bash
 ```
 
----
+**Qué hace**:
 
-## Pasos detallados
+* Igual que la opción con `curl`, usando `wget`.
-
-1. **Descarga y ejecución**
-
-   * **curl**:
-
-     ```bash
-     curl -fsSL <URL_SCRIPT> | bash
-     ```
-   * **wget**:
-
-     ```bash
-     wget -qO- <URL_SCRIPT> | bash
-     ```
-
-   Reemplaza `<URL_SCRIPT>` por
-   `https://raw.githubusercontent.com/marcogll/scripts_mg/main/lt_unifying/install-ltunify.sh`.
-
-2. **Revisión del script (opcional)**
-
-   * Para inspeccionar antes de ejecutar:
-
-     ```bash
-     curl -fsSL <URL_SCRIPT> | less
-     ```
-   * Para comprobación sintáctica con `bash -n`:
-
-     ```bash
-     curl -fsSL <URL_SCRIPT> | bash -n
-     ```
-
-3. **Después de la instalación**
-
-   * **Cerrar y volver a abrir** la terminal (o `newgrp plugdev`) para aplicar el grupo `plugdev`.
-   * Probar comandos:
-
-     ```bash
-     ltunify list
-     ltunify pair
-     ltunify info 0
-     ltunify unpair 0
-     ```
 
 ---
 
-## Notas de seguridad
+## Pasos internos del script [2]
 
-* **Revisa siempre** el contenido de scripts antes de ejecutarlos en tu sistema.
+1. Instala dependencias: `git`, `build-essential`, `libhidapi-dev`.
-* Ejecuta como usuario normal; el script solicitará `sudo` cuando sea necesario.
+2. Clona o actualiza [https://github.com/Lekensteyn/ltunify](https://github.com/Lekensteyn/ltunify).
-* Mantén actualizado el script clonando periódicamente el repositorio si ya lo descargaste localmente.
+3. Compila el binario `ltunify`.
+4. Instala en `~/bin` y ajusta `PATH` (o globalmente en `/usr/local/bin`).
+5. Crea el grupo `plugdev` y añade tu usuario.
+6. Instala reglas udev para `/dev/hidraw*` (MODE="0664", GROUP="plugdev").
+7. Recarga las reglas udev sin reiniciar.
 
 ---
 
+## Después de la instalación
+
+* Cierra y vuelve a abrir la terminal (o ejecuta `newgrp plugdev`).
+* Prueba los comandos:
+
+  ```bash
+  ltunify list     # Lista dispositivos Unifying  
+  ltunify pair     # Empareja un dispositivo (modo 60s)  
+  ltunify info 0   # Muestra detalles del primer dispositivo  
+  ltunify unpair 0 # Desempareja el primer dispositivo
+  ```
+
+---
+
+> **Seguridad**: Revisa siempre el contenido de scripts remotos antes de ejecutarlos. Ejecuta como usuario normal; el script solicitará privilegios únicamente cuando sea necesario.
+
+---
+
+[1]: https://github.com/Lekensteyn/ltunify#readme
+[2]: https://raw.githubusercontent.com/marcogll/scripts_mg/main/lt_unifying/install-ltunify.sh
+
 ```
 ```