Files
scripts_mg/lt_unifying/Readme.MD
Marco Gallegos 58a01d7d72 Update Readme.MD
2025-08-02 11:30:55 -06:00

117 lines
3.2 KiB
Markdown
Raw Blame History

This file contains invisible Unicode characters
This file contains invisible Unicode characters that are indistinguishable to humans but may be processed differently by a computer. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
# Instalación de ltunify en Ubuntu
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.
Para más detalles, consulta el repositorio oficial:
- https://github.com/Lekensteyn/ltunify#readme [1]
---
## Opción 1: Desde repositorios oficiales (Recomendado)
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
curl -fsSL https://raw.githubusercontent.com/marcogll/scripts_mg/main/lt_unifying/install-ltunify.sh | bash
```
**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
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 internos del script [2]
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
```
```