scripts_mg/lt_unifying/Readme.MD

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:

# 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

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

# 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

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

  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.

---