Skip to content

devmaiter/NetQuick

Repository files navigation

Windows Python Version Estado License



⚡ NetQuick

Cambia rápido, sin estresarte.

NetQuick es un widget flotante para Windows que vive en la bandeja del sistema y te deja cambiar la IP/red de tu máquina en segundos — sin abrir menús de Windows, sin memorizar comandos.

⚠️ Versión beta / demo en desarrollo activo. Funciona y se usa a diario, pero puede cambiar sin aviso y contener errores.


🚀 Cómo ejecutar NetQuick

La app es una sola: el widget flotante con icono en la bandeja del sistema.

Situación Comando
Instalar el .exe (recomendado) irm https://raw.githubusercontent.com/devmaiter/NetQuick/main/install.ps1 | iex
Instalar desde fuente (sin .exe) irm https://raw.githubusercontent.com/devmaiter/NetQuick/main/install-src.ps1 | iex
Repo ya clonado (desarrollo) .\setup.ps1 y luego doble clic en NetQuick.vbs
Directo con Python pythonw netquick.py
Desinstalar irm https://raw.githubusercontent.com/devmaiter/NetQuick/main/uninstall.ps1 | iex

Tras instalar, abre una terminal nueva y escribe netquick, o usa el acceso directo del Escritorio.

🛡️ NetQuick necesita permisos de Administrador para cambiar la configuración de red; los pide solo cuando hace falta.


🗂️ Estructura del repo

Archivo Qué es
netquick.py La aplicación — widget flotante + icono de bandeja
netops.py Operaciones de red (netsh, psutil, escáner, mDNS Dante)
NetQuick.vbs Lanzador sin ventana de consola (doble clic)
NetQuick.spec Empaquetado del .exe con PyInstaller
install.ps1 / install-src.ps1 Instaladores por terminal (irm ... | iex)
uninstall.ps1 Desinstalador (revierte archivos, PATH, accesos e inicio con Windows)
setup.ps1 Setup de desarrollo (instala dependencias)
tests/ Tests de netops (pytest, corren en CI)
CHANGELOG.md Historial de cambios

🚀 Características

Función Descripción
📌 Widget flotante Barrita compacta, siempre encima, anclada abajo a la derecha
🔔 Icono en bandeja La ✕ oculta el widget; clic en el icono lo muestra; "Salir" en clic derecho
🏷️ Perfiles guardados Guarda combinaciones IP/máscara/gateway (Casa, U, Trabajo) y aplícalas de 1 clic
🔄 DHCP / IP fija Cambia de modo con un clic; el color indica el modo activo
🔍 Escáner de red Compatible con redes Dante (máscara real y link-local /16), descubrimiento mDNS nativo
⚙️ Iniciar con Windows Opción en la rueda ⚙ del widget
🛡️ Permisos de Admin Solicitud automática cuando hace falta

📦 Generar el .exe

pip install pyinstaller
pyinstaller NetQuick.spec
# resultado: dist\NetQuick.exe

Nota: Windows (Defender / Smart App Control) puede bloquear el .exe por no estar firmado. Ejecutar desde fuente (pythonw netquick.py) no tiene ese problema.

Los .exe oficiales se compilan automáticamente en GitHub Actions al crear un tag v*, y cada release publica el hash SHA256 del ejecutable para que puedas verificar tu descarga: Get-FileHash NetQuick.exe -Algorithm SHA256.


👥 Autores

Israel Moncayo Oscar Osorio

📄 Licencia

Este proyecto está bajo la Licencia MIT. Consulta el archivo LICENSE para más detalles.


Hecho con ❤️ en Colombia 🇨🇴

¿Te fue útil? ¡Dale una ⭐ al repo!

About

⚡ Configurador de red para Windows — Cambia entre DHCP e IP estática en segundos, sin tocar la consola.

Topics

Resources

License

Stars

0 stars

Watchers

0 watching

Forks

Packages

 
 
 

Contributors