shmup/terminalphone
1
0
Fork 0
Code Issues Pull requests Projects Releases Packages Wiki Activity Actions

Replace README.md

Browse source
This commit is contained in:
Here ForAwhile 2026-02-16 18:24:20 +00:00
parent 4f0970cec0
commit 3cce5a9d7d
1 changed files with 17 additions and 32 deletions
Show stats Download patch file Download diff file Expand all files Collapse all files

49
README.md
View file

@ -48,7 +48,7 @@ TerminalPhone is a single, self-contained Bash script that provides anonymous, e
``` bash ``` bash
git clone <repository-url> git clone <https://github.com/terminalphone/terminalphone.git>
cd terminalphone cd terminalphone
bash terminalphone.sh bash terminalphone.sh
@ -92,7 +92,7 @@ This installs the command-line utilities that communicate with the Termux:API ap
**Step 4: Run TerminalPhone** **Step 4: Run TerminalPhone**
```bash ```bash
git clone <https://gitlab.com/here_forawhile/terminalphone.git> git clone <repository-url>
cd terminalphone cd terminalphone
bash terminalphone.sh bash terminalphone.sh
``` ```
@ -181,36 +181,21 @@ bash terminalphone.sh call ADDRESS # Call a .onion address
TerminalPhone uses a record-then-send model. When you activate PTT, the microphone records continuously until you release. The complete recording is then processed through the following pipeline: TerminalPhone uses a record-then-send model. When you activate PTT, the microphone records continuously until you release. The complete recording is then processed through the following pipeline:
``` ```
Sender Receiver SENDER RECEIVER
------ -------- ────── ────────
Microphone Microphone Speaker
| │ ▲
v ▼ │
Raw PCM (8kHz, 16-bit, mono) Raw PCM (8kHz, 16-bit, mono) Opus decode
| │ ▲
v ▼ │
Opus encode (16kbps, 60ms frames) Opus encode (16kbps) AES-256-CBC decrypt
| │ ▲
v ▼ │
AES-256-CBC encrypt (PBKDF2, shared secret) AES-256-CBC encrypt Base64 decode
| │ ▲
v ▼ │
Base64 encode Base64 encode ──▶ socat ──▶ Tor ──▶ socat ──▶ Receive
|
v
socat --> Tor circuit --> .onion --> socat
|
v
Base64 decode
|
v
AES-256-CBC decrypt
|
v
Opus decode
|
v
Speaker / Media Player
``` ```
The wire protocol is line-based text over a TCP connection: The wire protocol is line-based text over a TCP connection: