mirror of
https://github.com/marcogll/scripts_mg.git
synced 2026-01-13 05:15:15 +00:00
Update Readme.MD
This commit is contained in:
Marco Gallegos
@@ -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 <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
|
||||
```
|
||||
* 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
|
||||
|
||||
```
|
||||
```
|
||||
|
||||
Reference in New Issue
Block a user