Say is a terminal‑first voice and video call utility that builds an embedded Yggdrasil node via ygg and speaks directly to other peers over the Ygg overlay network. Audio is captured with malgo (miniaudio), encoded as G.722, and optionally sent via UDP for lower latency. Video frames are sourced through gocam, compressed then rendered in the current terminal session using Unicode glyphs.

The project is intended as a lightweight experiment: share your Yggdrasil address, run say on both ends, and you have voice/video without deploying an external Yggdrasil daemon or web stack.

• Embedded Yggdrasil node – no separate daemon required.
• G.722 voice (8 kHz / 48 kbps) with configurable frame size and UDP/TCP transports.
• Video streaming directly in the terminal two‑pane layout.
• Simple newline text bridge when media is disabled.
• Friend list bootstrap via the same config.json that holds the Yggdrasil settings.

• Go 1.24 (minimum) with cgo enabled.
• A working microphone for voice calls and, if you enable video, a webcam that is supported by your OS (V4L2 on Linux, AVFoundation on macOS, Media Foundation on Windows).
• System libraries required by miniaudio / Gocam (on Linux ensure ALSA/ Pulse dev packages are available; on macOS you just need Xcode command line tools).
• Permission to access camera and microphone for the terminal session.

Go to Releases download adn start it

curl -fsSL https://raw.githubusercontent.com/svanichkin/say/main/scripts/install-release.sh | bash

OR

wget -qO- https://raw.githubusercontent.com/svanichkin/say/main/scripts/install-release.sh | bash

The script detects your platform, downloads the latest release artifact from GitHub, and installs say into a sensible default directory:

• macOS/Linux/BSD: $HOME/.local/bin for non‑root users, /usr/local/bin otherwise.
• Windows (MSYS/mingw/git-bash environments): %USERPROFILE%\AppData\Local\Programs\say.

Override the target via INSTALL_DIR=/custom/path ./scripts/install-release.sh. Supply a specific tag with VERSION=v0.4.0 ./scripts/install-release.sh, or point to a fork using REPO=myuser/say ./scripts/install-release.sh. Ensure curl, tar, and (for Windows archives) unzip are available, and add the chosen install directory to your PATH if needed.

Very simple for linux/macos

CGO_ENABLED=1 go install github.com/svanichkin/say@latest

Then use

~/go/bin/say

Windows with CMD

set CGO_ENABLED=1
go install github.com/svanichkin/say@latest

Windows with Powershell

$env:CGO_ENABLED = "1"
go install github.com/svanichkin/say@latest

Then use

C:\Users\USERNAME\go\bin\say.exe

The package is also available on the AUR, if you use an AUR helper, you can install it for example with:

yay -S say

git clone https://github.com/svanichkin/say.git
cd say
make

You can also run the tool without building a binary linux/macos:

env CGO_ENABLED=1 
go run .

Windows with CMD

set CGO_ENABLED=1
go run .

Windows with Powershell

$env:CGO_ENABLED = "1"
go run .

Say stores its configuration under your OS config directory: on Linux this is typically $XDG_CONFIG_HOME/say/config.json (or ~/.config/say/config.json if XDG_CONFIG_HOME is unset), while on macOS it resolves to ~/Library/Application Support/say/config.json. You can point to a different path with -config /path/to/config.json.

The configuration file is a regular Yggdrasil node config plus an optional contacts_dir key understood by Say:

{
  "peers": [
    "tls://example.yggnode.net:443",
    "quic://203.0.113.10:8443"
  ],
  "contacts_dir": "/Users/me/Contacts"
}

Pass the same config file to Say – the embedded node uses it to bootstrap. When contacts_dir is supplied (or overridden via -contacts), Say recursively scans that directory. Each friend is represented as a folder that contains a say subdirectory with text files holding IPv6 addresses:

~/Contacts/
  Alice G/
      say
  Bob D/
    say/
      phone
      console

• If the say directory holds a single file, its address is added as Alice G.
• If there are multiple files, each becomes a separate contact such as Bob D/phone or Bob D/console, where the suffix comes from the filename.

When selecting a friend inside the CLI, use those exact labels ("Bob D/phone"). If you start say with -contacts /path/to/contacts, that path is persisted into the active config so future runs can omit the flag.

The utility automatically updates the list of peers each time it starts.

Run Say on one machine in listen mode:

./say

The program prints your Yggdrasil address. Share it with a friend and have them dial you:

./say "200:abcd:1234:..."

Optionally pass the port as a separate argument, in any order:

./say "[200:abcd:1234:...]:7777"
./say 7777 "200:abcd:1234:..."
./say "200:abcd:1234:..." 7777

Select alternative configs explicitly via -config work (which maps to $XDG_CONFIG_HOME/say/work.json). Positional arguments are interpreted as either a dial target ("200:abcd:...") or a friend name from contacts ("Alice G", "Bob D/phone"). To run the server with another profile, always pass -config; bare tokens are no longer treated as profile names.

Audio and video are always enabled when hardware is present; no extra flags are required. Relevant CLI switches:

• -port – listening TCP/UDP port (defaults to 7777).
• -fps – cap video capture/rendering to N FPS (5–30, defaults to 25).
• -config – config profile or path; -config work maps to $XDG_CONFIG_HOME/say/work.json.
• -contacts – override the contacts directory defined in the config.
• -v – verbose logging.
• -version – print version and exit.
• -donate – print donation information and exit.
• -support – print support link and exit.
• Color filters: -red, -orange, -yellow, -green, -teal, -blue, -purple, -pink, -gray, -bw – apply a tinted (or neutral) monochrome filter to the local/remote viewports (purely visual, codec stream stays untouched). Use at most one flag; if several are present the last one wins.

When media is disabled on both ends, Say falls back to a simple line‑based text bridge over the established TCP session.

1. Both peers ensure their configs contain working Yggdrasil peers.
2. Alice runs ./say.
3. Bob runs ./say "alice-ygg-addr".
4. Speak! Use Ctrl+C to terminate; the app restores the terminal state.

This project is distributed under the terms of the MIT License.

Monero 41uoDd1PNKm7j4LaBHHZ77ZPbEwEJzaRHhjEqFtKLZeWjd4sNfs3mtpbw1mcQrnNLBKWSJgui9ELEUz217Ui6kF13SmF4t5