Walkie-Talkie

Serverless peer-to-peer walkie-talkie application for LAN.

Automatic peer discovery, encrypted text chat, push-to-talk voice communication.

Installation

pip install walkie

Or for development:

git clone https://github.com/Lunixizm0/walkie.git
cd walkie
uv sync

Usage

# Generate config (creates random passwords, salt, and encryption key)
walkie gen

# Receive config from another client
walkie get

# Send config to another client
walkie give <target_ip>

# Start the application
walkie run

Or run directly:

python -m walkie run
python -m walkie gen
python -m walkie get
python -m walkie give 192.168.1.100

Configuration

The app looks for walkie_config.toml in ~/.config/walkie/. You can override the path with the WALKIE_CONFIG environment variable.

Features

• Automatic peer discovery via UDP broadcast (no server needed)
• AES-256-GCM encryption for voice and chat
• Low-latency voice with Opus codec
• Push-to-Talk (Shift+V) and Voice Activity Detection (VAD) modes
• Seamless playback with jitter buffer
• System tray minimization
• TOML-based configuration
• Config sharing over TCP (--get/--give)

Requirements

• Python 3.11+
• Linux, Windows, or macOS
• Microphone and speakers

System Dependencies

Walkie requires system libraries for audio and GUI tray support. Install them before installing the Python package:

Debian / Ubuntu:

sudo apt install -y portaudio19-dev gobject-introspection \
  libgirepository1.0-dev libglib2.0-dev pkg-config python3-dev python3-tk

Arch Linux:

sudo pacman -S --needed portaudio gobject-introspection pkgconf python3 tk

macOS (Homebrew):

brew install portaudio gobject-introspection pkg-config tcl-tk

Windows:

No extra system dependencies needed. Wheels for sounddevice and pygobject bundle everything required.

License

MIT