termsg 💬

Envía mensajes a otros ordenadores directamente desde la terminal. Sin cuentas, sin servidores externos, sin complicaciones.

---

Requisitos

Para poder utilizar esta herramienta necesitas tener:

• Python 3.7 o superior

Es necesario tener instalado python 3.7 o superior, se recomienda tenerlo actualizado a la fecha.

• Windows: descárgalo desde python.org — marca ✅ "Add Python to PATH" durante la instalación
• Linux: sudo apt install python3 (Ubuntu/Debian) o sudo dnf install python3 (Fedora) o sudo pacman -S python (Arch)
• Mac: brew install python o descárgalo desde python.org

---

Instalación

Windows

1. Descarga y descomprime este proyecto
2. Entra en la carpeta termsg
3. Haz doble clic en install_Windows.bat
4. Cuando termine, cierra la terminal y abre una nueva
5. Ya puedes usar termsg desde cualquier sitio

Linux / Mac

cd termsg
chmod +x install_Linux_o_Mac.sh
./install_Linux_o_Mac.sh

Si termsg no responde tras instalar, cierra la terminal y abre una nueva.

---

Uso

Paso 1 — El que recibe la conexión (ejecuta primero)

termsg listen

Verás:

[termsg] Escuchando en el puerto 5000... esperando conexión.
[termsg] Pulsa Ctrl+C para salir.

Deja esta terminal abierta y comparte tu IP con quien quiera conectarse.

¿Cómo sé mi IP?

• Windows: abre una terminal y escribe ipconfig → busca "Dirección IPv4"
• Linux/Mac: escribe ip a o ifconfig → busca una línea como inet 192.168.1.X

Paso 2 — El que inicia la conexión

termsg connect 192.168.1.X

Sustituye 192.168.1.X por la IP del otro ordenador.

Paso 3 — Ya puedes hablar

Una vez conectados, simplemente escribe y pulsa Enter. El otro verá tu mensaje al instante.

[termsg] ¡Conectado! Escribe tus mensajes. Escribe 'exit' para salir.

> hola, ¿ves mi mensaje?
[192.168.1.50]: sí, perfectamente!
> genial

Escribe exit para cerrar la sesión.

---

Opciones avanzadas

Usar un puerto distinto al 5000 (si está ocupado):

# El receptor:
termsg listen --port 6000

# El emisor:
termsg connect 192.168.1.X --port 6000

---

Uso por internet (fuera de tu red local)

He de decir que esta parte no la he probado mucho, pero he visto que tambien se podria utilizar a traves de internet haciendo un puente entre las dos maquinas

Para conectar entre ordenadores en redes distintas (por ejemplo, desde casa a la oficina), el receptor necesita exponer su puerto. La forma más sencilla es con ngrok:

1. Descarga ngrok desde ngrok.com (gratis)
2. En el ordenador receptor, abre dos terminales:
   • Terminal 1: termsg listen
   • Terminal 2: ngrok tcp 5000
3. Ngrok te mostrará algo como: tcp://0.tcp.ngrok.io:12345
4. El emisor se conecta así:

   termsg connect 0.tcp.ngrok.io --port 12345

Esta opcion la verdad es que no la he probado mucho, si alguien tiene sugerencias puede decirmelas

---

Desinstalar

Para desinstalarlo lo que debéis hacer es ejecutar el siguiente comando:

pip uninstall termsg

---

Licencia

MIT — úsalo, modifícalo, compártelo libremente.