TerminalPhone

Comunicación de voz cifrada push-to-talk a través de servicios ocultos de Tor.

TerminalPhone es un único script Bash autocontenido que proporciona comunicación de voz y texto anónima y cifrada de extremo a extremo entre dos o más partes a través de la red Tor. Funciona como un walkie-talkie: grabas un mensaje de voz y este se comprime, cifra y transmite a la otra parte como una sola unidad. También puedes enviar mensajes de texto cifrados durante una llamada. Sin infraestructura de servidor, sin cuentas, sin números de teléfono. Tu dirección .onion del servicio oculto de Tor es tu identidad.

---

Tabla de Contenidos

• Características
• Instalación
  • Linux
  • macOS
  • Termux (Android)
• Inicio Rápido
• Uso
  • Opciones del Menú
  • Controles Durante la Llamada
  • Modo CLI
• Cómo Funciona
• Modelo de Seguridad
• Configuración
• Solución de Problemas
• Licencia

---

Características

• Modo Walkie-Talkie Push-to-Talk -- Graba un mensaje de voz completo y lo transmite al soltar.
• Chat Cifrado Durante la Llamada -- Envía y recibe mensajes de texto cifrados durante una llamada. Pulsa T para escribir un mensaje.
• Identificador de Llamada -- Ambas partes intercambian automáticamente las direcciones .onion al conectarse. La dirección remota se muestra en la cabecera de la llamada.
• Detección Automática de Colgado -- Cuando una parte cuelga, la otra es notificada inmediatamente y la llamada finaliza automáticamente.
• Cifrado Configurable -- Elige entre 21 cifrados seleccionados clasificados por fortaleza (256 bits → 128 bits). Incluye las familias AES, ChaCha20, Camellia y ARIA. Los cifrados débiles (DES, RC4, modos ECB) están excluidos.
• Negociación de Cifrado en Vivo -- Ambas partes intercambian información del cifrado al conectarse. La cabecera de la llamada muestra tanto el cifrado local como el remoto con indicadores verdes (coinciden) o rojos (no coinciden), actualizados en tiempo real.
• Ajustes Durante la Llamada -- Pulsa S durante una llamada para acceder a los ajustes. Cambia tu cifrado sobre la marcha; la pantalla de la parte remota se actualiza automáticamente.
• Información del Puente Snowflake -- Cuando se usa Snowflake para eludir la censura, la página de llamada muestra el nombre del descriptor del puente, la huella digital y el estado de conexión del transporte extraídos de los registros de Tor.
• Auto-Escucha -- Cuando está habilitada, un escucha en segundo plano se inicia automáticamente cuando Tor arranca. Las llamadas entrantes se detectan y aceptan desde el menú principal sin necesidad de seleccionar manualmente "Escuchar llamadas". Después de que finaliza una llamada, el escucha se reinicia.
• Tecla PTT Configurable -- Cambia la tecla push-to-talk desde la barra espaciadora predeterminada a cualquier tecla mediante el menú de Ajustes.
• Estadísticas de Mensajes -- La pantalla de llamada muestra el tamaño de la carga útil cifrada de los mensajes enviados y recibidos, actualizado en el lugar.
• Estado PTT Remoto -- La pantalla de llamada muestra un indicador estático del estado de la parte remota: "Inactivo" (verde) o "● Grabando" (rojo). Se restablece inmediatamente cuando llegan datos de audio, antes de que comience la reproducción.
• Timbre PTT -- Sonido de notificación opcional cuando la parte remota comienza a grabar. Cinco presets integrados (tono, doble, chirp, ding, clic) generados con sox, además de la capacidad de grabar un timbre personalizado de 2 segundos. Configurable mediante Ajustes.
• Animación de Conexión -- Al llamar a una dirección remota, se reproduce una animación cíclica hasta que se carga la interfaz de llamada.
• Cambiador de Voz -- Aplica efectos de voz al audio saliente. Incluye 6 presets (grave, agudo, robot, eco, susurro) y un modo personalizado totalmente configurable con cambio de tono, overdrive, flanger, eco, filtro highpass y tremolo. Los efectos se procesan usando sox antes de la codificación Opus.
• PTT por Volumen (Termux) -- Modo experimental que te permite tocar dos veces el botón de Bajar Volumen para alternar la grabación, incluso cuando Termux está en segundo plano. Requiere jq (instalado bajo demanda). El volumen se restaura automáticamente después de cada activación.
• Servicio Oculto de Tor -- Cada instancia ejecuta su propio servicio oculto de Tor. Tu dirección .onion sirve como un endpoint permanente y enrutable. No se requiere reenvío de puertos ni IP pública.
• Cifrado de Extremo a Extremo -- Todo el audio y el texto se cifran usando un cifrado configurable (predeterminado: AES-256-CBC) con derivación de clave PBKDF2 a partir de un secreto precompartido antes de entrar en la red Tor.
• Secreto Protegido por Frase de Contraseña -- El secreto compartido puede cifrarse en reposo usando una frase de contraseña elegida por el usuario (AES-256-CBC, 100.000 iteraciones PBKDF2). Los secretos en texto plano existentes se detectan automáticamente con una oferta para migrarlos.
• Bajo Ancho de Banda -- Códec Opus a 16kbps, 8kHz mono. Un mensaje de voz típico de 10 segundos ocupa menos de 20KB, muy dentro de la capacidad de Tor.
• Compartir Código QR -- La opción 3 puede mostrar tu dirección .onion como un código QR escaneable en la terminal. Si qrencode no está instalado, se te solicita instalarlo. El código QR se renderiza en el búfer de pantalla alternativo y se destruye al descartarlo. Una nota advierte que algunos escáneres de QR anteponen automáticamente http://; este prefijo se elimina automáticamente al marcar.
• Archivos Temporales Opacos -- Todos los archivos temporales usan extensiones genéricas .tmp e identificadores hexadecimales aleatorios. No se filtra ningún tipo de archivo ni metadato de temporización al sistema de archivos.
• Visualización de Saltos del Circuito -- Visualización opcional de tu ruta de circuito de Tor durante las llamadas, mostrando nombres de repetidores y nombres completos de países. Se actualiza automáticamente cada 60 segundos. Configurable mediante Ajustes → Ajustes de Tor.
• Excluir Países -- Excluye países específicos de tus circuitos de Tor. Presets para las alianzas Five Eyes, Nine Eyes y Fourteen Eyes, o introduce códigos de país personalizados. Usa ExcludeNodes con StrictNodes en el torrc.
• Autenticación de Protocolo HMAC -- Firma opcional HMAC-SHA256 de todos los mensajes del protocolo (voz, texto, señales de control) usando el secreto compartido. Se incluye un nonce aleatorio por mensaje, y los nonces vistos se rastrean para rechazar repeticiones. Los mensajes no firmados, falsificados o repetidos se descartan silenciosamente. El estado HMAC se congela al inicio de la llamada para evitar desincronización a mitad de llamada. Configurable mediante Ajustes → Seguridad.