From 58a01d7d72a2544fe466129df7dc4fba8e90327a Mon Sep 17 00:00:00 2001 From: Marco Gallegos Date: Sat, 2 Aug 2025 11:30:55 -0600 Subject: [PATCH] Update Readme.MD --- lt_unifying/Readme.MD | 152 +++++++++++++++++++++++++----------------- 1 file changed, 91 insertions(+), 61 deletions(-) diff --git a/lt_unifying/Readme.MD b/lt_unifying/Readme.MD index 06fc43e..02554b6 100644 --- a/lt_unifying/Readme.MD +++ b/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: - -- 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 +Para más detalles, consulta el repositorio oficial: +- https://github.com/Lekensteyn/ltunify#readme [1] --- -## 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 - -1. **Descarga y ejecución** - - * **curl**: - - ```bash - curl -fsSL | bash - ``` - * **wget**: - - ```bash - wget -qO- | bash - ``` - - Reemplaza `` 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 | less - ``` - * Para comprobación sintáctica con `bash -n`: - - ```bash - curl -fsSL | 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 - ``` +* Igual que la opción con `curl`, usando `wget`. --- -## Notas de seguridad +## Pasos internos del script [2] -* **Revisa siempre** el contenido de scripts antes de ejecutarlos en tu sistema. -* Ejecuta como usuario normal; el script solicitará `sudo` cuando sea necesario. -* Mantén actualizado el script clonando periódicamente el repositorio si ya lo descargaste localmente. +1. Instala dependencias: `git`, `build-essential`, `libhidapi-dev`. +2. Clona o actualiza [https://github.com/Lekensteyn/ltunify](https://github.com/Lekensteyn/ltunify). +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 + ``` ```