edengilbertus/terminalphone

TerminalPhone is a single Bash script that lets two or more people have anonymous, encrypted voice conversations over the Tor network, which routes internet traffic through multiple relays to obscure who is talking to whom. It works like a walkie-talkie: you hold a key to record a voice message, release it to send, and the other person receives and plays it back. You can also exchange encrypted text messages during a call by pressing a key to type. Each person who runs the script automatically gets their own Tor hidden service address, which is a .onion address that acts as their identity. You share this address with the people you want to talk to, and they dial it to connect. No server, no account, and no phone number is involved. The voice audio is compressed with the Opus codec at a very low bitrate (about 20 KB for a 10-second message) to keep it practical over Tor's limited speeds. All audio and text is encrypted before being sent, using a shared secret that both parties agree on in advance. The encryption algorithm is configurable from a list of 21 options, defaulting to AES-256. An optional HMAC authentication layer can sign every message so that forged or replayed messages are silently dropped. Temporary files use random names with no identifying extensions, so nothing about the conversation leaks to the local filesystem. Additional features include a voice changer with several presets, the ability to display your address as a QR code in the terminal, a relay mode that lets multiple callers join a group call without the relay operator being able to read the content, and the option to exclude specific countries from your Tor circuit path. The script runs on Linux, macOS, and Android (via the Termux terminal app) and requires no root access. Dependencies install through the script's own menu.