Update Readme.MD

This commit is contained in:
Marco Gallegos
2025-08-02 11:30:55 -06:00
committed by GitHub
parent 569699f05f
commit 58a01d7d72

View File

@@ -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. Oneliner con curl
```bash ```bash
curl -fsSL https://raw.githubusercontent.com/marcogll/scripts_mg/main/lt_unifying/install-ltunify.sh | 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. Oneliner con wget
```bash ```bash
wget -qO- https://raw.githubusercontent.com/marcogll/scripts_mg/main/lt_unifying/install-ltunify.sh | bash wget -qO- https://raw.githubusercontent.com/marcogll/scripts_mg/main/lt_unifying/install-ltunify.sh | bash
``` ```
**Qué hace**:
* Igual que la opción con `curl`, usando `wget`.
--- ---
## Pasos detallados ## Pasos internos del script [2]
1. **Descarga y ejecución** 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.
* **curl**: ---
## Después de la instalación
* Cierra y vuelve a abrir la terminal (o ejecuta `newgrp plugdev`).
* Prueba los comandos:
```bash ```bash
curl -fsSL <URL_SCRIPT> | bash ltunify list # Lista dispositivos Unifying
``` ltunify pair # Empareja un dispositivo (modo 60s)
* **wget**: ltunify info 0 # Muestra detalles del primer dispositivo
ltunify unpair 0 # Desempareja el primer dispositivo
```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 > **Seguridad**: Revisa siempre el contenido de scripts remotos antes de ejecutarlos. Ejecuta como usuario normal; el script solicitará privilegios únicamente cuando sea necesario.
* **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]: https://github.com/Lekensteyn/ltunify#readme
[2]: https://raw.githubusercontent.com/marcogll/scripts_mg/main/lt_unifying/install-ltunify.sh
``` ```
``` ```