Skip to content

README.es.md

Latest commit

 

History

History
89 lines (71 loc) · 2.74 KB

README.es.md

File metadata and controls

89 lines (71 loc) · 2.74 KB
Raw

GNOME Hotspot Toggle

GNOME Shell License: GPL-2.0

English | Deutsch | Español

Una pequeña extensión de GNOME Shell y un script compañero para alternar un hotspot Wi-Fi de NetworkManager y configurar reglas básicas de NAT/iptables.

Capturas de pantalla

Hotspot activado Hotspot desactivado

Características

  • Toggle de Ajustes Rápidos para GNOME Shell 46/47/48.
  • Script CLI para uso manual o automatización.
  • Lanzador opcional de entrada de escritorio.
  • Configura NAT/forwarding para el tráfico del hotspot.

Estructura del repositorio

  • hotspot-toggle: script principal en Bash.
  • hotspot@yurij.de/: fuentes de la extensión y script integrado.
  • hotspot-toggle.desktop: entrada de escritorio.
  • install.sh: instalador y configuración de sudoers.

Requisitos

  • NetworkManager con nmcli
  • iptables, sysctl, notify-send
  • gnome-extensions (para habilitar la extensión)
  • acceso sudo (para instalar la entrada sudoers)

Instalación

Ejecuta el instalador e introduce tu contraseña sudo cuando se solicite:

./install.sh

Esto instala:

  • ~/.local/bin/hotspot-toggle
  • ~/.local/share/applications/hotspot-toggle.desktop
  • ~/.local/share/gnome-shell/extensions/hotspot@yurij.de/
  • /etc/sudoers.d/hotspot-toggle

Asegúrate de que ~/.local/bin esté en tu PATH, o invoca el script con la ruta completa. Si usas la entrada de escritorio, actualiza el caché:

update-desktop-database ~/.local/share/applications

Uso

Alterna desde la línea de comandos:

hotspot-toggle

Fijar una interfaz Wi-Fi específica:

HOTSPOT_WIFI_IF=wlp2s0 hotspot-toggle

El script espera el nombre de conexión Hotspot (el valor por defecto creado por nmcli dev wifi hotspot). Si tu conexión usa otro nombre, actualiza HOTSPOT_NAME en hotspot-toggle.

Extensión de GNOME Shell

Habilítala:

gnome-extensions enable hotspot@yurij.de

Recarga GNOME Shell si es necesario (Xorg: Alt+F2 luego r; Wayland: cerrar sesión e iniciar sesión de nuevo).

Desinstalación

rm -f ~/.local/bin/hotspot-toggle
rm -f ~/.local/share/applications/hotspot-toggle.desktop
rm -rf ~/.local/share/gnome-shell/extensions/hotspot@yurij.de
sudo rm -f /etc/sudoers.d/hotspot-toggle

Notas de seguridad

El instalador agrega una entrada sudoers NOPASSWD para comandos específicos de iptables y sysctl. Revisa /etc/sudoers.d/hotspot-toggle antes de usar en entornos sensibles.

Licencia

GPL-2.0. Ver LICENSE.